华为云用户手册

响应示例 状态码： 400 请求不合法 { "error_code" : "IVA.0004", "error_msg" : "The request param is invalid. parameter [task_id] does not match ^[0-9a-f]{32}|task\\w{8}$."} 状态码： 404 指定的服务不存在 { "error_code" : "IVA.0005", "error_msg" : "The requested resource is NOT found. Service face-detect not found."}

URI POST /v2/{project_id}/services/{service_name}/tasks/{task_id}/start 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 用户项目ID。获取方法请参见获取项目ID/帐号名/AK/SK。 service_name 是 String 服务名称。 task_id 是 String 指定的服务作业ID。

系统级约束限制 支持扩展名为avi、wmv、mpg、mpeg、mp4、mov、m4v、mkv的视频文件。 不支持OBS桶上经过KMS加密后的视频。 单个视频大小不能超过4GB。 支持常见的帧率（fps）：23.97、24、25、29.97、30、50、60。 支持H.264、H.265、MPEG2、MPEG4、VC1、VP8、VP9编码格式视频的GPU解码。 编码格式 最大分辨率 MPEG2 1920*1080 MPEG4 1920*1080 VC1 2048*1024 H.264 1920*1080 H.265 1920*1080 VP8 1920*1080 VP9 1920*1080

API概览 视频分析服务提供了RESTful API，支持您通过HTTPS请求调用，您可以使用的功能如表1所示。 表1 视频分析服务API 服务 功能 API 说明 视频分析服务 服务作业管理 创建作业 创建所选视频分析服务的作业 获取作业列表 查询所选视频分析服务的作业列表 获取作业详情 查询所选视频分析服务的指定作业的详情 更新作业 更新所选视频分析服务的指定作业 删除作业 删除所选视频分析服务的指定作业 启动作业 启动所选视频分析服务的指定作业 停止作业 停止所选视频分析服务的指定作业

公测功能的开通步骤 登录华为云的视频分析服务控制台。 选择“服务”，会看到功能列表。 如果您是首次进入视觉服务界面，需要您进行公测申请，公测审批当前是人工审批，一般需要等待1～2天，如遇节假日顺延。 根据业务需求，选择待开通的功能（例如：视频OCR），单击操作列的“申请公测”。 功能的公测申请无需审批，可实时开通。 服务功能的操作列显示“创建作业”时表示开通成功。 服务功能只需开通一次即可，后续使用无需再申请。

URI POST /v2/{project_id}/services/{service_name}/tasks/{task_id}/stop 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 用户项目ID。获取方法请参见获取项目ID/帐号名/AK/SK。 service_name 是 String 服务名称。 task_id 是 String 指定的服务作业ID。

响应示例 状态码： 400 请求不合法 { "error_code" : "IVA.0004", "error_msg" : "The request param is invalid. parameter [task_id] does not match ^[0-9a-f]{32}|task\\w{8}$."} 状态码： 404 指定的服务不存在 { "error_code" : "IVA.0005", "error_msg" : "The requested resource is NOT found. Service face-detect not found."}

定时策略参数 表1 timing 请求参数结构 参数 是否必选 参数类型 描述 type 是 String 计划任务的类型，使用计划任务时必填。可选类型分别为once（仅执行一次），daily（每日执行），weekly（每周执行），monthly（每月执行）。 枚举值： once daily weekly monthly timezone 是 String 用户所处的时区，使用计划任务时必填。精确到分钟。 days_of_week 否 Array of integers 作业会在一周的哪几天执行，当且仅当计划任务类型为weekly时，该字段需填且必填。1~7分别指代星期一至星期日。 最小值：1 最大值：7 days_of_month 否 Array of integers 作业会在一个月的哪几天执行，当且仅当计划任务类型为monthly时，该字段需填且必填。1~31分别指代一个月中的1日至31日。 最小值：1 最大值：31 date 否 String 作业的执行日。当且仅当计划任务类型为once且为频率模式时，该字段需填且必填。格式形如yyyy-MM-dd。 periods 否 Array of periods objects 时间段模式配置。和frequency字段二选一，不可共存。时间段模式下，至少需指定一个时间段。 frequency 否 frequency object 频率模式配置。和periods字段二选一，不可共存。 表2 timing periods 请求参数结构 参数 是否必选 参数类型 描述 begin_at 否 String 单个时间段执行的起始时间，和end_at需成对出现。计划任务类型为once时，格式为yyyy-MM-ddThh:mm:ss，其余计划任务类型时，格式为hh:mm:ss。 end_at 否 String 单个时间段执行的结束时间，和begin_at需成对出现。计划任务类型为once时，格式为yyyy-MM-ddThh:mm:ss，其余计划任务类型时，格式为hh:mm:ss。 表3 timing frequency 请求参数结构 参数 是否必选 参数类型 描述 interval 是 Integer 相邻两次执行之间的间隔，频率模式必填。取值范围在5~720之间，单位：分钟。 最小值：5 最大值：720 duration 是 Integer 单次执行的运行时长，频率模式必填。取值范围在5~720之间，单位：分钟。 最小值：5 最大值：720 begin_at 否 String 单日内执行的起始时间，选填。格式形如hh:mm:ss。 end_at 否 String 单日内执行的结束时间，选填。格式形如hh:mm:ss。 父主题： 作业请求参数

