tencent cloud

文档反馈

DescribeMediaJob

最后更新时间:2022-08-19 10:15:27

    功能描述

    DescribeMediaJob 接口用于查询指定的任务。

    推荐使用 API Explorer
    点击调试
    API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

    请求

    请求示例

    GET /jobs/<jobId> HTTP/1.1
    Host: <BucketName-APPID>.ci.<Region>.myqcloud.com
    Date: <GMT Date>
    Authorization: <Auth String>
    
    说明:

    • Authorization: Auth String(详情请参见 请求签名 文档)。
    • 通过子账号使用时,需要授予相关的权限,详情请参见授权粒度详情文档。

    请求头

    此接口仅使用公共请求头部,详情请参见 公共请求头部 文档。

    请求体

    该请求无请求体。

    响应

    响应头

    此接口仅返回公共响应头部,详情请参见 公共响应头部 文档。

    响应体

    该响应体返回为 application/xml 数据,包含完整节点数据的内容展示如下:

    <Response>
      <JobsDetail>
      </JobsDetail>
      <NonExistJobIds></NonExistJobIds>
    </Response>
    

    具体的数据内容如下:

    节点名称(关键字) 父节点 描述 类型
    Response 保存结果的容器 Container

    Container 节点 Response 的内容:

    节点名称(关键字) 父节点 描述 类型
    JobsDetail Response 任务的详细信息 Container
    NonExistJobIds Response 查询的 ID 中不存在任务,所有任务都存在时不返回 String

    对于不同的任务类型,JobsDetail 的内容不同,请参照以下链接:

    错误码

    该请求操作无特殊错误信息,常见的错误信息请参见 错误码 文档。

    实际案例

    请求1:查询一个任务,该任务正在执行中

    GET /jobs/j8d121820f5e411ec926ef19d53ba9c6f HTTP/1.1
    Accept: */*
    Authorization: q-sign-algorithm=sha1&q-ak=AKIDZfbOAo7cllgPvF9cXFrJD0a1ICvR****&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=28e9a4986df11bed0255e97ff90500557e0ea057
    Host: examplebucket-1250000000.ci.ap-beijing.myqcloud.com
    

    响应

    HTTP/1.1 200 OK
    Content-Type: application/xml
    Content-Length: 666
    Connection: keep-alive
    Date: Mon, 28 Jun 2022 15:23:12 GMT
    Server: tencent-ci
    x-ci-request-id: NTk0MjdmODlfMjQ4OGY3XzYzYzhf****
    <Response>
      <JobsDetail>
          <Code>Success</Code>
          </Message>
          <JobId>j8d121820f5e411ec926ef19d53ba9c6f</JobId>
          <State>Running</State>
          <Progress>30</Progress>
          <CreationTime>2022-06-27T15:23:12+0800</CreationTime>
          <StartTime>2022-06-27T15:23:13+0800</StartTime>
          <EndTime>-</EndTime>
          <QueueId>p2242ab62c7c94486915508540933a2c6</QueueId>
          <Tag>Transcode</Tag>
          <Input>
              <BucketId>test-123456789</BucketId>
              <Object>input/demo.mp4</Object>
              <Region>ap-chongqing</Region>
          </Input>
          <Operation>
              <TemplateId>t1460606b9752148c4ab182f55163ba7cd</TemplateId>
              <WatermarkTemplateId>t1318c5f428d474afba1797f84091cbe22</WatermarkTemplateId>
              <WatermarkTemplateId>t1318c5f428d474afba1797f84091cbe23</WatermarkTemplateId>
              <WatermarkTemplateId>t1318c5f428d474afba1797f84091cbe24</WatermarkTemplateId>
              <RemoveWatermark>
                  <Dx>150</Dx>
                  <Dy>150</Dy>
                  <Width>75</Width>
                  <Height>75</Height>
              </RemoveWatermark>
              <DigitalWatermark>
                  <Type>Text</Type>
                  <Message>123456789ab</Message>
                  <Version>V1</Version>
                  <IgnoreError>false</IgnoreError>
                  <State>Running</State>
              </DigitalWatermark>
              <Output>
                  <Region>ap-chongqing</Region>
                  <Bucket>test-123456789</Bucket>
                  <Object>output/out.mp4</Object>
              </Output>
              <UserData>This is my data.</UserData>
          </Operation>
      </JobsDetail>
    </Response>
    

    请求2:查询一个任务,该任务执行成功

    GET /jobs/j9c0a4726f6ac11ec96aaa9b64ab18d00 HTTP/1.1
    Accept: */*
    Authorization: q-sign-algorithm=sha1&q-ak=AKIDZfbOAo7cllgPvF9cXFrJD0a1ICvR****&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=28e9a4986df11bed0255e97ff90500557e0ea057
    Host: examplebucket-1250000000.ci.ap-beijing.myqcloud.com
    

    响应

    HTTP/1.1 200 OK
    Content-Type: application/xml
    Content-Length: 666
    Connection: keep-alive
    Date: Mon, 28 Jun 2022 15:25:22 GMT
    Server: tencent-ci
    x-ci-request-id: NTk0MjdmODlfMjQ4OGY3XzYzYzhf****
    <Response>
      <JobsDetail>
          <Code>Success</Code>
          </Message>
          <JobId>j9c0a4726f6ac11ec96aaa9b64ab18d00</JobId>
          <State>Success</State>
          <Progress>100</Progress>
          <CreationTime>2022-06-27T15:23:12+0800</CreationTime>
          <StartTime>2022-06-27T15:23:13+0800</StartTime>
          <EndTime>2022-06-27T15:24:33+0800</EndTime>
          <QueueId>p2242ab62c7c94486915508540933a2c6</QueueId>
          <Tag>Transcode</Tag>
          <Input>
              <BucketId>test-123456789</BucketId>
              <Object>input/demo.mp4</Object>
              <Region>ap-chongqing</Region>
          </Input>
          <Operation>
              <TemplateId>t1460606b9752148c4ab182f55163ba7cd</TemplateId>
              <WatermarkTemplateId>t1318c5f428d474afba1797f84091cbe22</WatermarkTemplateId>
              <WatermarkTemplateId>t1318c5f428d474afba1797f84091cbe23</WatermarkTemplateId>
              <WatermarkTemplateId>t1318c5f428d474afba1797f84091cbe24</WatermarkTemplateId>
              <RemoveWatermark>
                  <Dx>150</Dx>
                  <Dy>150</Dy>
                  <Width>75</Width>
                  <Height>75</Height>
              </RemoveWatermark>
              <DigitalWatermark>
                  <Type>Text</Type>
                  <Message>123456789ab</Message>
                  <Version>V1</Version>
                  <IgnoreError>false</IgnoreError>
                  <State>Running</State>
              </DigitalWatermark>
              <Output>
                  <Region>ap-chongqing</Region>
                  <Bucket>test-123456789</Bucket>
                  <Object>output/out.mp4</Object>
              </Output>
              <UserData>This is my data.</UserData>
              <JobLevel>0</JobLevel>
              <MediaInfo>
                  <Format>
                      <Bitrate>834.736000</Bitrate>
                      <Duration>13.654000</Duration>
                      <FormatLongName>QuickTime / MOV</FormatLongName>
                      <FormatName>mov,mp4,m4a,3gp,3g2,mj2</FormatName>
                      <NumProgram>0</NumProgram>
                      <NumStream>2</NumStream>
                      <Size>1424687</Size>
                      <StartTime>0.000000</StartTime>
                  </Format>
                  <Stream>
                      <Audio>
                          <Bitrate>104.047000</Bitrate>
                          <Channel>2</Channel>
                          <ChannelLayout>stereo</ChannelLayout>
                          <CodecLongName>AAC (Advanced Audio Coding)</CodecLongName>
                          <CodecName>aac</CodecName>
                          <CodecTag>0x6134706d</CodecTag>
                          <CodecTagString>mp4a</CodecTagString>
                          <CodecTimeBase>1/44100</CodecTimeBase>
                          <Duration>13.653311</Duration>
                          <Index>1</Index>
                          <Language>und</Language>
                          <SampleFmt>fltp</SampleFmt>
                          <SampleRate>44100</SampleRate>
                          <StartTime>0.000000</StartTime>
                          <Timebase>1/44100</Timebase>
                      </Audio>
                      <Subtitle/>
                      <Video>
                          <AvgFps>25.000000</AvgFps>
                          <Bitrate>763.774000</Bitrate>
                          <CodecLongName>H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10</CodecLongName>
                          <CodecName>h264</CodecName>
                          <CodecTag>0x31637661</CodecTag>
                          <CodecTagString>avc1</CodecTagString>
                          <CodecTimeBase>1/12800</CodecTimeBase>
                          <ColorPrimaries>bt470bg</ColorPrimaries>
                          <ColorRange>tv</ColorRange>
                          <ColorTransfer>smpte170m</ColorTransfer>
                          <Duration>12.960000</Duration>
                          <Fps>25.000000</Fps>
                          <HasBFrame>0</HasBFrame>
                          <Height>960</Height>
                          <Index>0</Index>
                          <Language>und</Language>
                          <Level>10</Level>
                          <NumFrames>324</NumFrames>
                          <PixFormat>yuv420p</PixFormat>
                          <Profile>High</Profile>
                          <RefFrames>1</RefFrames>
                          <Rotation>0.000000</Rotation>
                          <StartTime>0.000000</StartTime>
                          <Timebase>1/12800</Timebase>
                          <Width>544</Width>
                      </Video>
                  </Stream>
              </MediaInfo>
              <MediaResult>
                  <OutputFile>
                      <Bucket>test-123456789</Bucket>
                      <Region>ap-chongqing</Region>
                      <ObjectName>output/out.mp4</ObjectName>
                      <Md5Info>
                              <Md5>3df1f845d2ffd20a525a93ec40014d90</Md5>
                              <ObjectName>output/out.mp4</ObjectName>
                      </Md5Info>
                  </OutputFile>
              </MediaResult>
          </Operation>
      </JobsDetail>
    </Response>
    
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持