任务回调

最近更新时间:2023-09-12 16:21:42

我的收藏

功能说明

数据万象支持自定义设置回调 URL,在任务完成后,系统向该 URL 发送 HTTP POST 请求,请求体中包含通知内容。您可通过配置的回调地址及时了解任务处理的进展和状态,以便进行其他业务操作。

回调内容

任务完成后,系统会向您设置的回调地址发送回调内容,包含完整节点数据的内容展示如下:
<Response>
<EventName>TaskFinish</EventName>
<JobsDetail>
<Code>Success</Code>
<CreationTime>2022-07-01T10:05:48+0800</CreationTime>
<EndTime>2022-07-01T10:06:02+0800</EndTime>
<Input>
<BucketId>test-123456789</BucketId>
<Object>input/demo.mp4</Object>
<Region>ap-chongqing</Region>
</Input>
<JobId>j535b10a4f8e211ec9452c1c27f56a659</JobId>
<Message>Success</Message>
<Operation>
<UserData>This is my VideoTag job.</UserData>
<JobLevel>0</JobLevel>
<VideoTag>
<Scenario>Stream</Scenario>
</VideoTag>
<VideoTagResult>
<StreamData>
<Data>
<ActionTags>
<EndTime>11</EndTime>
<StartTime>0</StartTime>
<Tags>
<Confidence>0.421531</Confidence>
<Tag>说话</Tag>
<TagCls>说话</TagCls>
</Tags>
</ActionTags>
<ActionTags>
<EndTime>12.88</EndTime>
<StartTime>11.04</StartTime>
<Tags/>
</ActionTags>
<ObjectTags>
<Objects>
<BBox>
<X1>0.10181817412376404</X1>
<X2>0.8069194555282593</X2>
<Y1>0.6880248785018921</Y1>
<Y2>0.8779844045639038</Y2>
</BBox>
<Confidence>0.808393</Confidence>
<Name>电脑键盘</Name>
</Objects>
<TimeStamp>11</TimeStamp>
</ObjectTags>
<PersonTags/>
<PlaceTags>
<ClipFrameResult>办公室:0.55</ClipFrameResult>
<ClipFrameResult>办公室:0.55</ClipFrameResult>
<ClipFrameResult>办公室:0.59</ClipFrameResult>
<ClipFrameResult>办公室:0.54</ClipFrameResult>
<ClipFrameResult>办公室:0.42</ClipFrameResult>
<ClipFrameResult>办公室:0.43</ClipFrameResult>
<ClipFrameResult>办公室:0.33</ClipFrameResult>
<ClipFrameResult>办公室:0.29</ClipFrameResult>
<ClipFrameResult>办公室:0.15</ClipFrameResult>
<ClipFrameResult>娱乐场:0.42</ClipFrameResult>
<ClipFrameResult>办公室:0.33</ClipFrameResult>
<EndIndex>275</EndIndex>
<EndTime>11</EndTime>
<StartIndex>0</StartIndex>
<StartTime>0</StartTime>
<Tags>
<Confidence>0.591724</Confidence>
<Tag>办公室</Tag>
<TagCls>办公</TagCls>
</Tags>
<Tags>
<Confidence>0.175342</Confidence>
<Tag>超市/便利店/商店</Tag>
<TagCls>商业</TagCls>
</Tags>
</PlaceTags>
<PlaceTags>
<ClipFrameResult>其他:0.09</ClipFrameResult>
<ClipFrameResult>其他:0.21</ClipFrameResult>
<ClipFrameResult>其他:0.19</ClipFrameResult>
<ClipFrameResult>天空:0.28</ClipFrameResult>
<ClipFrameResult>天空:0.25</ClipFrameResult>
<ClipFrameResult>其他:0.30</ClipFrameResult>
<ClipFrameResult>其他:0.28</ClipFrameResult>
<ClipFrameResult>其他:0.49</ClipFrameResult>
<ClipFrameResult>其他:0.56</ClipFrameResult>
<ClipFrameResult>其他:0.58</ClipFrameResult>
<EndIndex>322</EndIndex>
<EndTime>12.88</EndTime>
<StartIndex>276</StartIndex>
<StartTime>11.04</StartTime>
<Tags>
<Confidence>0.581444</Confidence>
<Tag>其他</Tag>
<TagCls>其他</TagCls>
</Tags>
<Tags>
<Confidence>0.283301</Confidence>
<Tag>天空</Tag>
<TagCls>自然/户外</TagCls>
</Tags>
</PlaceTags>
<Tags>
<Confidence>0.355083</Confidence>
<Tag>MOBA类-王者荣耀</Tag>
</Tags>
<Tags>
<Confidence>0.587103</Confidence>
<Tag>游戏</Tag>
</Tags>
<Tags>
<Confidence>0.544651</Confidence>
<Tag>办公室</Tag>
</Tags>
<Tags>
<Confidence>0.182886</Confidence>
<Tag>超市/便利店/商店</Tag>
</Tags>
</Data>
<SubErrCode>0</SubErrCode>
<SubErrMsg>ok</SubErrMsg>
</StreamData>
</VideoTagResult>
</Operation>
<QueueId>p2242ab62c7c94486915508540933a2c6</QueueId>
<StartTime>2022-07-01T10:05:50+0800</StartTime>
<State>Success</State>
<Tag>VideoTag</Tag>
<VideoTag/>
</JobsDetail>
</Response>
具体的数据内容如下:
节点名称(关键字)
父节点
描述
类型
Response
保存结果的容器
Container
Container 节点 Response 的内容:
节点名称(关键字)
父节点
描述
类型
EventName
Response
固定值,为 TaskFinish
String
JobsDetail
Response
同提交视频标签接口中的 Response.JobsDetail
Container数组
如果任务是通过工作流触发的,Response.JobsDetail.Input还会包含 CosHeaders 节点,类型为 Container 数组。
Container 节点 CosHeaders 的内容:
节点名称(关键字)
父节点
描述
类型
Key
Response.JobsDetail.Input.CosHeaders
自定义 Header 的名称
String
Value
Response.JobsDetail.Input.CosHeaders
自定义 Header 的值
String
如果任务是通过工作流触发的,Response.JobsDetail 还会包含 Workflow 节点,类型为 Container。
Container 节点 Workflow 的内容:
节点名称(关键字)
父节点
描述
类型
RunId
Response.Workflow
工作流实例 ID
String
WorkflowId
Response.Workflow
工作流 ID
String
WorkflowName
Response.Workflow
工作流名称
String
Name
Response.Workflow
工作流节点名称
String

