华为云用户手册

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 devices Array of InnerDeviceInfoMuti objects 设备列表 total Integer 查询条数 device_total Integer 设备总数 admin_total Integer 管理员总数 online_total Integer 在线设备数 表5 InnerDeviceInfoMuti 参数 参数类型 描述 device_id String 设备ID，设备唯一标识符 device_name String 设备名称 device_state String 设备状态 枚举值： OFFLINE 离线 ONLINE 在线 UNREGISTERED 未注册 device_type String 设备类型 枚举值： IPC 直连摄像机 NVR NVR设备 MEdge IVS1800设备 device_system_state String 设备系统冻结 枚举值： NORMAL 正常 UNAVAILABLE_FROZEN 冻结 access_protocol String 接入协议类型 枚举值： HOLO 好望协议 GB28181 国标协议 manufacture String 生产厂家 device_ability String 设备能力集：枚举类型，参考附录设备能力集，多个能力集用英文逗号分隔 channel_total Integer 通道总数 channels Array of InnerChannelInfo objects 通道信息 operator_total Integer 该设备绑定的普通用户总数 model String 设备型号 create_time String 设备添加时间 update_time String 设备更新时间，在设备重新上线后或者移动设备分组后会修改时间 device_org_name String 设备组织名称 frimware String 设备版本 channel_allocated_total Integer 已分配通道总数 channel_online_count Integer 在线通道总数 audio_input_cnt Integer 音频输入通道个数 audio_output_cnt Integer 音频输出通道个数 gb_access_state String 国标设备未上线原因 枚举值 NOT_CONNECTED：云服务未收到设备信息 NO_AUTHENTICATION_INFO：云服务接受设备信息不全 AUTHENTICATION_FAILED：鉴权失败 CATA LOG _ERROR：未收到正确的通道信息 UNKNOWN_ERROR：未知错误 CONNECTED：已连接 表6 InnerChannelInfo 参数 参数类型 描述 channel_resource_state Array of strings 通道资源列表：一个通道可以存在多个套餐，枚举类型 枚举值： MANAGEMENT_GRANT 管理套餐开通 MANAGEMENT_ARREAR 管理套餐欠费 MANAGEMENT_CLOSED 管理套餐未开通 EVENT_RECORD_GRANT 动检套餐开通 EVENT_RECORD_ARREAR 动检套餐欠费 EVENT_RECORD_CLOSED 动检套餐关闭 FULL_RECORD_GRANT 全量套餐开通 FULL_RECORD_ARREAR 全量套餐欠费 FULL_RECORD_CLOSED 全量套餐关闭 INDUSTRY_DATA_GRANT 行业数据流套餐开通 INDUSTRY_DATA_ARREAR 行业数据流套餐欠费 INDUSTRY_DATA_CLOSED 行业数据流套餐关闭 channel_state String 通道状态：枚举类型 枚举值： OFFLINE 离线 ONLINE 在线 UNREGISTERED 未注册 channel_system_state String 设备系统状态：枚举类型 枚举值： NORMAL 正常 UNAVAILABLE_FROZEN 冻结 channel_id String 通道ID channel_name String 通道名称 channel_model String 通道的设备型号 channel_mode String 通道的设备型号，此字段已废弃，不推荐使用，建议使用channel_model字段代替 invalid_type String 通道无效类型：枚举类型 枚举值： NORMAL 正常 CHANNEL_ID_INVALID 通道ID无效 channel_ability String 通道能力集 storage_card_status String SD卡状态 枚举类型： 0-卡存在且运行正常 1-卡存在但是异常需要格式化 2-卡不存在 3-格式化中 -1-设备不支持 mask_mode String 隐私遮蔽开关状态 枚举类型： OPEN-开 CLOSE-关

