创建云上关键岗位检测作业-CreateStaffOnDutyCloudTasks

X-Auth-Token

是

String

参数解释：

用户Token，获取方法参见认证鉴权。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

name

是

String

参数解释：

作业名称。

约束限制：

不涉及。

取值范围：

只能由中文、字母（a～z A～Z）、数字（0～9）、中划线（-）、下划线（_）组成。长度限制为[1，100]个字符。

默认取值：

不涉及。

description

否

String

参数解释：

作业描述信息。

约束限制：

不涉及。

取值范围：

长度限制为[0，500]个字符。

默认取值：

不涉及。

schedule

否

TaskSchedule object

参数解释：

定时任务参数，定时周期仅支持周模式。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

input

是

TaskInput object

参数解释：

作业的输入配置。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

output

是

TaskOutput object

参数解释：

作业的输出配置，至少需要配置一项输出方式。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

config

否

StaffOnDutyServiceConfig object

参数解释：

作业配置参数。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

service_version

是

String

参数解释：

服务版本号。

约束限制：

不涉及。

取值范围：

输入需要满足正则：^[a-z0-9.]{3,32}$。

默认取值：

不涉及。

is_saved_as_template

否

Boolean

参数解释：

是否把作业配置保存成模板。

约束限制：

不涉及。

取值范围：

• true：把作业配置保存成模板。

• false：不把作业配置保存成模板。

默认取值：

不涉及。

resource_order_id

否

String

参数解释：

资源订单id，与关联算法挂钩。非商用白名单的算法就不用填，商用算法就为必填项。

约束限制：

非商用白名单的算法就不用填，商用算法就为必填项。

取值范围：

输入需要满足正则：^[a-z0-9-_]{4,36}$。

默认取值：

不涉及。

type

是

String

参数解释：

计划任务的类型。

约束限制：

使用计划任务时必填。

取值范围：

可选类型为weekly（每周执行），monthly（每月执行）。

默认取值：

不涉及。

timezone

是

String

参数解释：

用户所处的时区，精确到分钟。

约束限制：

使用计划任务时必填。

取值范围：

不涉及。

默认取值：

不涉及。

days_of_week

否

Array of integers

参数解释：

作业会在一周的哪几天执行，1~7分别指代星期一至星期日。

约束限制：

当且仅当计划任务类型为weekly时，该字段需填且必填。

取值范围：

最小值：1

最大值：7

数组长度：1 - 7

默认取值：

不涉及。

days_of_month

否

Array of integers

参数解释：

作业会在一个月的哪几天执行，1~31分别指代一个月中的1日至31日。

约束限制：

当且仅当计划任务类型为monthly时，该字段需填且必填。

取值范围：

最小值：1

最大值：31

默认取值：

不涉及。

periods

否

Array<Array<>>

参数解释：

时间段模式配置，指定周计划或者月计划中具体每天作业的执行时间段，至少需指定一个时间段。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

type

是

String

参数解释：

作业的输入类型，创建时必填，编辑时video_source 模式不支持切换为其他IVA模式的type。创建时可选类型有obs（对象存储服务存储的文件仅云上作业支持）， url（指定的文件地址或取流地址 仅云上作业支持）， edgecamera（绑定在IEF的边缘摄像头仅边缘作业支持），restful（从自定义的流媒体服务器通过Restful接口获取流地址。云上，边缘均作业支持）， vcn（VCN设备仅边缘作业支持），video_source（视频源类型），建议使用video_source类型，其他类型为了兼容老业务，后续将废弃。

约束限制：

不涉及。

取值范围：

枚举值：

• video_source

• obs(不建议使用，后续废弃)

• url(不建议使用，后续废弃)

• edgecamera(不建议使用，后续废弃)

• restful(不建议使用，后续废弃)

• vcn(不建议使用，后续废弃)

默认取值：

不涉及。

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

取值范围：

数组长度：[1, 50]。

默认取值：

不涉及。

vcn

否

TaskInputVcn object

参数解释：

VCN服务器信息。

约束限制：

仅输入类型为vcn时必填。

取值范围：

不涉及。

默认取值：

不涉及。

video_source_id

否

String

参数解释：

视频源id。

约束限制：

当输入类型为video_source时必填。

取值范围：

不涉及。

默认取值：

不涉及。

stream_name

否

String

参数解释：

视频流名称。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

bucket

否

String

