创建边缘非机动车检测作业-CreateNonMotorVehicleDetectionEdgeTasks

project_id

是

String

参数解释：

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

约束限制：

不涉及。

取值范围：

只能由英文字母和数字组成，且长度为[1-64]个字符。

默认取值：

不涉及。

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

否

NonMotorServiceConfig 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

否

NonMotorCommon object

参数解释：

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

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

illegal_park_detection_sw

否

Integer

参数解释：

对应控制台的界面参数“违停检测开关”。违停检测开关，取值范围[0,1]：

• 0: 表示不检测违停事件。

• 1: 表示检测违停事件。

约束限制：

不涉及。

取值范围：

[0, 1]。

默认取值：

1

illegal_park_alert_threshold

否

Integer

参数解释：

对应控制台的界面参数“告警触发时间”。告警触发时间阈值，单位秒。电动车停留超过这个时间则告警。

约束限制：

当illegal_park_detection_sw=1时该参数生效。

取值范围：

[10, 3600]。

默认取值：

30

intrusion_detection_sw

否

Integer

参数解释：

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

• 0: 表示不检测入侵事件。

• 1: 表示检测入侵事件。

约束限制：

不涉及。

取值范围：

[0, 1]。

默认取值：

0

electromobile_detect_sw

否

Integer

参数解释：

对应控制台的界面参数“电动车检测开关”。

• 0: 表示不检测电动车。

• 1: 表示检测电动车。

约束限制：

不涉及。

取值范围：

[0, 1]。

默认取值：

1

bicycle_detect_sw

否

Integer

参数解释：

对应控制台的界面参数“自行车检测开关”。

• 0: 表示不检测自行车。

• 1: 表示检测自行车。

约束限制：

不涉及。

取值范围：

[0, 1]。

默认取值：

1

render_result_sw

否

Integer

参数解释：

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

• 0：表示不绘制。

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

约束限制：

不涉及。

取值范围：

[0, 1]。

默认取值：

0

render_roi_sw

否

Integer

参数解释：

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

• 0：表示不绘制。

• 1：表示用绿色绘制用户设定的合法停车区域，用黄色绘制用户设定的禁止进入区域或者非法停车区域。

约束限制：

不涉及。

取值范围：

[0, 1]。

默认取值：

0

event_disappear_alert_sw

否

Integer

参数解释：

对应控制台的界面参数“事件消失告警开关”。取值范围:

• 0：表示不开启。

• 1：表示开启。

约束限制：

不涉及。

取值范围：

[0, 1]。

默认取值：

0

image_compression_ratio

否

Integer

参数解释：

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

约束限制：

不涉及。

取值范围：

[20, 100]。

默认取值：

90

target_roi

否

String

参数解释：

对应控制台的界面参数“区域设置”。电动车检测区域设置，包括合法停车区域、非法停车区域、禁止进入区域。

• 合法停车区域，区域参数。用"name":"legal_area"标识。当电动车停在合法停车区域之外，则触发违停事件。

• 非法停车区域，区域参数。用"name":"illegal_area"标识。当电动车停在非法停车区域时，则触发违停事件。

• 禁止进入区域，区域参数。用"name":"prohibit_entering_area"标识。当有电动车入侵禁止进入区域，则触发入侵事件。

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

• 例如：{"polygons":[{"data":[[43,266],[42,645],[472,644],[416,212]],"name":"legal_area"},{"data":[[311,182],[282,670],[941,661],[835,170]],"name":"prohibit_entering_area"},{"data":[[1272,592],[1481,813],[1623,638],[1293,356]],"name":"illegal_area"}]}。当同时设置"legal_area"与"illegal_area"时，生效的为"illegal_area"，在绘制渲染区域时，也只会渲染非法停车区域。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

参数没有携带时，默认全屏都是不合法停车区域；全屏都是禁止进入区域。

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

内部错误。