URI GET /v1/{user_id}/device-orgs/{device_org_id}/devices 表1 路径参数 参数 是否必选 参数类型 描述 device_org_id 是 String 设备组织ID：由数字组成，长度范围[1,25]，根组织节点的值为0，可以从查询子级设备组织获取 user_id 是 String 用户ID：由数字组成，长度范围[15,25]，获取方式参考获取user ID与下载AK/SK章节 表2 Query参数 参数 是否必选 参数类型 描述 access_protocol 否 String 接入协议：枚举类型，多个查询使用英文逗号分隔 枚举值： HOLO 好望协议 GB28181 国标协议 channel_resource_state 否 String 通道资源状态：枚举类型，多个查询使用英文逗号分隔 枚举值： MANAGEMENT_GRANT 管理套餐开通 MANAGEMENT_ARREAR 管理套餐欠费 MANAGEMENT_CLOSED 管理套餐未开通 EVENT_RECORD_GRANT 动检套餐开通 EVENT_RECORD_ARREAR 动检套餐欠费 EVENT_RECORD_CLOSED 动检套餐关闭 FULL_RECORD_GRANT 全量套餐开通 FULL_RECORD_ARREAR 全量套餐欠费 FULL_RECORD_CLOSED 全量套餐关闭 INDUSTRY_DATA_GRANT 行业数据流套餐开通 INDUSTRY_DATA_ARREAR 行业数据流套餐欠费 INDUSTRY_DATA_CLOSED 行业数据流套餐关闭 ability 否 String 设备能力：枚举类型，仅支持单个能力集查询 枚举值： algorithm 算法能力 ptz 云台能力 device_id 否 String 设备ID： 好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取 国标设备：由数字组成，长度为20个字符长度，由客户自行设置，其中第11-13位，必须是以下之一132（IPC）、111（DVR）、118（NVR)，用来区分设备类型 device_name 否 String 模糊查询字段：支持设备名称模糊匹配，由字符组成，支持数字、中文（一个汉字算两个字符）、英文、-、_、空格，长度范围[1,128] device_state 否 String 设备状态：枚举类型，多个查询使用英文逗号分隔 枚举值： OFFLINE 离线 ONLINE 在线 UNREGISTERED 未注册 device_system_state 否 String 设备系统状态：枚举类型，多个查询使用英文逗号分隔 枚举值： NORMAL 正常 UNAVAILABLE_FROZEN 冻结 device_type 否 String 设备类型：枚举类型，多个查询使用英文逗号分隔 枚举值： IPC 直连摄像机 NVR NVR设备 MEdge IVS1800设备 direction 否 String 排序方向：枚举类型，默认降序，不区分大小写 枚举值： ASC 升序 DESC 降序 group_ids 否 String 所属分组ID列表：支持多个设备组织查询，使用英文逗号分隔 单个设备组织ID：由数字组成，长度范围[1,25]（根组织节点的值为0） is_current_org 否 String 是否属于当前组织：枚举类型，不填就是查询全部组织 枚举值： 0 下级组织 1 当前组织 2 所有组织 limit 否 Integer 限制条数：取值范围[0,1000]，不填写时默认值为10 manufactures 否 String 厂商：支持多个厂商查询，使用英文逗号隔开 单个厂商：由中文（一个汉字算两个字符）、英文、数字 、特殊字符（_-空格）组成，长度范围[1,64] offset 否 Integer 偏移量页数：0为第一页，取值范围[0,2147483646]，不填写时默认为0 sort_by 否 String 排序字段：枚举类型，默认按创建时间create_time排序 枚举值： create_time 创建时间 update_time 更新时间 operator_total 拥有该设备的普通用户总数 user_order 否 Integer 排序字段：枚举类型，按用户数排序（当前无效） 枚举值： 0 数量从小到大 1 数量从大到小

