DescribeMediaJobs 接口用来拉取符合条件的任务。
GET /jobs?size=&states=&queueId=&startCreationTime=&endCreationTime= HTTP/1.1
Host: <BucketName-APPID>.ci.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
说明:
- Authorization: Auth String(详情请参见 请求签名 文档)。
- 通过子账号使用时,需要授予相关的权限,详情请参见授权粒度详情文档。
此接口仅使用公共请求头部,详情请参见 公共请求头部 文档。
该请求无请求体。
参数的具体内容如下:
节点名称(关键字) | 父节点 | 描述 | 类型 | 必选 |
---|---|---|---|---|
queueId | 无 | 拉取该队列ID下的任务 | String | 是 |
tag | 无 | 任务的 Tag:VideoTag | String | 是 |
orderByTime | 无 | Desc 或者 Asc 。默认为 Desc | String | 否 |
nextToken | 无 | 请求的上下文,用于翻页。上次返回的值 | String | 否 |
size | 无 | 拉取的最大任务数。默认为10。最大为100 | Integer | 否 |
states | 无 | 拉取该状态的任务,以, 分割,支持多状态:All,Submitted,Running,Success,Failed,Pause,Cancel 。默认为 All |
String | 否 |
startCreationTime | 无 | 拉取创建时间大于该时间的任务。格式为:%Y-%m-%dT%H:%m:%S%z |
String | 否 |
endCreationTime | 无 | 拉取创建时间小于该时间的任务。格式为:%Y-%m-%dT%H:%m:%S%z |
String | 否 |
此接口仅返回公共响应头部,详情请参见 公共响应头部 文档。
该响应体返回为 application/xml 数据,包含完整节点数据的内容展示如下:
<Response>
<JobsDetail>
</JobsDetail>
<NextToken></NextToken>
</Response>
具体的数据内容如下:
节点名称(关键字) | 父节点 | 描述 | 类型 |
---|---|---|---|
Response | 无 | 保存结果的容器 | Container |
Container 节点 Response 的内容:
节点名称(关键字) | 父节点 | 描述 | 类型 |
---|---|---|---|
JobsDetail | Response | 任务的详细信息,同 DescibeMediaJob 接口中的 Response.JobsDetail 节点 | Container |
NextToken | Response | 翻页的上下文 Token | String |
该请求操作无特殊错误信息,常见的错误信息请参见 错误码 文档。
GET /jobs?queueId=aaaaaaaaaaa&tag=VideoTag HTTP/1.1
Authorization:q-sign-algorithm=sha1&q-ak=AKIDZfbOAo7cllgPvF9cXFrJD0**********&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=28e9a4986df11bed0255e97ff90500557e0ea057
Host:bucket-1250000000.ci.ap-beijing.myqcloud.com
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 666
Connection: keep-alive
Date: Thu, 15 Jun 2017 12:37:29 GMT
Server: tencent-ci
x-ci-request-id: NTk0MjdmODlfMjQ4OGY3XzYzYzhfMjc=
<Response>
<JobsDetail>
<Code>Success</Code>
<Message>Success</Message>
<JobId>jabcxxxxfeipplsdfwe</JobId>
<State>Submitted</State>
<CreationTime>2019-07-07T12:12:12+0800</CreationTime>
<StartTime></StartTime>
<EndTime></EndTime>
<QueueId>p893bcda225bf4945a378da6662e81a89</QueueId>
<Tag>VideoTag<Tag>
<Input>
<Object>test.mp4</Object>
</Input>
<Operation>
<VideoTag>
<Scenario>Stream</Scenario>
</VideoTag>
<VideoTagResult>
<StreamData>
<Data>
<Tags>
<Confidence>0.939035</Confidence>
<Tag>自然风景</Tag>
<TagCls>生活</TagCls>
</Tags>
<Tags>
<Confidence>0.884062</Confidence>
<Tag>雪山</Tag>
<TagCls>旅行风景</TagCls>
</Tags>
<Tags>
<Confidence>0.345798</Confidence>
<Tag>云彩</Tag>
<TagCls>旅行风景</TagCls>
</Tags>
<Tags>
<Confidence>0.997328</Confidence>
<Tag>自然风景</Tag>
</Tags>
<Tags>
<Confidence>0.997595</Confidence>
<Tag>旅行风景</Tag>
</Tags>
<PersonTags>
<Name>韩雪</Name>
<Confidence>0.985561</Confidence>
<Count>3</Count>
<DetailPerSecond>
<TimeStamp>1</TimeStamp>
<Confidence>0.8411815762519836</Confidence>
<BBox>
<X1>0.29050925925925924</X1>
<Y1>0.257201646090535</Y1>
<X2>0.4652777777777778</X2>
<Y2>0.6584362139917695</Y2>
</BBox>
</DetailPerSecond>
<DetailPerSecond>
<TimeStamp>2</TimeStamp>
<Confidence>0.9262690246105194</Confidence>
<BBox>
<X1>0.3472222222222222</X1>
<Y1>0.03497942386831276</Y1>
<X2>0.6412037037037037</X2>
<Y2>0.7181069958847737</Y2>
</BBox>
</DetailPerSecond>
<DetailPerSecond>
<TimeStamp>3</TimeStamp>
<Confidence>0.8933985382318497</Confidence>
<BBox>
<X1>0.3576388888888889</X1>
<Y1>0.03497942386831276</Y1>
<X2>0.6631944444444444</X2>
<Y2>0.7366255144032922</Y2>
</BBox>
</DetailPerSecond>
</PersonTags>
<PersonTags>
<Name>古力娜扎</Name>
<Confidence>0.9010105729103088</Confidence>
<Count>2</Count>
<DetailPerSecond>
<TimeStamp>18</TimeStamp>
<Confidence>0.8933985382318497</Confidence>
<BBox>
<X1>0.5567129629629629</X1>
<Y1>0.13991769547325103</Y1>
<X2>0.8078703703703703</X2>
<Y2>0.7469135802469136</Y2>
</BBox>
</DetailPerSecond>
<DetailPerSecond>
<TimeStamp>19</TimeStamp>
<Confidence>0.8933985382318497</Confidence>
<BBox>
<X1>0.5335648148148148</X1>
<Y1>0.21193415637860083</Y1>
<X2>0.7800925925925926</X2>
<Y2>0.8045267489711934</Y2>
</BBox>
</DetailPerSecond>
</PersonTags>
<PlaceTags>
<Tags>
<Tag>森林</Tag>
<TagCls>自然/户外</TagCls>
<Confidence>0.516961</Confidence>
</Tags>
<Tags>
<Tag>田野/公园/花园</Tag>
<TagCls>自然/户外</TagCls>
<Confidence>0.230019</Confidence>
</Tags>
<StartTime>0.0</StartTime>
<EndTime>68.6</EndTime>
<StartIndex>0</StartIndex>
<EndIndex>1715</EndIndex>
<ClipFrameResult>森林:0.37</ClipFrameResult>
<ClipFrameResult>森林:0.22</ClipFrameResult>
<ClipFrameResult>田野_公园_花园:0.19</ClipFrameResult>
<ClipFrameResult>果园:0.14</ClipFrameResult>
</PlaceTags>
<PlaceTags>
<StartTime>68.64</StartTime>
<EndTime>72.4</EndTime>
<StartIndex>1716</StartIndex>
<EndIndex>1810</EndIndex>
<ClipFrameResult>特写镜头:0.23</ClipFrameResult>
<ClipFrameResult>冰川_冰山:0.04</ClipFrameResult>
<ClipFrameResult>特写镜头:0.06</ClipFrameResult>
<ClipFrameResult>特写镜头:0.09</ClipFrameResult>
</PlaceTags>
<ActionTags>
<StartTime>5.8</StartTime>
<EndTime>8.56</EndTime>
<Tags>
<Tag>说话</Tag>
<TagCls>说话</TagCls>
<Confidence>0.90646</Confidence>
</Tags>
<Tags>
<Tag>敬酒</Tag>
<TagCls>敬酒</TagCls>
<Confidence>0.91610</Confidence>
</Tags>
</ActionTags>
<ObjectTags>
<TimeStamp>62.0</TimeStamp>
<Objects>
<Name>蛋糕</Name>
<Confidence>0.638210</Confidence>
<BBox>
<X1>0.21793489158153534</X1>
<Y1>0.5634896159172058</Y1>
<X2>0.6121288537979126</X2>
<Y2>1.0</Y2>
</BBox>
</Objects>
<Objects>
<Name>桌子</Name>
<Confidence>0.67762</Confidence>
<BBox>
<X1>0.06269711256027222</X1>
<Y1>0.6098541021347046</Y1>
<X2>0.9128285646438599</X2>
<Y2>0.9146066904067993</Y2>
</BBox>
</Objects>
</ObjectTags>
</Data>
<SubErrCode>0</SubErrCode>
<SubErrMsg>ok</SubErrMsg>
</StreamData>
</VideoTagResult>
</Operation>
</JobsDetail>
</Response>
本页内容是否解决了您的问题?