响应示例 状态码： 200 获取服务作业列表成功 { "count" : 1, "tasks" : [ { "id" : "53e4xxxxxxxxxxxxxxxxxxxxxxb55b3e", "name" : "task-test", "creator" : "user_test", "project_id" : "b722xxxxxxxxxxxxxxxxxxxxxxeb4674", "description" : "hello world", "service_name" : "face-detect", "service_version" : "1.0", "service_title" : { "en" : "Face Detect", "zh" : "人脸检测" }, "edge_pool_id" : "549cxxxxxxxxxxxxxxxxxxxxxx77a2a5", "created_at" : "2021-01-01T00:00:00Z", "updated_at" : "2021-01-01T00:00:10Z", "state" : "RUNNING", "input" : { "type" : "edgecamera", "data" : [ { "id" : "dd8xxxxx-xxxx-xxxx-xxxx-xxxxxx2f5bcb" } ] }, "output" : { "dis" : { "stream_name" : "dis-test" } }, "service_config" : { "common" : { "image_compression_ratio" : 90, "render_result_sw" : 0, "video_sampling_interval" : 1 } } } ]} 状态码： 400 请求不合法 { "error_code" : "IVA.0004", "error_msg" : "The request param is invalid. The param [state] should be one of [PENDING, RECOVERING, STARTING, UPGRADING, CREATE_FAILED, START_FAILED, RUNNING, STOPPING, STOPPED, ABNORMAL, SUCCEEDED, FAILED, DELETING, FREEZING, FROZEN]"} 状态码： 404 指定的服务不存在 { "error_code" : "IVA.0005", "error_msg" : "The requested resource is NOT found. Service face-detect not found."}

URI GET /v2/{project_id}/services/{service_name}/tasks 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 用户项目ID。获取方法请参见获取项目ID/帐号名/AK/SK。 service_name 是 String 服务名称。 表2 Query参数 参数 是否必选 参数类型 描述 service_version 否 String 目标服务作业对应的服务版本号。 state 否 String 目标服务作业的状态，分别为PENDING（等待中），RECOVERING（恢复中），STARTING（启动中），UPGRADING（升级中），CREATE_FAILED（创建失败），START_FAILED（启动失败），RUNNING（运行中），STOPPING（停止中），STOPPED（已停止），ABNORMAL（异常），SUCCEEDED（运行成功），FAILED（运行失败），DELETING（删除中），FREEZING（冻结中），FROZEN（已冻结） 枚举值： PENDING RECOVERING STARTING UPGRADING CREATE_FAILED START_FAILED RUNNING STOPPING STOPPED ABNORMAL SUCCEEDED FAILED DELETING FREEZING FROZEN name_like 否 String 目标服务作业的名称，支持模糊匹配。 id_like 否 String 目标服务作业的ID，支持模糊匹配。 created_since 否 Long 目标服务作业的创建起始时间。 最小值：0 最大值：9223372036854775807 created_until 否 Long 目标服务作业的创建截止时间。 最小值：0 最大值：9223372036854775807 order 否 String 展示服务作业时的排序字段和顺序，分别为name:ASC（按名称顺序排序），name:DESC（按名称倒序排序），created_at:ASC（按创建时间正序排序），created_at:DESC（按创建时间倒序排序），updated_at:ASC（按更新时间正序排序），updated_at:DESC（按更新时间倒序排序） 缺省值：created_at:DESC 枚举值： name:ASC name:DESC created_at:ASC created_at:DESC updated_at:ASC updated_at:DESC offset 否 Integer 首个展示的服务作业的偏移量，需和limit搭配使用。 最小值：0 最大值：100000 缺省值：0 limit 否 Integer 展示服务作业的数量，需和offset搭配使用。 最小值：1 最大值：1000 缺省值：100

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 count Long 符合检索条件的总条目数。 最小值：0 最大值：9223372036854775807 tasks Array of TaskDetails objects 检索到的服务作业条目。 表4 单条作业信息响应参数结构 参数 参数类型 描述 id String 作业ID。 name String 作业的名称。 creator String 作业创建者的用户名。 project_id String 作业创建者的项目ID。 description String 作业的描述。 最小长度：0 最大长度：500 service_name String 作业对应服务的名称。 最小长度：2 最大长度：100 service_version String 作业对应服务的版本号。 service_title service_title object 作业对应服务的标题。 edge_pool_id String 仅边缘作业会出现，作业运行所在的边缘运行池ID。 resource_order_id String 作业指定的算法能力包包周期订单ID。 created_at String 作业创建的时间。 updated_at String 作业最近一次状态更新的时间。 state String 作业当前的状态，分别为PENDING（等待中），RECOVERING（恢复中），STARTING（启动中），UPGRADING（升级中），CREATE_FAILED（创建失败），START_FAILED（启动失败），RUNNING（运行中），STOPPING（停止中），STOPPED（已停止），ABNORMAL（异常），SUCCEEDED（运行成功），FAILED（运行失败），DELETING（删除中），FREEZING（冻结中），FROZEN（已冻结） 枚举值： PENDING RECOVERING STARTING UPGRADING CREATE_FAILED START_FAILED RUNNING STOPPING STOPPED ABNORMAL SUCCEEDED FAILED DELETING FREEZING FROZEN status String 作业状态的详情信息，仅部分状态会有详情信息。 最小长度：0 最大长度：4096 error error object 作业运行失败时收集到的错误信息。 timing_status String 计划任务的状态，分别为ACTIVATED（激活），INACTIVATED（未激活） 枚举值： ACTIVATED INACTIVATED timing TaskTiming object 计划任务的配置项，选填。计划任务不支持obs输入，对于url输入则仅支持rtmp和rtsp两种形式。 input TaskInput object 作业的输入配置，必填。 output TaskOutputForDisplay object 作业的输出配置展示。 service_config TaskServiceConfig object 作业运行时指定的算法配置参数，部分服务需填且必填。 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_code String 服务内部错误码。 error_msg String 错误信息。 状态码： 404 表6 响应Body参数 参数 参数类型 描述 error_code String 服务内部错误码。 error_msg String 错误信息。