修订记录 表1 修订记录 修改时间 修改说明 2023-08-24 第六十一次正式发布 本次变更如下： 9、10 敏感数据脱敏 隐藏文档中涉及token、user_id、设备ID、AKSK、BASE64数据、图片等敏感信息 2023-08-22 第六十次正式发布 本次变更如下： 12.1批量开通设备通道服务 请求和响应示例的假数据添加***脱敏处理 12.2批量关闭设备通道服务 请求和响应示例的假数据添加***脱敏处理 2023-08-16 第五十九次正式发布 本次变更如下： 6.7批量添加设备 表4里面的algorithm行的描述列新增了md5使用的风险说明 批量变更IP地址为123.123.123.123 批量变更不对外公开地址为www.example.com 2023-07-25 第五十八次正式发布 本次变更如下： 8.5云台控制：表3里面的mode行的描述列做了点动模式的描述新增以及转动模式的描述更改 2023-07-1 第五十七次正式发布 本次变更如下： 替换 好望云服务 为行业视频管理服务。 2023-06-26 第五十六次正式发布 本次变更如下： 修正 SDK中心 链接地址。 9.3获取回放地址统一接口响应结构与字段更正 9.4批量删除播放地址接口功能介绍修改 11.5请求参数中的record_type去掉了枚举值all 19.1请求示例字段更正 2023-06-02 第五十五次正式发布 本次变更如下： 6.4章节请求参数modify_type描述修改 6.5和6.7章节请求参数device_name和device_password描述修改 6.6和6.7章节请求参数description描述修改 7.1章节功能描述修改 9.1新增获取实况地址统一接口 9.2新增查询回放列表统一接口 9.3新增获取回放地址统一接口 9.4章节接口功能描述修改 9.5-9.12章节相应接口更迭为旧接口，加上【旧】字样 9.5-9.12章节功能描述修改，各种参数描述部分修正 10.1章节部分告警描述修改补充，部分TLV字段描述修改补充 2023-02-13 第五十四次正式发布 本次变更如下： 5.1返回参数is_leaf增加返回值的描述 19巡航轨迹和预置位下的章节重新排序，并添加只支持好望设备说明 19.3响应参数preset_index描述修改 19.5添加获取云台控制权接口的链接 19.6响应示例修改 19.7响应参数cruise_type巡航轨迹类型增加枚举描述 19.8和19.10章节请求参数speedLevel描述修改 2023-02-02 第五十三次正式发布 本次变更如下： 11.1查询人流统计日周年信息关于MONTH枚举类型补充改正 11.2响应体描述补充 17.1增加仅支持好望设备/通道的提示 17.2增加仅支持好望设备/通道的提示 2023-01-13 第五十二次正式发布 本次变更如下： 8.3查询通道详情章节响应体中新增通道类型字段 2023-01-10 第五十一次正式发布 本次变更如下： DEVICE_ALARM 消息类型添加字段 alarm_attr 2023-01-04 第五十次正式发布 本次变更如下： auth_key 参数完善 告警智能图片下载兼容 THIRDPARTY_INTELLIGENT 三方告警类型 2023-01-04 第四十九次正式发布 本次变更如下： 20.5添加预置位章节增加直连场景的入参。 2023-01-03 第四十八次正式发布 本次变更如下： 批量添加目标图片功能，参数提示描述完善 2022-12-30 第四十七次正式发布 本次变更如下： 8.2 查询通道列表章节，增加返回channel_type字段。 原19.8章节后插入三个章节描述新版本目标库新增，修改，删除功能的接口。 2022-11-25 第四十六次正式发布 本次变更如下： 11.1 查询人流统计日月周年信息章节，type字段描述修改。 2022-11-25 第四十五次正式发布 本次变更如下： 修改API管理， 将调用的地址不隐藏，让文档更易懂。 2022-09-30 第四十四次正式发布 本次变更如下： 新增长尾算法接口 2022-08-08 第四十三次正式发布 本次变更如下： 配置用户 消息通知 URL 添加 HEAD_SHOULDER_DATA、BEHAVIOR_ANALYSIS_DATA、MICRO_CHECKPOINT_DATA 枚举值 2022-08-08 第四十二次正式发布 本次变更如下： 获取时间热度图统计中修改type枚举值分隔符 获取空间热度图统计中修改type枚举值分隔符 2022-07-20 第四十一次正式发布 本次变更如下： 新增设备云上能力集查询接口 设备、通道详情接口新增云上能力集查询相关字段 新增动检录像计划相关接口 2022-06-08 第四十次正式发布 本次变更如下： 查询通道的录像计划接口新增字段 2022-06-02 第三十九次正式发布 本次变更如下： 云台枚举值新增描述 2022-05-31 第三十八次正式发布 本次变更如下： HLS实况URL增加禁用音频选项 批量获取P2P回放URL接口中增加开始结束时间选项 2022-04-21 第三十七次正式发布 本次变更如下： 修改设备信息的入参返回值 云台点动接口参数补充 2022-04-19 第三十六次正式发布 本次变更如下： 修改目标库相关接口的入参返回值格式问题 2022-03-29 第三十五次正式发布 本次变更如下： 原先接口缺少的约束和字段补全 新增云台点动接口 新增设备目标授权配置接口 2022-03-25 第三十四次正式发布 本次变更如下： 添加空间热力图base64转RGB的伪代码说明 2022-03-14 第三十三次正式发布 本次变更如下： 接口api发布：新增目标库与修改目标库接口请求示例错误修正 2022-03-12 第三十二次正式发布 本次变更如下： 接口api发布：新增目标库，修改目标库，删除目标库 错误码新增：IVM.20000036 2022-03-02 第三十一次正式发布 本次变更如下： 目标库接口目标年龄用例String类型修改为Integer类型 云台转动填写新的档位，云台光圈聚焦增加一键聚焦功能和点动聚焦功能 目标库添加增加external_target_id 2022-02-23 第三十次正式发布 本次变更如下： 新增错误码：IVM.20090016 2022-02-18 第二十九次正式发布 本次变更如下： 新增支持wss协议播放接口 新增媒体播放管理部分接口支持url自定义超时时间和次数 修改云端录像record_type枚举值 2022-02-11 第二十八次正式发布 本次变更如下： 修正查询通道的前端录像回放地址(仅支持HLS协议)接口 2022-01-29 第二十七次正式发布 本次变更如下： 修改itgt_type 字段枚举值 2022-01-17 第二十六次正式发布 本次变更如下： 修改告警推送消息体结构的message_type为device_status时的请求示例 2022-01-12 第二十五次正式发布 本次变更如下： 批量获取设备实况播放地址删除仅支持国标设备描述 2021-12-27 第二十四次正式发布 本次变更如下： 周界检测告警参数配置和获取周界检测告警参数添加结构体 region 、point 2021-12-16 第二十三次正式发布 本次变更如下： 巡航轨迹和预置位功能重新上线 设备密码修改 查询设备码流能力和码流列表特性 2021-12-09 第二十二次正式发布 本次变更如下： 添加三种智能业务：头肩业务、行为分析与人车物分离、微卡口业务 target_data 目标及目标整体业务和 vehicle_data 机非人业务新增字段 2021-12-06 第二十一次正式发布 本次变更如下： 添加HLS协议实况、云端回放、前端回放地址 2021-11-25 第二十次正式发布 本次变更如下： 设备密码、码流远程配置、巡航轨迹和预置位接口删除 2021-11-24 第十九次正式发布 本次变更如下： 设备密码和码流远程配置接口添加 2021-11-23 第十八次正式发布 添加各种类型设备目标库字段支持情况 2021-11-05 第十七次正式发布 本次变更如下： 告警推送消息结构体的 target_data 类型新增五个字段： itgt_version String 目标识别算法版本号 quality_score Int 目标识别目标抠图质量分 target_url String 目标抠图的 URL target_all_pic_url String 目标整体抠图的 URL panorama_url String 目标全景的 URL 2021-11-01 第十七次正式发布 本次变更如下： 巡航轨迹和预置位接口添加 2021-08-27 第十六次正式发布 本次变更如下： 修改通道名称修改为只支持好望协议，通道名称修改特殊字符增加. 2021-08-19 第十五次正式发布 本次变更如下： OSD名称相关，名字增加对换行符的支持 2021-08-18 第十四次正式发布 本次变更如下： 添加设备升级失败的字段，及响应示例 2021-08-13 第十三次正式发布 本次变更如下： 添加查询用户URL的响应示例 2021-08-06 第十二次正式发布 本次变更如下： 修改配置周界告警参数配置的请求示例 给配置用户消息通知URL接口新增了接口说明 2021-07-23 第十一次正式发布 本次变更如下： 批量添加设备(仅支持GB28181协议)接口增加algorithm字段 添加目标库接口文档 发送云台聚焦和光圈控制命令params改为必填参数 2021-07-08 第十次正式发布 本次变更如下： 消息回调接口增加auth_key字段 2021-06-25 第九次正式发布 本次变更如下： 解决：消息推送ISV，回调URL接口，告警图片下载接口的MG信息问题 补充描述，智能及告警图片下载路径有效期五分钟 2021-06-11 第八次正式发布 本次变更如下： 告警推送新增物品遗留、移走、电瓶车等告警类型，图片下载接口新增第三方智能算法。 新增告警参数配置（两个接口） 2021-05-14 第七次正式发布 本次变更如下： 新增云端抓拍目录，新增云端抓拍设备接口 2021-04-28 第六次正式发布 本次变更如下： 部分接口增加详细说明，比如设备实况地址获取接口仅支持国标 2021-04-15 第五次正式发布 本次变更如下： 下线FLV、WASM等内容。 2021-04-12 第四次正式发布 本次变更如下： 告警推送消息体结构，修改 rect 对象的字段名 2021-04-06 第三次正式发布 本次变更如下： API参考中增加“附录”目录，附录中存放状态码、错误码以及其他北向接口调用参考信息； 告警消息结构体从“用户指南”移动到了“消息管理”目录中。 LiveWebURLDto参数对象中的“stream_type”码流参数类型补充了取值范围。 增加了“使用前必读”、“API概览”、“如何调用API”说明目录。 2021-03-05 第二次正式发布 本次变更如下： API目录名称统一去除“北向”两字。 新增“智能图片下载”、“告警图片下载”北向接口目录及所属能力接口。 2020-12-15 第一次正式发布

