视频智能分析服务 VIAS-华为云

视频智能分析服务 VIAS-构造请求:请求消息头

请求消息头附加请求头字段，如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”，请求鉴权信息等。需要添加到请求中的公共消息头如表3所示。表3 公共请求消息头参数名说明是否必选示例 Content-type 消息体的类型（格式），默认取值为“application/json”。是 application/json Content-Length 请求body长度，单位为Byte。 POST/PUT请求必填。GET不能包含。 3495 X-Project-Id project id，用于不同project取token。否 e9993fc787d94b6c886cbaa340f9c0f4 X-Auth-Token 用户Token，也就是调用获取用户Token接口的响应值，该接口是唯一不需要认证的接口。否使用Token认证时必选。 - X-Sdk-Date 请求的发生时间，格式为(YYYYMMDD'T'HHMMSS'Z')。取值为当前系统的GMT时间。否如果使用ak/sk做接口认证的时候，那么此字段必须设置；如果使用PKI token的时候，不必设置。 20190307T101459Z Authorization 签名认证信息。该值来源于请求签名结果，使用AK/SK进行加密签名的时候需要。类型：字符串默认值：无否使用AK/SK认证时必选。 SDK-HMAC-SHA256 Credential=ZIRRKMTWPTQFQI1WKNKB/20150907//ec2/sdk_request, SignedHeaders=content-type;host;x-sdk-date, Signature=55741b610f3c9fa3ae40b5a8021ebf7ebc2a28a603fc62d25cb3bfe6608e1994 Host 请求的服务器信息，从服务API的URL中获取。值为hostname[:port]。端口缺省时使用默认的端口，https的默认端口为443。否使用AK/SK认证时必选。 code.test.com or code.test.com:443 公有云API同时支持使用AK/SK认证，AK/SK认证是使用SDK对请求进行签名，签名过程会自动往请求中添加Authorization（签名认证信息）和X-Sdk-Date（请求发送的时间）请求头。AK/SK认证的详细说明请参见API签名指南。对于获取用户Token接口，由于不需要认证，所以只添加“Content-Type”即可，添加消息头后的请求如下所示。 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens Content-Type: application/json

视频智能分析服务 VIAS

视频智能分析服务 VIAS-构造请求:请求消息体

