创建边缘城管事件-垃圾检测作业

project_id

是

String

用户项目ID。获取方法参见获取项目ID和名称。

X-Auth-Token

是

String

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

name

是

String

作业名称，只能由中文、字母（a～z A～Z）、数字（0～9）、中划线（-）、下划线（_）组成，长度范围为[1，100]。

description

否

String

作业描述信息，最大长度为500字符长度。

最小长度：0

最大长度：500

schedule

否

TaskSchedule object

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

input

是

TaskInput object

作业的输入配置。

output

是

TaskOutput object

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

config

否

TrashDetectServiceConfig object

作业配置参数。

service_version

是

String

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

最小长度：3

最大长度：32

is_saved_as_template

否

Boolean

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

resource_order_id

否

String

资源订单id，与关联算法挂钩。非商用白名单的算法 就不用填，商用算法就为必填项，需要满足正则表达式^[a-z0-9-_]{4,36}$。

最小长度：4

最大长度：36

type

是

String

计划任务的类型，使用计划任务时必填。可选类型分别为weekly（每周执行），monthly（每月执行）。

timezone

是

String

用户所处的时区，使用计划任务时必填。精确到分钟。

days_of_week

否

Array of integers

作业会在一周的哪几天执行，当且仅当计划任务类型为weekly时，该字段需填且必填。1~7分别指代星期一至星期日。

最小值：1

最大值：7

数组长度：1 - 7

days_of_month

否

Array of integers

作业会在一个月的哪几天执行，当且仅当计划任务类型为monthly时，该字段需填且必填。1~31分别指代一个月中的1日至31日。

最小值：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类型时必填。

最大长度：63

path

否

String

OBS的路径，当输入为obs类型时必填。

最大长度：1023

url

否

String

url输入源的地址或者获取视频流地址的restful请求地址，当输入为url类型或者edgerestful类型时必填。长度不超过1000。

最大长度：1000

headers

否

Object

获取视频流地址的restful请求携带的请求头，当输入为edgerestful类型时可选。整体呈json格式，以键值对的形式表示请求头和取值，最多允许10组。

certificate_check

否

Boolean

是否需要对https请求进行证书校验，当输入为edgerestful类型时必填。取值为true或者false。

rtsp_path_in_response

否

String

restful请求返回的body中，视频流地址的路径，当输入为edgerestful类型时必填。长度不超过1024。

最大长度：1024

device_id

否

String

VCN设备ID，当输入为vcn类型时必填。

stream_type

否

Integer

准备进行分析的码流，当输入为vcn类型时选填。取值范围为1~3，其中1代表主码流，2代表子码流1，3代表子码流2。

最小值：1

最大值：3

id

否

String

IEF挂载的边缘设备的ID，当输入为edgecamera类型时必填。

最大长度：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

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

缺省值：false

bucket

是

String

OBS桶名，选用obs类型输出时必填，校验规则：(pattern:“^[a-z0-9](?!.[-.][-.].)([a-z0-9-.]{1,61})[a-z0-9]$”)。

最大长度：63

path

是

String

OBS的路径，选用obs类型输出时必填，校验规则：^(?![/.\s])(?!.//.)([^:*?"<>|]{0,1023})(?<![.\s])$。

最大长度：1023

data_category

否

Array of strings

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

数组长度：0 - 10

stream_name

是

String

DIS流名称，选用dis类型输出时必填。

最大长度：64

data_category

否

Array of strings

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

数组长度：0 - 10

url

是

String

结果回调地址，选用webhook类型输出时必填。

最大长度：1000

headers

是

Object

结果回调时需要携带的请求头，选用webhook类型输出时必填。整体呈json格式，以键值对的形式表示请求头和取值，至少1组，至多10组。

data_category

否

Array of strings

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

数组长度：0 - 10

common

否

TrashDetectCommon object

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

image_compression_ratio

否

Integer

对应控制台的界面参数“图片压缩比”。取值范围为[20, 100]，默认值为90，表示图片压缩比为90%。

最小值：20

最大值：100

缺省值：90

trash_detect_sw

否

Integer

对应控制台的界面参数“垃圾检测开关”。

• "1"：表示检测垃圾。

• "2"：表示检测垃圾并检测疑似丢垃圾的人。

• 默认值为1。

最小值：1

最大值：2

缺省值：1

person_constraint_sw

否

Integer

对应控制台的界面参数“邻近行人约束开关”。当开关打开时，垃圾附近有行人逗留的告警将被过滤。

• "0"：表示不开启开关。

• "1"：表示开启开关。

• 默认值为0。

最小值：0

最大值：1

缺省值：0

min_trash_size

否

Integer

对应控制台的界面参数“垃圾最小尺寸”。由于不同应用场景对垃圾的定义不同，用户可自定义配置垃圾最小尺寸，小于该尺寸的垃圾目标将不被告警。取值范围[1, 500]。单位为像素。默认值为1。

最小值：1

最大值：500

缺省值：1

render_result_sw

否

Integer

对应控制台的界面参数“目标框渲染开关”。输出图像是否绘制告警目标边框，取值范围：

• 0：表示不绘制。

• 1：表示用红色绘制告警目标边框。

• 默认值为0。

最小值：0

最大值：1

缺省值：0

render_roi_sw

否

Integer

对应控制台的界面参数“检测区域渲染开关”。输出图像是否绘制检测区域，取值范围:

• 0：表示不绘制。

• 1：表示用黄色绘制用户设定区域。

• 默认值为0。

最小值：0

最大值：1

缺省值：0

target_roi

否

String

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

• 该字段为JSON格式的字符串，API调用时需要加转义符。详细JSON格式参见设置target_roi。

• 例如：{"polygons":[{"data":[[84,389],[1840,349],[1824,526],[78,526]],"name":"polygon"}]}

• 可为每个区域设置名称，后续输出结果时会连带输出区域名称。

• 参数没有携带时，默认区域为整个视频帧，默认区域名称为空字符串。

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

内部错误。