实际案例

案例 1:通过任务接口触发的任务回调

<Response>
<EventName>TaskFinish</EventName>
<JobsDetail>
<Code>Success</Code>
<CreationTime>2022-07-01T10:05:48+0800</CreationTime>
<EndTime>2022-07-01T10:06:02+0800</EndTime>
<Input>
<BucketId>test-123456789</BucketId>
<Object>input/demo.mp4</Object>
<Region>ap-chongqing</Region>
</Input>
<JobId>j535b10a4f8e211ec9452c1c27f56a659</JobId>
<Message>Success</Message>
<Operation>
<UserData>This is my VideoTag job.</UserData>
<JobLevel>0</JobLevel>
<VideoTag>
<Scenario>Stream</Scenario>
</VideoTag>
<VideoTagResult>
<StreamData>
<Data>
<ActionTags>
<EndTime>11</EndTime>
<StartTime>0</StartTime>
<Tags>
<Confidence>0.421531</Confidence>
<Tag>说话</Tag>
<TagCls>说话</TagCls>
</Tags>
</ActionTags>
<ActionTags>
<EndTime>12.88</EndTime>
<StartTime>11.04</StartTime>
<Tags/>
</ActionTags>
<ObjectTags>
<Objects>
<BBox>
<X1>0.10181817412376404</X1>
<X2>0.8069194555282593</X2>
<Y1>0.6880248785018921</Y1>
<Y2>0.8779844045639038</Y2>
</BBox>
<Confidence>0.808393</Confidence>
<Name>电脑键盘</Name>
</Objects>
<TimeStamp>11</TimeStamp>
</ObjectTags>
<PersonTags/>
<PlaceTags>
<ClipFrameResult>办公室:0.55</ClipFrameResult>
<ClipFrameResult>办公室:0.55</ClipFrameResult>
<ClipFrameResult>办公室:0.59</ClipFrameResult>
<ClipFrameResult>办公室:0.54</ClipFrameResult>
<ClipFrameResult>办公室:0.42</ClipFrameResult>
<ClipFrameResult>办公室:0.43</ClipFrameResult>
<ClipFrameResult>办公室:0.33</ClipFrameResult>
<ClipFrameResult>办公室:0.29</ClipFrameResult>
<ClipFrameResult>办公室:0.15</ClipFrameResult>
<ClipFrameResult>娱乐场:0.42</ClipFrameResult>
<ClipFrameResult>办公室:0.33</ClipFrameResult>
<EndIndex>275</EndIndex>
<EndTime>11</EndTime>
<StartIndex>0</StartIndex>
<StartTime>0</StartTime>
<Tags>
<Confidence>0.591724</Confidence>
<Tag>办公室</Tag>
<TagCls>办公</TagCls>
</Tags>
<Tags>
<Confidence>0.175342</Confidence>
<Tag>超市/便利店/商店</Tag>
<TagCls>商业</TagCls>
</Tags>
</PlaceTags>
<PlaceTags>
<ClipFrameResult>其他:0.09</ClipFrameResult>
<ClipFrameResult>其他:0.21</ClipFrameResult>
<ClipFrameResult>其他:0.19</ClipFrameResult>
<ClipFrameResult>天空:0.28</ClipFrameResult>
<ClipFrameResult>天空:0.25</ClipFrameResult>
<ClipFrameResult>其他:0.30</ClipFrameResult>
<ClipFrameResult>其他:0.28</ClipFrameResult>
<ClipFrameResult>其他:0.49</ClipFrameResult>
<ClipFrameResult>其他:0.56</ClipFrameResult>
<ClipFrameResult>其他:0.58</ClipFrameResult>
<EndIndex>322</EndIndex>
<EndTime>12.88</EndTime>
<StartIndex>276</StartIndex>
<StartTime>11.04</StartTime>
<Tags>
<Confidence>0.581444</Confidence>
<Tag>其他</Tag>
<TagCls>其他</TagCls>
</Tags>
<Tags>
<Confidence>0.283301</Confidence>
<Tag>天空</Tag>
<TagCls>自然/户外</TagCls>
</Tags>
</PlaceTags>
<Tags>
<Confidence>0.355083</Confidence>
<Tag>MOBA类-王者荣耀</Tag>
</Tags>
<Tags>
<Confidence>0.587103</Confidence>
<Tag>游戏</Tag>
</Tags>
<Tags>
<Confidence>0.544651</Confidence>
<Tag>办公室</Tag>
</Tags>
<Tags>
<Confidence>0.182886</Confidence>
<Tag>超市/便利店/商店</Tag>
</Tags>
</Data>
<SubErrCode>0</SubErrCode>
<SubErrMsg>ok</SubErrMsg>
</StreamData>
</VideoTagResult>
</Operation>
<QueueId>p2242ab62c7c94486915508540933a2c6</QueueId>
<StartTime>2022-07-01T10:05:50+0800</StartTime>
<State>Success</State>
<Tag>VideoTag</Tag>
<VideoTag/>
</JobsDetail>
</Response>