请求消息体请求消息体通常以结构化格式发出，与请求消息头中Content-type对应，传递除请求消息头之外的内容。若请求消息体中参数支持中文，则中文字符必须为UTF-8编码。每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。对于获取用户Token接口，您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示。加粗的斜体字段需要根据实际值填写，其中username为用户名，domainname为用户所属的账号名称，********为用户登录密码，cn-north-1为project的name，获取方法请参见获取用户名、账号名和项目name。 scope参数定义了Token的作用范围，取值为project或domain，示例中取值为project，表示获取的Token仅能访问指定project下的资源，取值为domainname时，表示获取的token可以访问指定账号下所有资源，scope参数的详细说明，请参见获取用户Token接口。 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens Content-Type:application/json { "auth": { "identity": { "methods": ["password"], "password": { "user": { "name": "username", //替换为实际用户名 "password": "**********",//替换为实际的用户密码 "domain": { "name": "domianname" //替换为实际账号名 } } } }, "scope": { "project": { "name": "cn-north-1" //替换为实际的project name，获取作用范围为指定project的Token } } } } 到这里为止这个请求需要的内容就具备齐全了，您可以使用curl、Postman或直接编写代码等方式发送请求调用API，Postman建议使用7.24.0版本。对于获取用户Token接口，返回的响应消息头中“x-subject-token”的值，就是需要获取的用户Token。有了Token之后，您就可以使用Token认证调用其他API。

视频智能分析服务 VIAS

视频智能分析服务 VIAS-构造请求:请求URI

请求URI 请求URI由如下部分组成。 {URI-scheme} :// {Endpoint} / {resource-path} ? {query-string} 表1 请求URI 参数说明 URI-scheme 传输请求的协议，当前所有API均采用HTTPS协议。 Endpoint 承载REST服务端点的服务器域名或IP，不同服务在不同区域时，对应Endpoint不同，可以从终端节点中获取。例如视频智能分析服务在“华北-北京一”区域的Endpoint为“iam.cn-north-1.myhuaweicloud.com”。 resource-path 资源路径，即API访问路径。从具体API的URI模块获取，例如“获取用户Token”API的resource-path为“/v3/auth/tokens”。 query-string 查询参数，可选，查询参数前面需要带一个“？”，形式为“参数名=参数取值”，例如“limit=10”，表示查询不超过10条数据。例如您需要获取“华北-北京一”区域的Token，则需使用“华北-北京一”区域的Endpoint（iam.cn-north-1.myhuaweicloud.com），并在获取用户Token的URI部分找到resource-path（/v3/auth/tokens），拼接起来如下所示。 https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens 图1 URI示意图为查看方便，服务每个具体API的URI，只给出resource-path部分，并将请求方法写在一起。这是因为URI-scheme都是HTTPS，而Endpoint在同一个区域也相同，所以简洁起见将这两部分省略。

视频智能分析服务 VIAS

视频智能分析服务 VIAS-构造请求:请求方法

请求方法 HTTP请求方法（也称为操作或动词），它告诉服务你正在请求什么类型的操作。表2 HTTP方法方法说明 GET 请求服务器返回指定资源。 PUT 请求服务器更新指定资源。 POST 请求服务器新增资源或执行特殊操作。 DELETE 请求服务器删除指定资源，如删除对象等。 HEAD 请求服务器资源头部。 PATCH 请求服务器更新资源的部分内容。当资源不存在的时候，PATCH可能会去创建一个新的资源。在获取用户Token的URI部分，您可以看到其请求方法为“POST”，则其请求为： POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens

视频智能分析服务 VIAS

视频智能分析服务 VIAS-终端节点

终端节点终端节点（Endpoint）即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询所有服务的终端节点。视频智能分析服务的终端节点如表1所示，请您根据业务需要选择对应区域的终端节点。表1 视频智能分析Endpoint 区域名称区域终端节点（Endpoint）协议类型华北-北京四 cn-north-4 vias.cn-north-4.myhuaweicloud.com HTTPS vias.cn-north-4.myhuaweicloud.cn HTTPS 华南-广州 cn-south-1 vias.cn-south-1.myhuaweicloud.com HTTPS vias.cn-south-1.myhuaweicloud.cn HTTPS 父主题：使用前必读

视频智能分析服务 VIAS 使用前必读

视频智能分析服务 VIAS-认证鉴权:AK/SK认证

AK/SK认证 AK/SK签名认证方式仅支持消息体大小12MB以内，12MB以上的请求请使用Token认证。 AK/SK认证就是使用AK/SK对请求进行签名，在请求时将签名信息添加到消息头，从而通过身份认证。 AK(Access Key ID)：访问密钥ID。与私有访问密钥关联的唯一标识符；访问密钥ID和私有访问密钥一起使用，对请求进行加密签名。 SK(Secret Access Key)：与访问密钥ID结合使用的密钥，对请求进行加密签名，可标识发送方，并防止请求被修改。使用AK/SK认证时，您可以基于签名算法使用AK/SK对请求进行签名，也可以使用专门的签名SDK对请求进行签名。详细的签名方法和SDK使用方法请参见API签名指南。签名SDK只提供签名功能，与服务提供的SDK不同，使用时请注意。

视频智能分析服务 VIAS 如何调用API

视频智能分析服务 VIAS-认证鉴权:Token认证

Token认证 Token的有效期为24小时，需要使用同一个Token鉴权时，可以缓存起来，避免频繁调用。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限。 Token可通过调用获取用户Token接口获取，调用本服务API需要project级别的Token，即调用获取用户Token接口时，请求body中“auth.scope”的取值需要选择“project”，请求示例如下。 { "auth": { "identity": { "methods": ["password"], "password": { "user": { "name": "username", //替换为实际用户名 "password": "**********",//替换为实际的用户密码 "domain": { "name": "domianname" //替换为实际账号名 } } } }, "scope": { "project": { "name": "cn-north-1 " //替换为实际的project name，获取作用范围为指定project的Token } } } } 获取Token 后，再调用其他接口时，您需要在请求消息头中添加“X-Auth-Token”，其值即为获取到的Token。例如Token值为“ABCDEFJ....”，则调用接口时将“X-Auth-Token: ABCDEFJ....”加到请求消息头即可，如下所示。 GET https://iam.cn-north-1.myhuaweicloud.com/v3/auth/projects Content-Type: application/json X-Auth-Token: ABCDEFJ....

视频智能分析服务 VIAS 如何调用API

视频智能分析服务 VIAS-修改任务:请求示例

请求示例任务修改接口，用于修改任务配置(支持修改任务名称，视频源，调度模式，输出配置) /v2/{project_id}/tasks/{task_id} { "name" : "TestA", "input" : { "type" : "video_source", "data" : [ { "video_source_id" : "xxxxxxx-xxxxxxx-xxxxxxx-xxxxx-xxxxxx" } ] }, "output" : { "webhook" : { "url" : "http://test", "headers" : { "a" : "a" } } }, "config" : { "common" : { } }, "priority" : "low", "service_version" : "1.1", "manufacturer" : "VIAS", "is_saved_as_template" : false }

视频智能分析服务 VIAS 任务中心

视频智能分析服务 VIAS-修改任务:响应参数

响应参数状态码： 400 表14 响应Body参数参数参数类型描述 error_code String 错误码 error_msg String 错误信息描述 detail String 错误详情 params Array of strings 错误参数列举 reason String 错误原因 advice String 建议状态码： 500 表15 响应Body参数参数参数类型描述 error_code String 错误码 error_msg String 错误信息描述 detail String 错误详情 params Array of strings 错误参数列举 reason String 错误原因 advice String 建议

视频智能分析服务 VIAS 任务中心

视频智能分析服务 VIAS-视频智能分析服务概述

视频智能分析服务概述视频智能分析服务（VIAS），是提供AI智能分析、预警事件上报、边缘资源池纳管等多项能力的一体化平台，依托于华为云人工智能和大数据的技术优势，实现智慧园区、城市治理、智慧水务、智慧交通等场景的事件感知、分析和决策能力，助力业务闭环。具体包含了入侵检测、高密度人群、戴口罩检测、工服工帽检测、烟火检测、打架检测、共享单车检测等多种视频AI算法，为用户提供快捷高效的视频分析能力。您可以在视频智能分析服务的管理控制台中使用服务。首次进入时您需要同意授权，同意授权后进入总览页。图1 VIAS授权页面购买算法服务包后，单击“进入首页”，首页展示了视频智能分析服务包含的五个模块，如图2所示。本文档分别介绍了视频中心、算法中心、任务中心、事件中心、运维中心的功能及使用。图2 视频智能分析服务首页

视频智能分析服务 VIAS

视频智能分析服务 VIAS-事件规则

事件规则事件规则，即展示事件的规则。在事件中心页面，事件列表上方单击“事件规则”。图1 事件列表进入“事件规则”页面，可开启人工审核或事件重复聚合。图2 事件规则人工审核。如果开启，所有的事件都不会通过订阅的方式推送给用户，只有通过审核之后才会推送，如果关闭，则默认将所有的事件推送给用户。事件重复聚合。开启事件重复聚合之后，需要设置事件聚合的时间（取值范围：1-1440）。即在这段时间产生的所有事件，都会聚合展示（将第一个事件作为主事件展示在事件列表里面，其余的事件作为从事件，展示在事件详情页），如果关闭此开关则将接下来所有的事件作为主事件展示在事件列表。单击“确认”。父主题：事件中心

视频智能分析服务 VIAS

视频智能分析服务 VIAS-准备结果输出通道:运行Webhook Service

运行Webhook Service 视频智能分析服务作业的结果输出类型选择为Webhook时，在创建作业前，需确保Webhook Service已运行成功。下面以一个简单的python脚本作为示例，展示如何启动Webhook Service并保存接收的数据。准备一台本地的Linux服务器，确保Linux服务器和边缘节点服务器网络通畅，并已安装python环境。使用ifconfig命令在Linux服务器上查询服务器IP地址。修改脚本第18行，填入Linux服务器IP地址。图1 示例脚本post.py import jsonfrom wsgiref.simple_server import make_serverdef application(environ, start_response): start_response('200 OK', [('Content-Type', 'application/json')]) request_body = environ["wsgi.input"].read(int(environ.get("CONTENT_LENGTH", 0))) f=open('./post.txt','a') f.write(request_body) f.write("\n") f.close() return ("200 success\n")if __name__ == "__main__": port = 6006 httpd = make_server("10.10.10.1", port, application) print "serving http on port {0}...".format(str(port)) httpd.serve_forever() 脚本中的端口6006可以根据用户实际需要修改。创建作业时，算法输出Webhook URL设置为：http://${IP}:${port}。例如：http://10.10.10.1:6006。执行脚本，启动Webhook Service。 python post.py 图2 执行脚本成功

视频智能分析服务 VIAS

视频智能分析服务 VIAS-配置ROI

配置ROI ROI即Region of Interest，表示算法的检测区域。部分算法要求必须填入表示检测区域的JSON格式的字符串，例如：{"polygons":[{"data":[[84,389],[1840,349],[1824,526],[78,526]]}]}，其中[84,389]这类结构表示的是横纵坐标，{"data":[...]}表示由这些坐标点连线构成的一个图形，"polygons":[...]}表示复数个{"data":[...]}图形都为多边形区域。示例的整个字符串表示由这四个坐标点构成的多边形区域。同理{"lines":[{"data":[[238,481],[1309,481]]}]}表示由两个坐标点构成的线段。除了直接填入表示区域的字符串外还可直接通过手工绘制的方式配置ROI，平台将根据绘制的结果自动生成对应的表示区域的JSON格式字符串。配置ROI 绘画直线段时，单击，在图中画出期望的直线段。图1 绘画直线段绘画多边形时，单击，在图中画出期望的检测区域，最后一条线段不需要绘画，双击鼠标表示绘画多边形结束，区域将自动闭合。图2 绘画多边形绘画多边形区域时，线段不能交叉。可在图中绘画多个多边形区域。可以在绘制区域按钮中自定义名称和颜色。保存ROI模板绘制好需要的ROI之后，输入ROI名称，单击保存，将所绘的ROI保存到模板中。图3 保存ROI模板选择ROI模板单击选中需要的ROI模板，则可在当前任务中使用。图4 ROI模板除了在新建任务过程中可以增加ROI模板外，也可以单击视频源详情进行ROI模板的绘制。图5 ROI管理父主题：参考信息

视频智能分析服务 VIAS

视频智能分析服务 VIAS-管理批量任务:查看批量任务详情

查看批量任务详情在“批量任务”页面可查看所有批量任务的算法、分组名称、任务数量、状态这些基本信息。若需要展示指定批量任务，可通过批量名称或算法服务名称进行模糊查询，或者通过算法服务、分组名称、任务状态和厂商进行精确的下拉筛选，最后可选择按照任务数量或创建时间进行升序或降序的排序。批量任务更详情的信息可单击批量任务的名称进行查看。除了基本信息外，详情页会展示当前批量任务下关联的视频分析任务列表。关联的任务列表支持对任务筛选、启动以及查看单条任务的详情。

视频智能分析服务 VIAS 批量任务

视频智能分析服务 VIAS-事件概述:事件详情

事件详情在事件中心模块的“事件列表”页面可查看所有事件的视频源名称、告警事件时间、事件聚合数、告警画面，审核状态等这些基本信息。若需要展示指定的事件，可通过事件名称或视频源名称进行模糊查询，或者通过审核状态进行精确的下拉筛选，最后可选择告警事件时间进行升序或降序的排序。单击具体事件名称，进入事件详情页面，查看事件的详细信息。事件详情页面支持用户查看主事件的基本信息，如视频源名称，状态，标签，分组，位置，创建时间以及流地址等。也展示了从事件列表，支持从列表的分页查询，以及查看事件画面，删除，审核状态，驳回以及对它们的批量审核/删除等操作。

视频智能分析服务 VIAS

云服务器内容精选

视频智能分析服务 VIAS

7*24

备案

专业服务

退订

建议反馈

售前咨询热线