URI GET /v1/{user_id}/devices/{device_id}/channels/{channel_id}/control-lock 表1 路径参数 参数 是否必选 参数类型 描述 channel_id 是 String 通道ID： 好望设备：取值范围[0,999] 国标设备：由数字组成，长度为20个字符，由客户自行在设备侧设置，可以在web界面获取 device_id 是 String 设备ID： 好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取 国标设备：由数字组成，长度为20个字符长度，由客户自行设置，其中第11-13位，必须是以下之一132（IPC）、111（DVR）、118（NVR)，用来区分设备类型 user_id 是 String 用户ID：由数字组成，长度范围[15,25]，获取方式参考获取user ID与下载AK/SK章节

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Access-Token 是 String 用户认证AccessToken：从获取用户北向接口认证AccessToken中获取 表3 请求Body参数 参数 是否必选 参数类型 描述 channel_name 是 String 通道名称：支持英文、中文（一个汉字算两个字符）、数字、特殊字符（_-.空格换行符），长度范围[1,128]

URI PUT /v1/{user_id}/devices/{device_id}/channels/{channel_id} 表1 路径参数 参数 是否必选 参数类型 描述 channel_id 是 String 通道ID： 好望设备：取值范围[0,999] device_id 是 String 设备ID： 好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取 、 user_id 是 String 用户ID：由数字组成，长度范围[15,25]，获取方式参考获取user ID与下载AK/SK章节