响应消息体 响应消息体通常以结构化格式返回，与响应消息头中Content-type对应，传递除响应消息头之外的内容。 对于获取用户Token接口，返回如下消息体。为篇幅起见，这里只展示部分内容。 { "token": { "expires_at": "2019-02-13T06:52:13.855000Z", "methods": [ "password" ], "catalog": [ { "endpoints": [ { "region_id": "cn-north-4",...... 当接口调用出错时，会返回错误码及错误信息说明，错误响应的Body体格式如下所示。 { "error_msg" : "The request param is invalid.", "error_code": "IVA.0001"} 其中，error_code表示错误码，error_message表示错误描述信息，具体请参见错误码。

响应消息头 对应请求消息头，响应同样也有消息头，如“Content-type”。 表1 公共响应消息头 消息头名称 说明 是否必选 Content-Type 用于指明发送给接收者的实体正文的媒体类型。 类型：字符串。 默认值：application/json; charset=UTF-8 是 X-request-id 此字段携带请求ID号，以便任务跟踪。 类型：字符串。request_id-timestamp-hostname（request_id在服务器端生成UUID， timestamp为当前时间戳，hostname为处理当前接口的服务器名称）。 默认值：无。 否 X-ratelimit 此字段携带总计流控请求数。 类型：整型。 默认值：无。 否 X-ratelimit-used 此字段携带剩下请求数。 类型：整型。 默认值：无。 否 X-ratelimit-window 此字段携带流控单位。 类型：字符串。单位按照分钟、小时、天。 默认值：小时。 否 对于获取用户Token接口，返回如图1所示的消息头。 其中“x-subject-token”就是需要获取的用户Token。有了Token之后，您就可以使用Token认证调用其他API。 图1 获取用户Token响应消息头

输入参数 表1 input 请求参数结构 参数 是否必选 参数类型 描述 type 是 String 作业的输入类型，必填。可选类型有obs（ 对象存储服务 存储的文件），vis（ 视频接入服务 的视频流），url（指定的文件地址或取流地址），edgecamera（绑定在IEF的边缘摄像头），edgerestful（从自定义的流媒体服务器通过Restful接口获取取流地址），vcn（VCN设备）。 枚举值： obs vis url edgecamera edgerestful vcn data 是 Array of TaskInputData objects 作业的输入详情，必填。针对不同的输入类型有不同的配置。创建时允许填写多路输入，但更新时只允许填写一路输入。 vcn 否 TaskInputVcn object VCN服务器信息，仅输入类型为vcn时需填且必填。 表2 input data 请求参数结构 参数 是否必选 参数类型 描述 stream_name 否 String VIS的视频流名称，当输入为vis类型时必填。 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 node_id 否 String IEF节点的ID，仅部分服务在输入类型为edgerestful或vcn时需填且必填。 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 表3 input vcn 请求参数结构 参数 是否必选 参数类型 描述 ip 是 String VCN服务器的IP地址，仅输入类型为vcn时需填且必填。 port 是 Integer VCN服务器的端口号，仅输入类型为vcn时需填且必填。 最小值：0 最大值：65535 username 是 String VCN服务器的帐号名，仅输入类型为vcn时需填且必填。 password 是 String VCN服务器的与帐号对应的密码，仅输入类型为vcn时需填且必填。 父主题： 作业请求参数

终端节点 终端节点（Endpoint）即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询所有服务的终端节点。 视频分析服务的终端节点如表1所示，请您根据业务需要选择对应区域的终端节点。 表1 视频分析服务Endpoint 区域名称 区域 终端节点（Endpoint） 协议类型 华北-北京一 cn-north-1 iva.cn-north-1.myhuaweicloud.com HTTPS 华北-北京四 cn-north-4 iva.cn-north-4.myhuaweicloud.com HTTPS 亚太-曼谷 ap-southeast-2 iva.ap-southeast-2.myhuaweicloud.com HTTPS 华东-上海二 cn-east-2 iva.cn-east-2.myhuaweicloud.com HTTPS 华东-上海一 cn-east-3 iva.cn-east-3.myhuaweicloud.com HTTPS 华南-广州 cn-south-1 iva.cn-south-1.myhuaweicloud.com HTTPS 中国-香港 ap-southeast-1 iva.ap-southeast-1.myhuaweicloud.com HTTPS 亚太-新加坡 ap-southeast-3 iva.ap-southeast-3.myhuaweicloud.com HTTPS 父主题： 使用前必读

输出参数 表1 output 请求参数结构 参数 是否必选 参数类型 描述 obs 否 TaskOutputObs object 输出为obs类型时的配置信息 dis 否 TaskOutputDis object 输出为dis类型时的配置信息 webhook 否 TaskOutputWebhook object 输出为webhook类型时的配置信息 hosting 否 TaskOutputHosting object 输出为hosting类型时的配置信息 localpath 否 TaskOutputLocalpath object 输出为localpath类型时的配置信息 表2 output obs 请求参数结构 参数 是否必选 参数类型 描述 bucket 是 String OBS桶名，选用obs类型输出时必填。 最大长度：63 path 是 String OBS的路径，选用obs类型输出时必填。 最大长度：1023 data_category 否 Array of strings 作业输出数据类别的列表，选填，仅部分服务需要。当输出类型下有这个列表时，表示希望这个输出类型下存放dataCategory列表内的数据。 表3 output dis 请求参数结构 参数 是否必选 参数类型 描述 stream_name 是 String DIS流名称，选用dis类型输出时必填。 最大长度：64 data_category 否 Array of strings 作业输出数据类别的列表，选填，仅部分服务需要。当输出类型下有这个列表时，表示希望这个输出类型下存放dataCategory列表内的数据。 表4 output webhook 请求参数结构 参数 是否必选 参数类型 描述 url 是 String 结果回调地址，选用webhook类型输出时必填。 最大长度：1000 headers 是 Object 结果回调时需要携带的请求头，选用webhook类型输出时必填。整体呈json格式，以键值对的形式表示请求头和取值，至少1组，至多10组。 data_category 否 Array of strings 作业输出数据类别的列表，选填，仅部分服务需要。当输出类型下有这个列表时，表示希望这个输出类型下存放dataCategory列表内的数据。 表5 output hosting 请求参数结构 参数 是否必选 参数类型 描述 data_category 否 Array of strings 作业输出数据类别的列表，选填，仅部分服务需要。当输出类型下有这个列表时，表示希望这个输出类型下存放dataCategory列表内的数据。 表6 output localpath 请求参数结构 参数 是否必选 参数类型 描述 mount_source_path 是 String 挂载的源路径，存放作业运行结果的路径，选用localpath类型输出时必填。必须为linux路径，且为选用的边缘运行池挂载路径的子路径，长度不超过255。 最大长度：255 data_category 否 Array of strings 作业输出数据类别的列表，选填，仅部分服务需要。当输出类型下有这个列表时，表示希望这个输出类型下存放dataCategory列表内的数据。 父主题： 作业请求参数

响应示例 状态码： 200 更新服务作业信息成功 { "id" : "53e4xxxxxxxxxxxxxxxxxxxxxxb55b3e", "name" : "task-test", "creator" : "user_test", "project_id" : "b722xxxxxxxxxxxxxxxxxxxxxxeb4674", "description" : "hello world", "service_name" : "face-detect", "service_version" : "1.0", "service_title" : { "en" : "Face Detect", "zh" : "人脸检测" }, "edge_pool_id" : "549cxxxxxxxxxxxxxxxxxxxxxx77a2a5", "created_at" : "2021-01-01T00:00:00Z", "updated_at" : "2021-01-01T00:00:10Z", "state" : "RUNNING", "input" : { "type" : "edgecamera", "data" : [ { "id" : "dd8xxxxx-xxxx-xxxx-xxxx-xxxxxx2f5bcb" } ] }, "output" : { "dis" : { "stream_name" : "dis-test" } }, "service_config" : { "common" : { "image_compression_ratio" : 90, "render_result_sw" : 0, "video_sampling_interval" : 1 } }} 状态码： 400 请求不合法 { "error_code" : "IVA.0004", "error_msg" : "The request param is invalid. parameter [task_id] does not match ^[0-9a-f]{32}|task\\w{8}$."} 状态码： 404 指定的服务不存在 { "error_code" : "IVA.0005", "error_msg" : "The requested resource is NOT found. Service face-detect not found."}

请求示例 更新指定边缘服务作业的摄像头ID。 PUT /v2/b722xxxxxxxxxxxxxxxxxxxxxxeb4674/services/face-detect/tasks/53e4xxxxxxxxxxxxxxxxxxxxxxb55b3e{ "input" : { "type" : "edgecamera", "data" : [ { "id" : "379fxxxx-xxxx-xxxx-xxxx-xxxxxxf1a186" } ] }}

请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 name 否 String 作业的名称，必填。仅能包含汉字、字母、数字、中划线和下划线，长度介于1~100之间。 description 否 String 作业的描述，选填。长度不超过500。 最小长度：0 最大长度：500 timing 否 TaskTiming object 计划任务的配置项，选填。计划任务不支持obs输入，对于url输入则仅支持rtmp和rtsp两种形式。 input 否 TaskInput object 作业的输入配置，必填。 output 否 TaskOutput object 作业的输出配置，至少需要配置一项输出方式。 service_config 否 TaskServiceConfig object 作业运行时指定的算法配置参数，部分服务需填且必填。

URI PUT /v2/{project_id}/services/{service_name}/tasks/{task_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 用户项目ID。获取方法请参见获取项目ID/帐号名/AK/SK。 service_name 是 String 所选视频分析服务名称。 task_id 是 String 指定的作业ID。

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 id String 作业ID。 name String 作业的名称。 creator String 作业创建者的用户名。 project_id String 作业创建者的项目ID。 description String 作业的描述。 最小长度：0 最大长度：500 service_name String 作业对应服务的名称。 最小长度：2 最大长度：100 service_version String 作业对应服务的版本号。 service_title service_title object 作业对应服务的标题。 edge_pool_id String 仅边缘作业会出现，作业运行所在的边缘运行池ID。 resource_order_id String 作业指定的算法能力包包周期订单ID。 created_at String 作业创建的时间。 updated_at String 作业最近一次状态更新的时间。 state String 作业当前的状态，分别为PENDING（等待中），RECOVERING（恢复中），STARTING（启动中），UPGRADING（升级中），CREATE_FAILED（创建失败），START_FAILED（启动失败），RUNNING（运行中），STOPPING（停止中），STOPPED（已停止），ABNORMAL（异常），SUCCEEDED（运行成功），FAILED（运行失败），DELETING（删除中），FREEZING（冻结中），FROZEN（已冻结） 枚举值： PENDING RECOVERING STARTING UPGRADING CREATE_FAILED START_FAILED RUNNING STOPPING STOPPED ABNORMAL SUCCEEDED FAILED DELETING FREEZING FROZEN status String 作业状态的详情信息，仅部分状态会有详情信息。 最小长度：0 最大长度：4096 error error object 作业运行失败时收集到的错误信息。 timing_status String 计划任务的状态，分别为ACTIVATED（激活），INACTIVATED（未激活）。 枚举值： ACTIVATED INACTIVATED timing TaskTiming object 计划任务的配置项，选填。计划任务不支持obs输入，对于url输入则仅支持rtmp和rtsp两种形式。 input TaskInput object 作业的输入配置，必填。 output TaskOutputForDisplay object 作业的输出配置展示。 service_config TaskServiceConfig object 作业运行时指定的算法配置参数，部分服务需填且必填。 状态码： 400 表4 响应Body参数 参数 参数类型 描述 error_code String 服务内部错误码。 error_msg String 错误信息。 状态码： 404 表5 响应Body参数 参数 参数类型 描述 error_code String 服务内部错误码。 error_msg String 错误信息。

调用API获取项目ID 项目ID还可通过调用查询指定条件下的项目信息API获取。 获取项目ID的接口为“GET https://{Endpoint}/v3/projects”，其中{Endpoint}为 IAM 的终端节点，可以从地区和终端节点获取。接口的认证鉴权请参见认证鉴权。 响应示例如下，其中projects下的“id”即为项目ID。 { "projects": [ { "domain_id": "65382450e8f64ac0870cd180d14e684b", "is_domain": false, "parent_id": "65382450e8f64ac0870cd180d14e684b", "name": "project_name", "description": "", "links": { "next": null, "previous": null, "self": "https://www.example.com/v3/projects/a4a5d4098fb4474fa22cd05f897d6b99" }, "id": "a4a5d4098fb4474fa22cd05f897d6b99", "enabled": true } ], "links": { "next": null, "previous": null, "self": "https://www.example.com/v3/projects" } }

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不同，使用时请注意。

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": "domainname"}}}},"scope": {"project": {"name": "xxxxxxxx"}}}} 获取Token 后，再调用其他接口时，您需要在请求消息头中添加“X-Auth-Token”，其值即为Token。例如Token值为“ABCDEFJ....”，则调用接口时将“X-Auth-Token: ABCDEFJ....”加到请求消息头即可，如下所示。 GET https://iam.cn-north-4.myhuaweicloud.com/v3/auth/projects Content-Type: application/json X-Auth-Token: ABCDEFJ.... 您还可以通过这个视频教程了解如何使用Token认证 。

输入参数 表1 input 响应参数结构 参数 参数类型 描述 type String 作业的输入类型，必填。可选类型有obs（对象存储服务存储的文件），vis（ 视频接入 服务的视频流），url（指定的文件地址或取流地址），edgecamera（绑定在IEF的边缘摄像头），edgerestful（从自定义的流媒体服务器通过Restful接口获取取流地址），vcn（VCN设备）。 枚举值： obs vis url edgecamera edgerestful vcn data Array of TaskInputData objects 作业的输入详情，必填。针对不同的输入类型有不同的配置。创建时允许填写多路输入，但更新时只允许填写一路输入。 vcn TaskInputVcn object VCN服务器信息，仅输入类型为vcn时需填且必填。 表2 input data 响应参数结构 参数 参数类型 描述 stream_name String VIS的视频流名称，当输入为vis类型时必填。 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 node_id String IEF节点的ID，仅部分服务在输入类型为edgerestful或vcn时需填且必填。 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 表3 input vcn 响应参数结构 参数 参数类型 描述 ip String VCN服务器的IP地址，仅输入类型为vcn时需填且必填。 port Integer VCN服务器的端口号，仅输入类型为vcn时需填且必填。 最小值：0 最大值：65535 username String VCN服务器的帐号名，仅输入类型为vcn时需填且必填。 password String VCN服务器的与帐号对应的密码，仅输入类型为vcn时需填且必填。 父主题： 作业响应参数

约束与限制 无商标申请经验的用户，请慎重选择商标智能注册产品。如您没有商标注册经验，推荐您选择商标顾问注册或者商标无忧注册申请，由专业人员辅助进行注册。 商标注册申请存在被驳回风险，建议您在注册商标之前先进商标检索并了解商标审核相关规定。避免与已注册成功的商标、商标法、商标局审查规则产生冲突，商标检索详情请参见商标检索。 华为云商标检索的数据及结果仅供参考，不具备法律效力，不作为商标注册成功与否的依据。商标检索结果请参考商标网的查询结果。 营业执照经营范围含有商标代理、知识产权服务，商标申请仅支持申请类别为第45类4506组商标。如需申请注册其他类商标，请先变更营业执照经营范围。 华为云商标注册服务目前仅支持普通商标注册申请服务，暂不支持证明商标、集体商标、肖像商标、声音商标和立体商标申请服务。

华为云 商标服务 项目分类 表1 商标服务项目分类 服务项目 服务说明 商标智能注册 商标智能注册是针对具有一定商标注册申请经验的申请人提供的产品，提供免费商标检索工具，通过简化冗余流程、预设注册方案及委托书模板化等优化服务，使 商标注册申请流程 更便捷、更高效。 商标顾问注册 商标顾问注册是由专业顾问全流程一对一为商标申请人提供综合评估、定制专属注册方案等服务，适用于对风险评估、类别选择无经验的用户。 商标无忧注册 商标无忧注册是由资深专家全流程一对一为商标申请人提供商标检索分析、量身制定注册方案、多重审核、提交注册申请以及商标使用建议等服务，适用于担心商标注册被全部驳回的用户，申请注册商标低风险更安心，退款有保障。 商标续展注册 商标续展注册是帮助商标注册人申请延长注册商标有效期限提供的服务，助力企业快速续展商标以保护品牌权益。

商标顾问注册计费说明 商标顾问注册为668元/类（每类包含10个小项），您可选择多类和多个服务项目，同一类别内超过10个商品/服务项目，每超过1个商品/服务项目，每个商品/服务项目加收32元。 示例一：申请1个商标下的一个类别费用。 表3 10个项以内费用说明（以8个小项为例） 超过10个项费用说明（以15个小项为例） 668元 668+（15-10）*32=828元 示例二：申请1个商标下的多个类别和多个项目费用，如第20类15个小项，第21类10个小项。 表4 第20类（以15个项为小例）费用说明 第21类（以10个小项为例）费用说明 费用总计 668+（15-10）*32=828元 668元 828+668=1496元

商标无忧注册计费说明 商标无忧注册为1528元/类（每类包含10个小项），您可选择多类和多个服务项目，同一类别内超过10个商品/服务项目，每超过1个商品/服务项目，每个商品/服务项目加收32元。 示例一：申请1个商标下的一个类别费用。 表5 10个项以内费用说明（以8个小项为例） 超过10个项费用说明（以15个小项为例） 1528元 1528+（15-10）*32=1688元 示例二：申请1个商标下的多个类别和多个项目费用，如第20类15个小项，第21类10个小项。 表6 第20类（以15个项为小例）费用说明 第21类（以10个小项为例）费用说明 费用总计 1528+（15-10）*32=1688元 1528元 1688+1528=3216元

商标分类表 商标分类是指《商标注册用商品和服务国际分类》，也称《尼斯分类》，共有45个类别，其中1-34类为商品类别，35-45类为服务类别。以下为商标分类表类别介绍，您可根据商标使用行业领域自行选择商标类别。 表1 商标分类表 商标类别 商标类别序号 商标类别使用行业说明 商品类 第一类 用于工业、科学、摄影、农业、园艺和林业的化学品；未加工人造合成树脂，未加工塑料物质；灭火和防火用合成物；淬火和焊接用制剂；鞣制动物皮毛用物质；工业用粘合剂；油灰及其他膏状填料；堆肥，肥料，化肥；工业和科学用生物制剂。 第二类 颜料，清漆，漆；防锈剂和木材防腐剂；着色剂，染料；印刷、标记和雕刻用油墨；未加工的天然树脂；绘画、装饰、印刷和艺术用金属箔及金属粉。 第三类 不含药物的化妆品和梳洗用制剂；不含药物的牙膏；香料，香精油；洗衣用漂白剂及其他物料；清洁、擦亮、去渍及研磨用制剂。 第四类 工业用油和油脂，蜡；润滑剂；吸收、润湿和粘结灰尘用合成物；燃料和照明材料；照明用蜡烛和灯芯。 第五类 药品，医用和兽医用制剂；医用卫生制剂；医用或兽医用营养食物和物质，婴儿食品；人用和动物用膳食补充剂；膏药，绷敷材料；填塞牙孔用料，牙科用蜡；消毒剂；消灭有害动物制剂；杀真菌剂，除莠剂。 第六类 普通金属及其合金，金属矿石；金属建筑材料；可移动金属建筑物；普通金属制非电气用缆线；金属小五金具；存储和运输用金属容器；保险箱。 第七类 机器，机床，电动工具；马达和引擎（陆地车辆用的除外）；机器联结器和传动机件（陆地车辆用的除外）；除手动手工具以外的农业器具；孵化器；自动售货机。 第八类 手工具和器具（手动的）；刀、叉和匙餐具；除火器外的随身武器；剃刀。 第九类 科学、研究、导航、测量、摄影、电影、视听、光学、衡具、量具、信号、侦测、测试、检验、救生和教学用装置及仪器；处理、开关、转换、积累、调节或控制电的配送或使用的装置和仪器；录制、传送、重放或处理声音、影像或数据的装置和仪器；已录制和可下载的媒体，计算机软件，录制和存储用空白的数字或模拟介质；投币启动设备用机械装置；收银机，计算设备；计算机和计算机外围设备；潜水服，潜水面罩，潜水用耳塞，潜水和游泳用鼻夹，潜水员手套，潜水呼吸器；灭火设备。 第十类 外科、医疗、牙科和兽医用仪器及器械；假肢，假眼和假牙；矫形用物品；缝合材料；残疾人专用治疗装置；按摩器械；婴儿护理用器械、器具及用品；性生活用器械、器具及用品。 第十一类 照明、加热、冷却、蒸汽发生、烹饪、干燥、通风、供水以及卫生用装置和设备。 第十二类 运载工具；陆、空、海用客运或货运装置。 第十三类 火器；军火及弹药；炸药；焰火。 第十四类 贵金属及其合金；首饰宝石和半宝石；钟表和计时仪器。 第十五类 乐器；乐谱架和乐器架；指挥棒。 第十六类 纸和纸板；印刷品；书籍装订材料；照片；文具和办公用品（家具除外）；文具用或家庭用粘合剂；绘画材料和艺术家用材料；画笔；教育或教学用品；包装和打包用塑料纸、塑料膜和塑料袋；印刷铅字，印版。 第十七类 未加工和半加工的橡胶、古塔胶、树胶、石棉、云母及这些材料的代用品；生产用成型塑料和树脂制品；包装、填充和绝缘用材料；非金属软管和非金属柔性管。 第十八类 皮革和人造皮革；动物皮；行李箱和背包；雨伞和阳伞；手杖；鞭，马具和鞍具；动物用项圈、皮带和衣服。 第十九类 非金属的建筑材料；建筑用非金属硬管；柏油，沥青；可移动非金属建筑物；非金属纪念碑。 第二十类 家具，镜子，相框；存储或运输用非金属容器；未加工或半加工的骨、角、鲸骨或珍珠母；贝壳；海泡石；黄琥珀。 第二十一类 家用或厨房用器具和容器；烹饪用具和餐具（刀、叉、匙除外）；梳子和海绵；刷子（画笔除外）；制刷原料；清洁用具；未加工或半加工玻璃（建筑用玻璃除外）；玻璃器皿、瓷器和陶器。 第二十二类 绳索和细绳；网；帐篷和防水遮布；纺织品或合成材料制遮篷；帆；运输和贮存散装物用麻袋；衬垫和填充材料（纸或纸板、橡胶、塑料制除外）；纺织用纤维原料及其替代品。 第二十三类 纺织用纱和线。 第二十四类 织物及其替代品；家庭日用纺织品；纺织品制或塑料制帘。 第二十五类 服装，鞋，帽。 第二十六类 花边，编带和刺绣品，缝纫用饰带和蝴蝶结；纽扣，领钩扣，饰针和缝针；人造花；发饰；假发。 第二十七类 地毯，地席，亚麻油地毡及其他铺在已建成地板上的材料；非纺织品制壁挂。 第二十八类 游戏器具和玩具；视频游戏装置；体育和运动用品；圣诞树用装饰品。 第二十九类 肉，鱼，家禽和野味；肉汁；腌渍、冷冻、干制及煮熟的水果和蔬菜；果冻，果酱，蜜饯；蛋， 奶，奶酪，黄油，酸奶和其他奶制品；食用油和油脂。 第三十类 咖啡，茶，可可和咖啡代用品；米，意式面食，面条；食用淀粉和西米；面粉和谷类制品；面包、糕点和甜食；巧克力；冰淇淋，果汁刨冰和其他食用冰；糖，蜂蜜，糖浆；鲜酵母，发酵粉；食盐，调味料，香辛料，腌制香草；醋，调味酱汁和其他调味品；冰（冻结的水）。 第三十一类 未加工的农业、水产养殖业、园艺、林业产品；未加工的谷物和种子；新鲜水果和蔬菜，新鲜芳香草本植物；草木和花卉；种植用球茎、幼苗和种子；活动物；动物的饮食；麦芽。 第三十二类 啤酒；无酒精饮料；矿泉水和汽水；水果饮料及果汁；糖浆及其他制饮料用无酒精制剂。 第三十三类 酒精饮料（啤酒除外）；制饮料用酒精制剂。 第三十四类 烟草和烟草代用品；香烟和雪茄；电子香烟和吸烟者用口腔雾化器；烟具；火柴。 服务类。 服务类 第三十五类 广告；商业经营；商业管理；办公事务。 第三十六类 保险；金融事务；货币事务；不动产事务。 第三十七类 房屋建筑；修理；安装服务。 第三十八类 电信。 第三十九类 运输；商品包装和贮藏；旅行安排。 第四十类 材料处理。 第四十一类 教育；提供培训；娱乐；文体活动。 第四十二类 科学技术服务和与之相关的研究与设计服务；工业分析与工业研究服务；计算机硬件与软件的设计与开发。 第四十三类 提供食物和饮料服务；临时住宿。 第四十四类 由个人或机构向人或动物提供的医疗（包括替代疗法）、卫生和美容服务， 以及与农业、水产养殖、园艺和林业领域相关的服务。 第四十五类 法律服务；为有形财产和个人提供实体保护的安全服务；由他人提供的为满足个人需要的私人和社会服务。