获取任务详情
功能介绍
用于获取视频智能分析任务详情。
调用方法
请参见如何调用API。
URI
GET /v2/{project_id}/tasks/{task_id}
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
用户项目ID,获取方法参见获取项目ID和名称。 |
|
task_id |
是 |
String |
作业ID。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token,获取方法参见认证鉴权。 |
响应参数
状态码: 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
任务ID。 |
|
name |
String |
任务的名称。 |
|
creator |
String |
任务创建者的用户名。 |
|
project_id |
String |
任务创建者的项目ID。 |
|
description |
String |
任务的描述。 |
|
release_id |
String |
任务对应服务的ID。 |
|
service_id |
String |
任务对应服务的ID。 |
|
created_at |
String |
任务创建的时间。 |
|
updated_at |
String |
任务最近一次状态更新的时间。 |
|
state |
String |
任务当前的状态,分别为PENDING(等待中),RECOVERING(恢复中),STARTING(启动中),UPGRADING(升级中),CREATE_FAILED(创建失败),START_FAILED(启动失败),RUNNING(运行中),STOPPING(停止中),STOPPED(已停止),ABNORMAL(异常),SUCCEEDED(运行成功),FAILED(运行失败),DELETING(删除中),FREEZING(冻结中),FROZEN(已冻结) |
|
status |
String |
任务状态的详情信息,仅部分状态会有详情信息 |
|
error |
error object |
错误信息 |
|
schedule_status |
String |
计划任务的状态,分别为ACTIVATED(激活),INACTIVATED(未激活)。 |
|
schedule |
TaskSchedule object |
定时任务参数,定时周期仅支持周模式。 |
|
input |
TaskInput object |
任务的输入配置,必填。 |
|
output |
TaskOutputForDisplay object |
作业的输出配置展示。 |
|
config |
TaskServiceConfig object |
任务运行时指定的自定义参数,由服务发布者定义。 |
|
video_source_name |
String |
视频源名称 |
|
title |
String |
算法中文名称 |
|
group_name |
String |
分组名称,多个以逗号分隔 |
|
company |
String |
厂商 |
|
task_config |
String |
任务算法配置 |
|
type |
String |
cloud或edge |
|
resource_order_id |
String |
资源订单id |
|
package_id |
String |
算法包id |
|
device_id |
String |
设备id |
|
access_address |
String |
接入地址 |
|
algorithm_publish_id |
String |
算法id |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
type |
String |
计划任务的类型,使用计划任务时必填。可选类型weekly(每周执行)。 |
|
timezone |
String |
用户所处的时区,使用计划任务时必填。精确到分钟 |
|
days_of_week |
Array of integers |
任务会在一周的哪几天执行,当且仅当计划任务类型为weekly时,该字段需填且必填。1~7分别指代星期一至星期日 |
|
days_of_month |
Array of integers |
任务会在一个月的哪几天执行,当且仅当计划任务类型为monthly时,该字段需填且必填。1~31分别指代一个月中的1日至31日,当前系统不支持该参数。 |
|
periods |
Array<Array<TimeWindow>> |
时间段模式配置,指定周计划或者月计划中具体每天任务的执行时间段,至少需指定一个时间段 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
begin_at |
String |
单个时间段执行的起始时间,必填。其余计划任务类型时,格式为hh:mm:ss。 |
|
end_at |
String |
单个时间段执行的结束时间,必填,其余计划任务类型时,格式为hh:mm:ss。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
type |
String |
任务的输入类型,创建时必填,视频源类型为video_source 时 不支持切换为其他的type。创建时可选类型有 obs(对象存储服务存储的文件 仅云上任务支持,支持输出到webhook), url(指定的文件地址或取流地址 仅云上任务支持,支持输出到webhook), edgecamera(绑定在IEF的边缘摄像头 仅边缘任务支持,支持输出到webhook), restful(从自定义的流媒体服务器通过Restful接口获取流地址。云上和边缘任务均支持,支持输出到webhook), vcn(VCN设备 仅边缘任务支持), video_source(使用VIAS平台视频中心管理的视频源,云上和边缘任务均支持), 建议使用video_source类型,其他类型为了兼容老业务,后续将废弃。 枚举值: |
|
data |
Array of TaskInputData objects |
任务的输入详情,必填。针对不同的输入类型有不同的配置。创建时允许填写多路输入,但更新时只允许填写一路输入。 当输入类型为:obs,需要配置 bucket,path , index 。例如: "bucket": "aicam", "path": "3rdpartylicenses.txt", "index": 0 当输入类型为:url,需要配置 url, index 。例如: "url": "https://xxx-xxx.com", "index": 0 当输入类型为:restful,需要配置 certificate_check, rtsp_path_in_response, url, index, headers 。例如:"certificate_check": true, "url": "https://hsaij-dasahbi.com", "rtsp_path_in_response": "data/url", "index": 0, "headers": { "AAA": "AAA" } 当输入类型为:vcn,需要配置 device_id, stream_type, index。例如:"device_id": "21356478954612546874#gdhjkiushdgdksjhslmhscjsckjhdbnk", "stream_type": 1, "index": 0 当输入类型为:EdgeCamera,需要配置 id, index 例如:"id": "007cdafc-6000-47ce-b0e3-870b4a0db65e","index": 0 |
|
vcn |
TaskInputVcn object |
VCN服务器信息,仅输入类型为vcn时需填且必填 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
video_source_id |
String |
视频源id,当输入类型为video_source时必填。 |
|
stream_name |
String |
视频流名称 |
|
bucket |
String |
OBS桶名,当输入为obs类型时必填 |
|
path |
String |
OBS的路径,当输入为obs类型时必填 |
|
url |
String |
url输入源的地址或者获取视频流地址的restful请求地址,当输入为url类型或者edgerestful类型时必填。长度不超过1000 |
|
headers |
Object |
获取视频流地址的restful请求携带的请求头,当输入为edgerestful类型时可选。整体呈json格式,以键值对的形式表示请求头和取值,最多允许10组。 |
|
rtsp_path_in_response |
String |
restful请求返回的body中,视频流地址的路径,当输入为edgerestful类型时必填。长度不超过1024 |
|
device_id |
String |
VCN设备ID,当输入为vcn类型时必填 |
|
stream_type |
Integer |
准备进行分析的码流,当输入为vcn类型时选填。取值范围为1~3,其中1代表主码流,2代表子码流1,3代表子码流2 |
|
id |
String |
IEF挂载的边缘设备的ID,当输入为edgecamera类型时必填 |
|
certificate_check |
Boolean |
是否需要对https请求进行证书校验,当输入为edgerestful类型时必填。取值为true或者false。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
ip |
String |
VCN服务器的IP地址,仅输入类型为vcn时需填且必填 |
|
port |
Integer |
VCN服务器的端口号,仅输入类型为vcn时需填且必填 |
|
username |
String |
VCN服务器的账号名,仅输入类型为vcn时需填且必填,需要满足正则表达式^.{1,100}$。 |
|
password |
String |
VCN服务器的与账号对应的密码,仅输入类型为vcn时需填且必填,需要满足正则表达式^.{1,1000}$。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
obs |
TaskOutputObs object |
输出为obs类型时的配置信息 |
|
dis |
TaskOutputDis object |
输出为dis类型时的配置信息 |
|
webhook |
TaskOutputWebhook object |
输出为webhook类型时的配置信息 |
|
event_center |
Boolean |
输出类型是否关联事件中心 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
bucket |
String |
OBS桶名,选用obs类型输出时必填,校验规则:(pattern:“^[a-z0-9](?!.[-.][-.].)([a-z0-9-.]{1,61})[a-z0-9]$”) |
|
path |
String |
OBS的路径,选用obs类型输出时必填,校验规则:^(?![/.\s])(?!.//.)([^:*?"<>|\]{0,1023})(?<![.\s])$ |
|
data_category |
Array of strings |
作业输出数据类别的列表,选填,仅部分服务需要。当输出类型下有这个列表时,表示希望这个输出类型下存放dataCategory列表内的数据 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
stream_name |
String |
DIS流名称,选用dis类型输出时必填,校验规则:^[-A-Za-z0-9_]{1,64}$。 |
|
data_category |
Array of strings |
任务输出数据类别的列表,选填,仅部分服务需要。当输出类型下有这个列表时,表示希望这个输出类型下存放dataCategory列表内的数据。 【例如创建边缘人脸任务API中,输出结果支持data_category参数,取值范围为[FacaImage,OriginImage],分别表示是否发送人脸图和原始图】 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
url |
String |
结果回调地址,选用webhook类型输出时必填 |
|
headers |
Object |
结果回调时需要携带的请求头,选用webhook类型输出时必填。整体呈json格式,以键值对的形式表示请求头和取值,至少1组,至多10组 |
|
data_category |
Array of strings |
任务输出数据类别的列表,选填,仅部分服务需要。当输出类型下有这个列表时,表示希望这个输出类型下存放dataCategory列表内的数据 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
common |
Object |
任务运行时指定的具体的自定义配置项,由服务发布者定义。整体呈json格式,具体配置项参见相应算法服务的说明 |
状态码: 400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误码 |
|
error_msg |
String |
错误信息描述 |
|
detail |
String |
错误详情 |
|
params |
Array of strings |
错误参数列举 |
|
reason |
String |
错误原因 |
|
advice |
String |
建议 |
状态码: 500
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误码 |
|
error_msg |
String |
错误信息描述 |
|
detail |
String |
错误详情 |
|
params |
Array of strings |
错误参数列举 |
|
reason |
String |
错误原因 |
|
advice |
String |
建议 |
请求示例
获取任务详情,展示任务的名称,输入方式,输出方式等任务信息
/v2/{project_id}/tasks/{task_id}
https://{endpoint}/v2/{project_id}/tasks/{task_id}?
响应示例
状态码: 200
任务详情信息
{
"id" : "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"name" : "qqqq_task",
"creator" : "test",
"project_id" : "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"release_id" : "xxxxxxx-xxxxxxx-xxxxxxx-xxxxx-xxxxxx",
"service_id" : "xxxxxxx-xxxxxxx-xxxxxxx-xxxxx-xxxxxx",
"created_at" : "2023-06-06T06:59:33.024Z",
"updated_at" : "2023-06-06T06:59:33.024Z",
"event_type" : 0,
"priority" : "low",
"steal" : 0,
"state" : "PENDING",
"input" : {
"type" : "video_source",
"data" : [ {
"video_source_id" : "xxxxxxx-xxxxxxx-xxxxxxx-xxxxx-xxxxxx"
} ]
},
"output" : {
"event_center" : true
},
"config" : {
"common" : { }
},
"video_source_name" : "url_test",
"task_config" : "<?xml version=\"1.0\" encoding=\"UTF-8\"?><algorithm><config><common><param titleCn=\"platform\" name=\"platform\" required=\"false\" titleEn=\"platform\" type=\"Object\"><param titleCn=\"project_id\" name=\"project_id\" required=\"false\" titleEn=\"project_id\" type=\"String\"/><param titleCn=\"domain_name\" name=\"domain_name\" required=\"false\" titleEn=\"domain_name\" type=\"String\"/><param titleCn=\"agency_name\" name=\"agency_name\" required=\"false\" titleEn=\"agency_name\" type=\"String\"/><param titleCn=\"domain_id\" name=\"domain_id\" required=\"false\" titleEn=\"domain_id\" type=\"String\"/><param titleCn=\"task_id\" name=\"task_id\" required=\"false\" titleEn=\"task_id\" type=\"String\"/></param></common></config></algorithm>",
"type" : "0",
"package_id" : "xxxxxxx-xxxxxxx-xxxxxxx-xxxxx-xxxxxx"
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
任务详情信息 |
|
400 |
请求错误 |
|
500 |
内部错误 |