URI GET /v1/{user_id}/device-orgs/{device_org_id}/sub-orgs 表1 路径参数 参数 是否必选 参数类型 描述 device_org_id 是 String 设备组织ID：由数字组成，长度范围[1,25]（根组织节点的值为0，从此接口逐级往下获取子组织节点） user_id 是 String 用户ID：由数字组成，长度范围[15,25]，获取方式参考获取user ID与下载AK/SK章节

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 orgs Array of getChildOrgResp_org_list objects 响应信息 表4 getChildOrgResp_org_list 参数 参数类型 描述 device_org_id String 设备组织ID device_org_name String 设备组织名称 device_org_level Integer 设备组织级别，第一级子节点数值为1，第二级为2，以此类推 camera_count Integer 该设备组织下的（包括子级组织）设备个数 camera_online_count Integer 该设备组织下的（包括子级组织）设备在线数量 is_leaf Integer 是否是叶子节点：枚举类型 枚举值： 1 叶子节点，没有子级设备组织 0 非叶子节点，有子级设备组织 channel_count Integer 该设备组织下的（包括子级组织）通道在线数量 channel_online_count Integer 该设备组织下的（包括子级组织）通道在线总数 channel_offline_count Integer 该设备组织下的（包括子级组织）通道离线总数

响应示例 状态码： 200 OK { "orgs" : [ { "device_org_id" : "1234567890***", "device_org_name" : "3级分组", "device_org_level" : 3, "camera_count" : 10, "camera_online_count" : 5, "is_leaf" : 0, "channel_count" : 200, "channel_online_count" : 50, "channel_offline_count" : 150 } ] }

查询设备码流能力和码流列表 接口 说明 GET /v1/{user_id}/devices/{device_id}/channels/{channel_id}/stream-ability 查询设备码流能力和码流列表 GET /v1/{user_id}/devices/{device_id}/channels/{channel_id}/stream-detail 查询设备码流详情，目前仅支持好望设备 POST /v1/{user_id}/devices/{device_id}/channels/{channel_id}/stream-detail 设备码流配置

设备密码修改 接口 说明 GET /v1/{user_id}/devices/{device_id}/channels/{channel_id}/security-key 查询设备密码状态，仅支持好望SDC直连设备 PUT /v1/{user_id}/devices/{device_id}/channels/{channel_id}/security-key 设置或修改设备密码，仅支持好望SDC直连设备

设备目标授权配置 接口 说明 PUT /v1/{user_id}/devices/{device_id}/channels/targets/authorization 批量设置通道目标授权状态，只支持好望设备 GET /v1/{user_id}/devices/{device_id}/channels/{channel_id}/targets/authorization 查询设备目标授权状态，仅支持好望设备

目标库 接口 说明 POST /v1/{user_id}/target/batch-delete 删除目标信息 PUT /v1/{user_id}/targets 批量修改目标信息 POST /v1/{user_id}/targets/batch-add 目标批量添加 GET /v1/{user_id}/targets/ids 按索引范围获取目标ID列表 GET /v1/{user_id}/target-groups 获取目标库分组 POST /v1/{user_id}/target-groups 新增目标库分组 PUT /v1/{user_id}/target-groups 修改目标库分组 DELETE /v1/{user_id}/target-groups 删除目标库分组 POST /v2/{user_id}/target-groups 新增目标库分组v2 PUT /v2/{user_id}/target-groups 修改目标库分组v2 DELETE /v2/{user_id}/target-groups 删除目标库分组v2 GET /v1/{user_id}/targets 按索引范围获取目标信息列表 POST /v1/{user_id}/targets 获取目标信息（IVS1800不支持） GET /v1/{user_id}/targets/count 获取目标库分组中的目标数量

