视频接入分析服务 VIAS-创建边缘城管事件-垃圾检测作业:请求

时间：2023-12-26 14:16:16

请求

请求样例1（摄像头输入+DIS/Webhook输出）

POST /v2/6204a5bd270343b5885144cf9c8c158d/services/c-urban-trash-detect-edge/tasks
{
    "name": "c-urban-trash-detect-edge-task",
    "description": "c-urban-trash-detect-edge test",
    "input": {
        "type": "edgecamera",
        "data": [
            {
                "id": "25292206-995f-4c31-bfd5-b0dd7bc389e7",
                "index": 0
            }
        ]
    },
    "output": {
        "dis": {
            "stream_name": "dis-suxinxing"
        },
        "webhook": {
                "url": "https://apigw.huawei.com/api/event/callback",
                "headers": {
                "content-type":"application/json"
            }
        }
    },
    "service_version": "3.0",
    "resource_order_id": "840a5cf90d4a4bbaa71f251dfe8fe64e",
    "edge_pool_id": "8dcf5ec7bc4d4a26aa1d3e1bb5ed2b5a",
    "service_config": {
        "common": {
             "image_compression_ratio": 90, 
             "trash_detect_sw": 1,
             "person_constraint_sw": 0,
             "min_trash_size": 1,
             "render_roi_sw": 1, 
             "render_result_sw": 1, 
             "target_roi": "{\"polygons\":[{\"data\":[[84,389],[1840,349],[1824,526],[78,526]],\"name\":\"a\"}]}" 
             }

        }
}

请求样例2（edgerestful输入+DIS/Webhook输出）

POST /v2/6204a5bd270343b5885144cf9c8c158d/services/c-urban-trash-detect-edge/tasks
{
    "name": "c-urban-trash-detect-edge-task",
    "description": "c-urban-trash-detect-edge test",
    "input": {
        "type": "edgerestful",
        "data": [
            {
                "index": 0,
                "url":"https://100.127.134.69:554/test/data",
                "certificate_check": false,
                "rtsp_path_in_response": "data/url"
            }
        ]
    },
    "output": {
        "dis": {
            "stream_name": "dis-suxinxing"
        },
        "webhook": {
                "url": "https://apigw.huawei.com/api/event/callback",
                "headers": {
                "content-type":"application/json"
            }
        }
    },
    "service_version": "3.0",
    "resource_order_id": "840a5cf90d4a4bbaa71f251dfe8fe64e",
    "edge_pool_id": "8dcf5ec7bc4d4a26aa1d3e1bb5ed2b5a",
    "service_config": {
         "common": {
             "image_compression_ratio": 90,
             "trash_detect_sw": 1,
             "person_constraint_sw": 0,
             "min_trash_size": 1,
             "render_roi_sw": 1, 
             "render_result_sw": 1, 
             "target_roi": "{\"polygons\":[{\"data\":[[84,389],[1840,349],[1824,526],[78,526]],\"name\":\"a\"}]}"
             }

       }
}

请求样例3（VCN输入+DIS/Webhook输出）

POST /v2/6204a5bd270343b5885144cf9c8c158d/services/c-urban-trash-detect-edge/tasks
{
    "name": "c-urban-trash-detect-edge-task",
    "description": "c-urban-trash-detect-edge test",
    "input": {
        "type": "vcn",
        "vcn":{
                "ip":"172.100.119.6",
                "password":"CQeNfcRLwyMvH77AkDBaPS+BKXdFu/1bAXtIMNTx3QPbVewjipNq06nNodxWI28I1lCUsvv2+wB1joepzynLVW3g2nz0k9vaCRDoK6=",
                "port":"4675",
                "username":"testname"
        },
        "data": [
            {
                "index": 0,
                 "device_id":"07211540881586160101#f7964493ff764bbf9294d58b22e63de6",
                 "stream_type":1
            }
        ]
    },
    "output": {
        "dis": {
            "stream_name": "dis-suxinxing"
        },
        "webhook": {
                "url": "https://apigw.huawei.com/api/event/callback",
                "headers": {
                "content-type":"application/json"
            }
        }
    },
    "service_version": "3.0",
    "resource_order_id": "840a5cf90d4a4bbaa71f251dfe8fe64e",
    "edge_pool_id": "8dcf5ec7bc4d4a26aa1d3e1bb5ed2b5a",
    "service_config": {
         "common": {
             "image_compression_ratio": 90, 
             "trash_detect_sw": 1,
             "person_constraint_sw": 0,
             "min_trash_size": 1,
             "render_roi_sw": 1, 
             "render_result_sw": 1, 
             "target_roi": "{\"polygons\":[{\"data\":[[84,389],[1840,349],[1824,526],[78,526]],\"name\":\"a\"}]}"
             }
       }
}