案例 2:通过任务接口触发的任务回调, 格式为 JSON

{
"EventName": "TaskFinish",
"JobsDetail": [{
"Code": "Success",
"CreationTime": "2022-07-01T10:05:48+0800",
"EndTime": "2022-07-01T10:06:02+0800",
"Input": {
"BucketId": "test-123456789",
"Object": "input/demo.mp4",
"Region": "ap-chongqing"
},
"JobId": "j535b10a4f8e211ec9452c1c27f56a659",
"Message": "Success",
"Operation": {
"UserData": "This is my VideoTag job.",
"JobLevel": 0,
"VideoTag": {
"Scenario": "Stream"
},
"VideoTagResult": {
"StreamData": {
"Data": {
"ActionTags": [{
"EndTime": "11",
"StartTime": "0",
"Tags": {
"Confidence": "0.421531",
"Tag": "说话",
"TagCls": "说话"
}
},
{
"EndTime": "12.88",
"StartTime": "11.04"
}
],
"ObjectTags": {
"Objects": {
"BBox": {
"X1": "0.10181817412376404",
"X2": "0.8069194555282593",
"Y1": "0.6880248785018921",
"Y2": "0.8779844045639038"
},
"Confidence": "0.808393",
"Name": "电脑键盘"
},
"TimeStamp": "11"
},
"PlaceTags": [{
"ClipFrameResult": [
"办公室:0.55",
"办公室:0.55",
"办公室:0.59",
"办公室:0.54",
"办公室:0.42",
"办公室:0.43",
"办公室:0.33",
"办公室:0.29",
"办公室:0.15",
"娱乐场:0.42",
"办公室:0.33"
],
"EndIndex": "275",
"EndTime": "11",
"StartIndex": "0",
"StartTime": "0",
"Tags": [{
"Confidence": "0.591724",
"Tag": "办公室",
"TagCls": "办公"
},
{
"Confidence": "0.175342",
"Tag": "超市/便利店/商店",
"TagCls": "商业"
}
]
},
{
"ClipFrameResult": [
"其他:0.09",
"其他:0.21",
"其他:0.19",
"天空:0.28",
"天空:0.25",
"其他:0.30",
"其他:0.28",
"其他:0.49",
"其他:0.56",
"其他:0.58"
],
"EndIndex": "322",
"EndTime": "12.88",
"StartIndex": "276",
"StartTime": "11.04",
"Tags": [{
"Confidence": "0.581444",
"Tag": "其他",
"TagCls": "其他"
},
{
"Confidence": "0.283301",
"Tag": "天空",
"TagCls": "自然/户外"
}
]
}
],
"Tags": [{
"Confidence": "0.355083",
"Tag": "MOBA类-王者荣耀"
},
{
"Confidence": "0.587103",
"Tag": "游戏"
},
{
"Confidence": "0.544651",
"Tag": "办公室"
},
{
"Confidence": "0.182886",
"Tag": "超市/便利店/商店"
}
]
},
"SubErrCode": "0",
"SubErrMsg": "ok"
}
}
},
"QueueId": "p2242ab62c7c94486915508540933a2c6",
"StartTime": "2022-07-01T10:05:50+0800",
"State": "Success",
"Tag": "VideoTag"
}]
}