巡航轨迹和预置位 接口 说明 GET /v1/{user_id}/devices/{device_id}/channels/{channel_id}/cruise-track/list 获取巡航轨迹列表 DELETE /v1/{user_id}/devices/{device_id}/channels/{channel_id}/preset-position 删除摄像机预置位 PUT /v1/{user_id}/devices/{device_id}/channels/{channel_id}/cruise-track 修改摄像机巡航轨迹 POST /v1/{user_id}/devices/{device_id}/channels/{channel_id}/cruise-track 添加摄像机巡航轨迹 POST /v1/{user_id}/devices/{device_id}/channels/{channel_id}/preset-position 添加摄像机预置位 GET /v1/{user_id}/devices/{device_id}/channels/{channel_id}/cruise-track 查询指定巡航轨迹详情 PUT /v1/{user_id}/devices/{device_id}/channels/{channel_id}/cruise-track/enable 启停摄像机巡航轨迹 DELETE /v1/{user_id}/devices/{device_id}/channels/{channel_id}/cruise-track 删除摄像机巡航轨迹 PUT /v1/{user_id}/devices/{device_id}/channels/{channel_id}/preset-position 修改摄像机预置位 POST /v1/{user_id}/devices/{device_id}/channels/{channel_id}/preset-position/move 移动摄像机转到预置位 GET /v1/{user_id}/devices/{device_id}/channels/{channel_id}/preset-position 查询摄像机预置位列表

资源管理 接口 说明 GET /v1/{user_id}/resources 查询包周期和按需资源列表 GET /v1/{user_id}/resources/{resource_id}/channels 查询包周期或按需资源下的通道列表 GET /v1/{user_id}/devices/{device_id}/channels/{channel_id}/resources 查询通道下的资源列表

录像配置管理 接口 说明 PUT /v1/{user_id}/devices/channels/record-plan 批量为通道设置录像计划 POST /v1/{user_id}/devices/channels/record-plan 批量删除通道录像计划 GET /v1/{user_id}/devices/{device_id}/channels/{channel_id}/record-plan 查询通道的录像计划 GET /v1/{user_id}/devices/{device_id}/channels/{channel_id}/time-policy 查询通道存储时间策略 PUT /v1/{user_id}/devices/channels/record-config 批量设置通道录像参数 GET /v1/{user_id}/devices/{device_id}/channels/{channel_id}/record-config 查询通道录像参数 PUT /v1/{user_id}/devices/channels/time-policy 批量设置通道存储时间策略 PUT /v1/{user_id}/devices/channels/record-alarm-plan 批量设置通道动检录像计划 GET /v1/{user_id}/devices/{device_id}/channels/{channel_id}/record-alarm-plan 查询通道的动检录像计划

媒体播放管理 接口 说明 POST /v2/{user_id}/devices/channels/media/live-connections 获取实况地址统一接口 GET /v2/{user_id}/devices/{device_id}/channels/{channel_id}/media/records 查询回放列表统一接口 GET /v2/{user_id}/devices/{device_id}/channels/{channel_id}/media/playback-connections 获取回放地址统一接口 POST /v1/{user_id}/media/urls/batch-delete 批量删除播放地址 GET /v1/{user_id}/devices/{device_id}/channels/{channel_id}/cloud-records 【旧】查询通道的云端录像列表 GET /v1/{user_id}/devices/{device_id}/channels/{channel_id}/cloud-records/playback-url 【旧】查询通道的云端录像回放地址 GET /v1/{user_id}/devices/{device_id}/channels/{channel_id}/device-records 【旧】查询通道的前端录像列表 GET /v1/{user_id}/devices/{device_id}/channels/{channel_id}/device-records/playback-url 【旧】查询通道的前端录像回放地址（仅支持国标协议） GET /v1/{user_id}/devices/{device_id}/channels/{channel_id}/device-records/web-playback-url 【旧】查询通道的前端录像回放地址 POST /v1/{user_id}/devices/channels/cloud-live/url 【旧】批量获取设备实况播放地址 POST /v1/{user_id}/devices/channels/p2p-connect/live 【旧】批量获取通道实况P2P地址（仅支持好望协议） POST /v1/{user_id}/devices/channels/p2p-connect/playback 【旧】批量获取通道录像回放P2P地址（仅支持好望协议）

云台控制 接口 说明 GET /v1/{user_id}/devices/{device_id}/channels/{channel_id}/control-lock 获取云台控制权 POST /v1/{user_id}/devices/{device_id}/channels/{channel_id}/control-lock 释放云台控制权 POST /v1/{user_id}/devices/{device_id}/channels/{channel_id}/ptz/angle-spin 云台点动转动