参数说明

参数	是否必选	类型	说明
name	是	String	作业名称，只能由中文、字母（a～zA～Z）、数字（0～9）、中划线（-）、下划线（_）组成，长度范围为[1，100]。
description	否	String	作业描述信息，最大长度为500字符长度。
input	是	Object	视频数据输入列表，支持从指定的边缘摄像头读取数据，即输入类型为“edgecamera”，“edgerestful”，“VCN”。详细参数定义参见task.input（任务输入参数）。
service_version	是	String	功能版本号，版本号为3.0。边缘算法版本支持的显卡硬件为T4和Davinci芯片。
resource_order_id	是	String	购买的算法能力包ID，在服务界面购买算法能力包获取。
edge_pool_id	是	String	边缘运行池ID，获取方法参见创建边缘运行池。
output	是	Object	结果数据的输出列表，目前支持以下输出类型： DIS：将结果输出到您指定的DIS通道。 Webhook：将结果输出到Webhook URL。 Localpath：将作业的运行结果保存在边缘节点本地（节点必须为linux系统），必须为linux路径，例如“/opt/cloud/”。详细参数定义见task.output（任务输出参数）。
service_config	否	Object	服务的算法配置，配置参数见ServiceConfig参数说明。

service_config中common参数说明

字段	是否必选	类型	说明
image_compression_ratio	否	Int	对应控制台的界面参数“图片压缩比”。图片压缩百分比，取值范围为[20，100]。默认值：90，表示图片压缩比为90%。
trash_detect_sw	否	Int	对应控制台的界面参数“垃圾检测开关”。 "1"：表示检测垃圾； "2"：表示检测垃圾并检测疑似丢垃圾的人。默认值为1。
person_constraint_sw	否	Int	对应控制台的界面参数“邻近行人约束开关”。当开关打开时，垃圾附近有行人逗留的告警将被过滤。 "0"：表示不开启开关； "1"：表示开启开关；默认值为0。
min_trash_size	否	Int	对应控制台的界面参数“垃圾最小尺寸”。由于不同应用场景对垃圾的定义不同，用户可自定义配置垃圾最小尺寸，小于该尺寸的垃圾目标将不被告警。取值范围[1, 500]。单位为像素。默认值为1。
render_result_sw	否	Int	对应控制台的界面参数“目标框渲染开关”。输出图像是否绘制告警目标边框，取值范围: "0"：表示不绘制； "1"：表示用红色绘制告警目标边框。默认值为0。
render_roi_sw	否	Int	对应控制台的界面参数“检测区域渲染开关”。输出图像是否绘制检测区域，取值范围: "0"：表示不绘制； "1"：表示用黄色绘制用户设定区域。默认值为0。
target_roi	否	String	对应控制台的界面参数“检测区域设置”。表示检测区域，该字段为JSON格式的字符串，API调用时需要加转义符。格式参见设置taeget_roi。例如： {"polygons":[{"data":[[84,389],[1840,349],[1824,526],[78,526]],"name":"polygon"}]} 可为每个区域设置名称，后续输出结果时会连带输出区域名称。参数没有携带时，默认区域为整个视频帧，默认区域名称为空字符串。