参数解释：

OBS桶名。

约束限制：

当输入为obs类型时必填。

取值范围：

长度限制为[0, 63]个字符。

默认取值：

不涉及。

path

否

String

参数解释：

OBS的路径。

约束限制：

当输入为obs类型时必填。

取值范围：

长度限制为[0, 1023]个字符。

默认取值：

不涉及。

url

否

String

参数解释：

url输入源的地址或者获取视频流地址的restful请求地址。

约束限制：

当输入为url类型或者edgerestful类型时必填。

取值范围：

长度限制为[0, 1000]个字符。

默认取值：

不涉及。

headers

否

Object

参数解释：

获取视频流地址的restful请求携带的请求头。整体呈json格式，以键值对的形式表示请求头和取值。

约束限制：

当输入为edgerestful类型时可选。

取值范围：

组数取值范围为[0, 10]。

默认取值：

不涉及。

certificate_check

否

Boolean

参数解释：

是否需要对https请求进行证书校验。

约束限制：

当输入为edgerestful类型时必填。

取值范围：

• true：对https请求进行证书校验。

• false：不对https请求进行证书校验。

默认取值：

不涉及。

rtsp_path_in_response

否

String

参数解释：

restful请求返回的body中，视频流地址的路径。

约束限制：

当输入为edgerestful类型时必填。

取值范围：

长度限制为[0, 1024]个字符。

默认取值：

不涉及。

device_id

否

String

参数解释：

VCN设备ID。

约束限制：

当输入为vcn类型时必填。

取值范围：

不涉及。

默认取值：

不涉及。

stream_type

否

Integer

参数解释：

准备进行分析的码流。取值范围为1~3，其中1代表主码流，2代表子码流1，3代表子码流2。

约束限制：

当输入为vcn类型时选填。

取值范围：

[1, 3]。

默认取值：

不涉及。

id

否

String

参数解释：

IEF挂载的边缘设备的ID。

约束限制：

当输入为edgecamera类型时必填。

取值范围：

长度范围为[0, 63]。

默认取值：

不涉及。

ip

是

String

参数解释：

VCN服务器的IP地址。

约束限制：

仅输入类型为vcn时必填。

取值范围：

不涉及。

默认取值：

不涉及。

port

是

Integer

参数解释：

VCN服务器的端口号。

约束限制：

仅输入类型为vcn时必填。

取值范围：

[0, 65535]。

默认取值：

不涉及。

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

参数解释：

是否把告警发送至事件中心，云上作业该字段有效。

约束限制：

不涉及。

取值范围：

• true：把告警发送至事件中心。

• false：不把告警发送至事件中心。

默认取值：

false

bucket

是

String

参数解释：

OBS桶名。

约束限制：

选用obs类型输出时必填。

取值范围：

校验规则：^[a-z0-9](?!.[-.][-.].)([a-z0-9-.]{1,61})[a-z0-9]$

长度限制为[0, 63]个字符。

默认取值：

不涉及。

path

是

String

参数解释：

OBS的路径。

约束限制：

选用obs类型输出时必填。

取值范围：