设备组管理 接口 说明 GET /v1/{user_id}/device-orgs/{device_org_id}/sub-orgs 查询子级设备组织 GET /v1/{user_id}/device-orgs/{device_org_id}/devices 查询企业下的组织的设备列表 PUT /v1/{user_id}/device-orgs/{device_org_id} 修改设备分组名称 POST /v1/{user_id}/device-orgs 添加设备分组 DELETE /v1/{user_id}/device-orgs/{device_org_id} 删除单个设备组 POST /v1/{user_id}/device-orgs/{device_org_id}/move-devices 移动多个设备到新的设备组 GET /v1/{user_id}/device-orgs/tree 根据设备组名称查询设备组织树(支持设备组名称模糊查询)

设备管理 接口 说明 GET /v1/{user_id}/devices/{device_id} 用户根据设备ID查询设备信息详情 GET /v1/{user_id}/devices 用户查询设备列表 GET /v1/{user_id}/devices/{device_id}/gateway 查询设备网关（仅支持国标） PUT /v1/{user_id}/devices/{device_id} 修改设备信息 PUT /v1/{user_id}/devices/{device_id}/gb-account 修改国标设备账号 POST /v1/{user_id}/devices/holosens 添加好望设备 POST /v1/{user_id}/devices/gb/batch-add 批量添加国标设备 POST /v1/{user_id}/devices/batch-delete 批量删除设备

请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 ak 是 String 用户认证AK。 支持大小写字母，数字，特殊字符（-_），长度范围[1,64]，获取方式参考获取user ID与下载AK/SK章节。 sk 是 String 用户认证SK。 支持大小写字母，数字，特殊字符（-_），长度范围[1,64]，获取方式参考获取user ID与下载AK/SK章节。 force_update 否 boolean 强制更新标识符。 AK当前仅持有 一个AccessToken 且剩余有效期小于等于两天时，可通过此参数获取新的 AccessToken 使用；其他场景传此参数不解析。

概述 行业视频管理服务是华为云围绕安全防范、生产管理、智慧运营等场景的机器视觉云服务统称，通过行业视频管理、好望开发平台、好望商城等智慧云服务，为企业用户提供智能原生的端云协同行业视频云服务解决方案，助力企业数字化转型，行业视频管理服务拥有以下优势： 视频体验： 全云加速，一点即播； 同等带宽下更清晰的体验； 网络抖动下更流畅的体验。 数据安全： 深入骨髓的数据安全理念； 华为 云安全 加持的行业视频管理服务数据“五不”原则； 满足华为云80+项安全合规标准。 智能原生： 围绕智能全生命周期管理的架构体系； 智能生产、交易、应用全闭环。 开放生态： 开放安全的接入生态，兼容多终端便捷接入； 智能算法生态持续繁荣； 场景化API使能丰富的应用生态。

调用说明 媒体处理 提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 同时媒体处理还提供了完备的SDK接口供您使用： SDK提供了直播能力和回放能力，直播功能包含直播预览，直播音频，直播抓图，直播录像，语音对讲；回放功能包括设备录像回放和云端录像回放，包含录像查询，录像日历，录像回放视频，录像回放音频，录像回放跳转，录像回放暂停/播放，录像回放倍速控制，回放抓图，回放录像。 SDK下载地址：https://console.huaweicloud.com/apiexplorer/#/sdkcenter/IVM SDK支持平台：安卓（HoloSens-Android-SDK）、IOS（HoloSens-IOS-SDK）、PC（HoloSens-PC-SDK）、WEB插件（HoloSens-Smart-WebPlugin）

使用说明 由于 云审计 服务的关键操作通知需要使用消息通知服务向相关的订阅者发送通知，因此需要提前了解消息通知服务的创建主题、添加订阅等操作。 云审计服务支持创建100个关键操作通知： 自定义类型的关键操作通知支持单独设置触发操作范围、指定操作用户和通知主题。 完整类型的关键操作通知，支持通知主题。 如果云审计服务和 云监控服务 使用同一消息主题，则接受终端一样，但是发送的内容不同。 单个关键操作通知支持最多对10个用户组的50个用户发起的操作进行通知配置。单个关键操作通知不支持一次选择多个用户组，但是可以分次添加不同用户组中的用户在同一个关键操作通知。

关联服务 对象存储服务 （Object Storage Service，简称OBS）：存储事件文件。 由于云审计服务需要高频次的访问转储的OBS桶，因此必须选择使用标准存储类型的OBS桶。 数据加密 服务（Data Encryption Workshop，简称DEW）：为事件文件加密功能提供密钥。 云日志 服务（Log Tank Service，简称LTS）：提供日志存储功能。 消息通知服务（Simple Message Notification，简称 SMN ）：检测到关键操作时，调用消息通知服务向用户发送邮件、短信通知。

