文档首页/ 视频智能分析服务 VIAS/ API参考/ 算法API/ 边缘服务API/ 创建边缘城管事件-占道经营检测作业

更新时间：2025-02-24 GMT+08:00

查看PDF

创建边缘城管事件-占道经营检测作业

功能介绍

该接口用于创建边缘城管事件-占道经营检测作业。

URI

POST /v2/{project_id}/services/c-urban-roadside-stall-edge/tasks

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	用户项目ID。获取方法参见获取项目ID和名称。

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	用户Token，获取方法参见认证鉴权。

表3 请求Body参数
参数	是否必选	参数类型	描述
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	否	RoadsideServiceConfig 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

表4 TaskSchedule
参数	是否必选	参数类型	描述
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<>>	时间段模式配置，指定周计划或者月计划中具体每天作业的执行时间段，至少需指定一个时间段。

表5 TaskInput
参数	是否必选	参数类型	描述
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时必填。

表6 TaskInputData
参数	是否必选	参数类型	描述
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

表7 TaskInputVcn
参数	是否必选	参数类型	描述
ip	是	String	VCN服务器的IP地址，仅输入类型为vcn时必填。
port	是	Integer	VCN服务器的端口号，仅输入类型为vcn时必填。最小值：0 最大值：65535
username	是	String	VCN服务器的账号名，仅输入类型为vcn时需填且必填,需要满足正则表达式^.{1,100}$。
password	是	String	VCN服务器的与账号对应的密码，仅输入类型为vcn时必填，需要满足正则表达式^.{1,1000}$。

表8 TaskOutput
参数	是否必选	参数类型	描述
obs	否	TaskOutputObs object	输出为obs类型时的配置信息。
dis	否	TaskOutputDis object	输出为dis类型时的配置信息。
webhook	否	TaskOutputWebhook object	输出为webhook类型时的配置信息。
event_center	否	Boolean	是否把告警发送至事件中心，云上作业该字段有效。缺省值：false

表9 TaskOutputObs
参数	是否必选	参数类型	描述
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

**表10** TaskOutputDis
参数	是否必选	参数类型	描述
stream_name	是	String	DIS流名称，选用dis类型输出时必填。最大长度：64
data_category	否	Array of strings	作业输出数据类别的列表，选填，仅部分服务需要。当输出类型下有这个列表时，表示希望这个输出类型下存放dataCategory列表内的数据。数组长度：0 - 10

**表11** TaskOutputWebhook
参数	是否必选	参数类型	描述
url	是	String	结果回调地址，选用webhook类型输出时必填。最大长度：1000
headers	是	Object	结果回调时需要携带的请求头，选用webhook类型输出时必填。整体呈json格式，以键值对的形式表示请求头和取值，至少1组，至多10组。
data_category	否	Array of strings	作业输出数据类别的列表，选填，仅部分服务需要。当输出类型下有这个列表时，表示希望这个输出类型下存放dataCategory列表内的数据。数组长度：0 - 10

**表12** RoadsideServiceConfig
参数	是否必选	参数类型	描述
common	否	RoadsideCommon object	作业运行时指定的具体的自定义配置项，由服务发布者定义。整体呈json格式，具体配置项参见相应算法服务的说明。