校验规则：^(?![/.\s])(?!.//.)([^:*?"<>|]{0,1023})(?<![.\s])$

长度限制为[0, 1023]个字符。

默认取值：

不涉及。

data_category

否

Array of strings

参数解释：

作业输出数据类别的列表，仅部分服务需要。当输出类型下有这个列表时，表示希望这个输出类型下存放dataCategory列表内的数据。

约束限制：

不涉及。

取值范围：

数组长度限制为[0, 10]。

默认取值：

不涉及。

stream_name

是

String

参数解释：

DIS流名称。

约束限制：

选用dis类型输出时必填。

取值范围：

长度限制为[0, 64]个字符。

默认取值：

不涉及。

data_category

否

Array of strings

参数解释：

作业输出数据类别的列表，仅部分服务需要。当输出类型下有这个列表时，表示希望这个输出类型下存放dataCategory列表内的数据。

约束限制：

不涉及。

取值范围：

数组长度限制为[0, 10]。

默认取值：

不涉及。

url

是

String

参数解释：

结果回调地址。

约束限制：

选用webhook类型输出时必填。

取值范围：

长度限制为[0, 1000]个字符。

默认取值：

不涉及。

headers

是

Object

参数解释：

结果回调时需要携带的请求头，整体呈json格式，以键值对的形式表示请求头和取值。

约束限制：

选用webhook类型输出时必填。

取值范围：

组数限制为[1, 10]。

默认取值：

不涉及。

data_category

否

Array of strings

参数解释：

作业输出数据类别的列表，仅部分服务需要。当输出类型下有这个列表时，表示希望这个输出类型下存放dataCategory列表内的数据。

约束限制：

不涉及。

取值范围：

数组长度限制为[0, 10]。

默认取值：

不涉及。

common

否

StaffOnDutyCommon object

参数解释：

作业运行时指定的具体的自定义配置项，由服务发布者定义。整体呈json格式，具体配置项参见相应算法服务的说明。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

key_region_detection_sw

否

Integer

参数解释：

对应控制台的界面参数“关键岗位检测开关”。是否开启关键岗位检测告警。

• 0：表示不开启

• 1：表示开启

约束限制：

不涉及。

取值范围：

[0, 1]。

默认取值：

1

key_region_person_count

否

Integer

参数解释：

对应控制台的界面参数“在岗最小人数”。表示关键岗位检测区域的最少人数。

约束限制：

不涉及。

取值范围：

[1, 100]。

默认取值：

2

key_region_detect_interval

否

Integer

参数解释：

对应控制台的界面参数“检测周期”。表示关键区域检测周期，单位为秒。当时间到达检测周期整数倍时，触发算法检测在岗人数。

约束限制：

不涉及。

取值范围：

[1, 3600]。

默认取值：

1

key_region_detect_threshold

否

Integer

参数解释：

对应控制台的界面参数“告警触发阈值”。触发阈值，单位为检测周期个数。假设告警触发阈值为N，当连续N个检测周期时间内检测结果都不满足最小在岗人数，则触发告警。触发告警或满足在岗人数则重新开始计数，直到再次达到告警阈值。

约束限制：

不涉及。

取值范围：

[1, 3600]。

默认取值：

60

image_compression_ratio

否

Integer

参数解释：

对应控制台的界面参数“图片压缩比”。默认值为90，表示图片压缩比为90%。

约束限制：

不涉及。

取值范围：

[20, 100]。

默认取值：

90

target_roi

否

String

参数解释：

对应控制台的界面参数“检测区域设置”。

• 表示检测区域，该字段为JSON格式的字符串，API调用时需要加转义符，需要设置区域的坐标和区域对应的名称，支持多区域检测，如果设置不同的区域需要输入不同的名称，默认的区域名称是Central_Area, 在告警图片中区域框会用黄色画出来。详细JSON格式参见设置target_roi。

• 例如：{"polygons":[{"data":[[694,83],[718,406],[1202,422],[1204,78]],"name":"region-1"},{"data":[[1379,164],[1407,649],[1872,700],[1844,206]],"name":"region-2"},{"data":[[701,640],[718,918],[1296,921],[1286,634]],"name":"region-3"}]}

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

参数没有携带时，默认区域为整个视频帧中间的1/4。设图像宽度为w，高度为h，则区域四个端点的位置是[[1/4w, 1/4h], [3/4w, 1/4h], [1/4w, 3/4h], [3/4w, 3/4h]]。

tasks

Array of TaskResponse objects

参数解释：

VIAS平台创建作业的作业id列表。

取值范围：

不涉及。

id

String

参数解释：

VIAS平台创建的作业id。

取值范围：

不涉及。

error_code

String

参数解释：

错误码。

取值范围：

不涉及。

error_msg

String

参数解释：

错误信息描述。

取值范围：

不涉及。

detail

String

参数解释：

错误详情。

取值范围：

不涉及。

params

Array of strings

参数解释：

错误参数列举。

取值范围：

数组长度[0, 1]。

reason

String

参数解释：

错误原因。

取值范围：

不涉及。

advice

String

参数解释：

建议。

取值范围：

不涉及。

error_code

String

参数解释：

错误码。

取值范围：

不涉及。

error_msg

String

参数解释：

错误信息描述。

取值范围：

不涉及。

detail

String

参数解释：

错误详情。

取值范围：

不涉及。

params

Array of strings

参数解释：

错误参数列举。

取值范围：

数组长度[0, 1]。

reason

String

参数解释：

错误原因。

取值范围：

不涉及。

advice

String

参数解释：

建议。

取值范围：

不涉及。

200

创建服务作业成功。

400

请求错误。

500

内部错误。