操作场景 用户首次进入云审计服务时，在追踪器页面单击“开通云审计服务”，系统会自动为您创建一个名为system的管理追踪器，之后您也可以在追踪器页面创建多个数据追踪器。管理追踪器会自动识别并关联当前租户所使用的所有云服务，并将当前租户的所有操作记录在该追踪器中。数据追踪器会记录租户对OBS桶中的数据操作的详细信息。 用户通过云审计控制台只能查询最近7天的操作记录。如果需要查询超过7天的操作记录，您必须配置转储到对象存储服务(OBS)，才可在OBS桶里面查看历史文件。否则，您将无法追溯7天以前的操作记录。

入门实践 当您完成了查看审计事件、配置追踪器等基本操作后，可以根据自身的业务需求使用云审计服务提供的一系列常用实践。 表1 常用最佳实践 实践 描述 结合 函数工作流 对登录/登出进行审计分析 该实践介绍如何通过 CTS 云审计服务，完成对公有云账户的各个云服务资源操作和结果的实时记录。 通过在函数工作流服务中创建CTS触发器获取订阅的资源操作信息，经由自定义函数对资源操作的信息进行分析和处理，产生告警日志。再由SMN消息通知服务通过短信和邮件推送告警信息，通知业务人员进行处理。

操作场景 域名 所有者在华为云DNS控制台创建公网域名时，如果提示“该域名已被添加至其他账号的DNS中，您需要将域名找回至当前账号。”，可以通过“域名找回”功能将域名找回至用户当前账号。 域名找回时，DNS服务需要验证用户是否为域名所有者，系统会按照特定格式生成一条TXT解析记录，用户需要前往域名当前DNS服务商处配置此TXT解析记录并验证，DNS服务会在互联网请求用户域名的该条TXT解析，如果返回正确结果则认为用户是域名所有者，即可成功找回域名。 本文指导域名所有者找回域名。 域名找回到当前账号下，会删除之前配置的所有解析记录，请谨慎操作。 因错误执行域名找回操作造成的DNS解析服务异常，用户须自行承担造成的风险与后果。 如果域名当前已有生产业务在使用，建议联系账号所有者通过账号间转移功能转移解析管理。

操作步骤 获取TXT记录验证信息 进入公网域名列表页面。 单击页面右上角“创建公网域名”。 根据界面提示配置相关参数，单击“确定”。 界面提示域名已被其他租户创建，请根据提示信息单击“如何找回域名”。 在“找回域名-TXT记录验证”页面，获取并记录用于验证域名所有者所需的TXT记录验证信息。 配置TXT记录验证信息 以下内容涉及第三方DNS服务商操作，相关内容仅供参考，详细操作步骤请参考对应DNS服务商的帮助文档。 如果域名的DNS服务商是华为云DNS，请先将域名的DNS服务器地址修改为第三方权威DNS，然后再前往对应的第三方DNS服务商处进行以下操作。 修改域名的DNS服务器地址请参见修改公网域名的DNS服务器地址。 修改域名DNS服务器地址后不会立即生效，具体的生效时间请参见修改DNS服务器后多久生效？。 由于找回域名需要前往域名DNS服务商处配置TXT记录验证，所以当DNS服务商为华为云DNS时，不支持将DNS服务器地址修改为公共DNS。 登录域名的DNS控制台。 在域名列表中，单击“域名”列的域名名称。 进入解析设置页面。 为域名配置TXT类型解析记录。 记录类型：TXT。 主机记录：请填写步骤1.e中的主机记录信息。 记录值：请填写步骤1.e中的记录值信息。 单击“确定”，完成TXT记录的添加。 在解析记录列表中，当TXT记录“状态”列显示为“正常”时，表示TXT记录添加成功。 验证TXT记录信息 待TXT解析生效后，返回1.e所示页面，单击“验证”按钮。 后台系统会验证域名TXT解析记录是否生效，请耐心等待，验证通过后，域名将自动添加至当前账号中。

概述 Web应用防火墙 （WAF）、DDoS高防（Advanced Anti-DDoS）、内容分发网络（CDN）会对用户的流量进行反向代理，部署后，CFW接收到的源IP为上述服务的回源IP。 当配置了华为云的其他产品后，业务流量会经过多道防护，在对入云流量进行防护时，如果CFW前存在反向代理服务（即购买了CDN、DDoS高防或云模式WAF），需配置放行回源IP策略，避免误拦截，购买独享模式WAF或ELB模式WAF时，按业务需要配置即可。