**表13** RoadsideCommon
参数	是否必选	参数类型	描述
image_compression_ratio	否	Integer	对应控制台的界面参数“图片压缩比”。取值范围为[20, 100]，默认值为90，表示图片压缩比为90%。最小值：20 最大值：100 缺省值：90
roadside_stall_detect_sw	否	Integer	对应控制台的界面参数“占道经营开关”。 "0"：表示不检测占道经营。 "1"：表示检测占道经营。默认值为1。最小值：0 最大值：1 缺省值：1
outstore_stall_detect_sw	否	Integer	对应控制台的界面参数“出店经营开关”。 "0"：表示不检测出店经。 "1"：表示检测出店经营。默认值为0。最小值：0 最大值：1 缺省值：0
render_result_sw	否	Integer	对应控制台的界面参数“目标框渲染开关”。输出图像是否绘制告警目标边框，取值范围： 0：表示不绘制。 1：表示用红色绘制告警目标边框。默认值为0。最小值：0 最大值：1 缺省值：0
render_roi_sw	否	Integer	对应控制台的界面参数“检测区域渲染开关”。输出图像是否绘制检测区域，取值范围: 0：表示不绘制。 1：表示用黄色绘制用户设定区域。默认值为0。最小值：0 最大值：1 缺省值：0
event_disappear_alert_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"}]} 可为每个区域设置名称，后续输出结果时会连带输出区域名称。参数没有携带时，默认区域为整个视频帧，默认区域名称为空字符串。
repeat_alert_sw	否	Integer	对应控制台的界面参数“重复告警开关”。是否对同一目标进行重复告警，取值范围： "0"：表示关闭，不重复告警。 "1"：表示开启，重复告警。默认值为0。重复告警开关开启后，周期性的告警所有目标，同一目标每次告警的detection_id相同，参数repeat_alert_interval才会生效。最小值：0 最大值：1 缺省值：0
repeat_alert_interval	否	Integer	对应控制台的界面参数“重复告警间隔”。在参数repeat_alert_sw为1时才会生效。控制重复告警的时间间隔，单位为秒。取值范围：[30, 86400]，最长时间间隔为24小时。默认值为30。每30秒告警一次，同一个告警目标detection_id相同。最小值：30 最大值：86400 缺省值：30

响应参数

状态码： 200

**表14** 响应Body参数
参数	参数类型	描述
tasks	Array of TaskResponse objects	VIAS平台创建作业的作业id列表

**表15** TaskResponse
参数	参数类型	描述
id	String	VIAS平台创建的作业id。

状态码： 400

**表16** 响应Body参数
参数	参数类型	描述
error_code	String	错误码。
error_msg	String	错误信息描述。
detail	String	错误详情。
params	Array of strings	错误参数列举。数组长度：0 - 1
reason	String	错误原因。
advice	String	建议。

状态码： 500

**表17** 响应Body参数
参数	参数类型	描述
error_code	String	错误码。
error_msg	String	错误信息描述。
detail	String	错误详情。
params	Array of strings	错误参数列举。数组长度：0 - 1
reason	String	错误原因。
advice	String	建议。

请求示例

边缘城管事件-占道经营检测作业创建，使用输入源为video_source，输出为dis。

POST /v2/{project_id}/services/c-urban-roadside-stall-edge/tasks

{
  "name" : "roadside-task",
  "description" : "roadside task test",
  "input" : {
    "type" : "video_source",
    "data" : [ {
      "video_source_id" : "xxxxxxx-xxxxxxx-xxxxxxx-xxxxx-xxxxxx"
    } ]
  },
  "output" : {
    "dis" : {
      "stream_name" : "dis-test"
    }
  },
  "service_version" : "3.0",
  "resource_order_id" : "840a5cf90d4a4bbaa71f251dfe8fe64e",
  "config" : {
    "common" : {
      "event_disappear_alert_sw" : 0,
      "image_compression_ratio" : 90,
      "roadside_stall_detect_sw" : 1,
      "outstore_stall_detect_sw" : 0,
      "render_roi_sw" : 1,
      "render_result_sw" : 1,
      "target_roi" : "{\"polygons\":[{\"data\":[[84,389],[1840,349],[1824,526],[78,526]],\"name\":\"a\"}]}"
    }
  }
}

边缘城管事件-占道经营检测作业创建，使用输入源为restful，输出为webhook。

POST /v2/{project_id}/services/c-urban-roadside-stall-edge/tasks

{
  "name" : "roadside-task",
  "description" : "roadside task test",
  "input" : {
    "type" : "restful",
    "data" : [ {
      "index" : 0,
      "url" : "http://xxx.xxx.xxx.xxx:xxx/test/data",
      "certificate_check" : false,
      "rtsp_path_in_response" : "data/url"
    } ]
  },
  "output" : {
    "webhook" : {
      "url" : "https://apigw.huawei.com/xxx/xxx/callback",
      "headers" : {
        "content-type" : "application/json"
      }
    }
  },
  "service_version" : "3.0",
  "resource_order_id" : "840a5cf90d4a4bbaa71f251dfe8fe64e",
  "config" : {
    "common" : {
      "event_disappear_alert_sw" : 0,
      "image_compression_ratio" : 90,
      "roadside_stall_detect_sw" : 1,
      "outstore_stall_detect_sw" : 0,
      "render_roi_sw" : 1,
      "render_result_sw" : 1,
      "target_roi" : "{\"polygons\":[{\"data\":[[84,389],[1840,349],[1824,526],[78,526]],\"name\":\"a\"}]}"
    }
  }
}

边缘城管事件-占道经营检测作业创建，使用输入源为边缘摄像头，输出为dis。

POST /v2/{project_id}/services/c-urban-roadside-stall-edge/tasks

{
  "name" : "roadside-task",
  "description" : "roadside task test",
  "input" : {
    "type" : "edgecamera",
    "data" : [ {
      "id" : "aec5857c-222f-4aa9-be39-23654e118886",
      "index" : 0
    } ]
  },
  "output" : {
    "dis" : {
      "stream_name" : "dis-test"
    }
  },
  "service_version" : "3.0",
  "resource_order_id" : "840a5cf90d4a4bbaa71f251dfe8fe64e",
  "config" : {
    "common" : {
      "event_disappear_alert_sw" : 0,
      "image_compression_ratio" : 90,
      "roadside_stall_detect_sw" : 1,
      "outstore_stall_detect_sw" : 0,
      "render_roi_sw" : 1,
      "render_result_sw" : 1,
      "target_roi" : "{\"polygons\":[{\"data\":[[84,389],[1840,349],[1824,526],[78,526]],\"name\":\"a\"}]}"
    }
  }
}

边缘城管事件-占道经营检测作业创建，使用输入源为VCN，输出为dis。

POST /v2/{project_id}/services/c-urban-roadside-stall-edge/tasks

{
  "name" : "roadside-task",
  "description" : "roadside task test",
  "input" : {
    "type" : "vcn",
    "vcn" : {
      "ip" : "xxx.xxx.xxx.xxx",
      "password" : "CQeNfcRLwyMvH77AkDBaPS+BKXdFu/1bAXtIMNTx3QPbVewjipNq06nNodxWI28I1lCUsvv2+wB1joepzynLVW3g2nz0k9vaCRDoK6=",
      "port" : "xxx",
      "username" : "testname"
    },
    "data" : [ {
      "index" : 0,
      "stream_type" : 1,
      "device_id" : "07211540881586160101#f7964493ff764bbf9294d58b22e63de6"
    } ]
  },
  "output" : {
    "dis" : {
      "stream_name" : "dis-test"
    }
  },
  "service_version" : "3.0",
  "resource_order_id" : "840a5cf90d4a4bbaa71f251dfe8fe64e",
  "config" : {
    "common" : {
      "event_disappear_alert_sw" : 0,
      "image_compression_ratio" : 90,
      "roadside_stall_detect_sw" : 1,
      "outstore_stall_detect_sw" : 0,
      "render_roi_sw" : 1,
      "render_result_sw" : 1,
      "target_roi" : "{\"polygons\":[{\"data\":[[84,389],[1840,349],[1824,526],[78,526]],\"name\":\"a\"}]}"
    }
  }
}

响应示例

状态码： 200

创建服务作业成功。

{
  "tasks" : [ {
    "id" : "20690c67d71549c39085a3b28c18f24f"
  } ]
}

状态码

状态码	描述
200	创建服务作业成功。
400	请求错误。
500	内部错误。

错误码

请参见错误码。

父主题： 边缘服务API

上一篇：创建边缘城管事件-动态视角垃圾检测作业

下一篇：创建边缘城管事件-裸土暴露检测作业

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消