检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
构造请求 本节介绍REST API请求的组成,并以调用IAM服务的获取用户Token接口来说明如何调用API,该API获取用户的Token,Token可以用于调用其他API时鉴权。 您还可以通过这个视频教程了解如何构造请求调用API。 请求URI 请求URI由如下部分组成。 {URI-scheme}
取流客户端数量达到上限,当前每条视频流最大支持5个客户端同时取流,请确认取流客户端数量。 本地网络与公网环境不通或者网络抖动等原因无法建立连接,请尝试重新发起请求。
返回结果 请求发送以后,您会收到响应,包含:状态码、响应消息头和响应消息体。 状态码 状态码是一组从1xx到5xx的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。 对于获取用户Token接口,如果调用后返回状态码为“201”,则表示请求成功。 响应消息头 对
12MB以上的请求请使用Token认证。 AK/SK认证就是使用AK/SK对请求进行签名,在请求时将签名信息添加到消息头,从而通过身份认证。 AK(Access Key ID):访问密钥ID。与私有访问密钥关联的唯一标识符;访问密钥ID和私有访问密钥一起使用,对请求进行加密签名。
Required 保留请求。 403 Forbidden 请求被拒绝访问。 返回该状态码,表明请求能够到达服务端,且服务端能够理解用户请求,但是拒绝做更多的事情,因为该请求被设置为拒绝访问,建议直接修改该请求,不要重试该请求。 404 NotFound 所请求的资源不存在。 建议直接修改该请求,不要重试该请求。
Integer 获取的视频流拉流地址的有效时间,设置范围为[600,604800],单位:秒。建议设置为8小时以内。 默认值24小时。 请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 普通租户的token。 Authorization
Token鉴权失败。 400 VIS.0002 项目ID不合法。 403 VIS.0003 请求非当前Region。 403 VIS.0004 服务未开通。 404 VIS.0005 请求参数不合法。 403 VIS.0006 无操作权限。 500 VIS.0007 服务内部错误。
String 根据凭证用户名过滤,支持模糊搜索。 access_key 否 String 根据access_key过滤,支持模糊查询索。 请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 普通租户的token。 Authorization
终端节点 终端节点(Endpoint)即调用API的请求地址,不同服务不同区域的终端节点不同,您可以从地区和终端节点中查询所有服务的终端节点。 视频接入服务的终端节点如表1所示,请您根据业务需要选择对应区域的终端节点。 表1 视频接入服务终端节点 区域名称 区域 终端节点(Endpoint)
project_id 是 String 项目ID,获取方法请参考获取项目ID stream_name 是 String 视频流名称 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 普通租户的token。 Authorization
String 按视频流转储状态过滤,可选值如下。 ACTIVE:表示已启用转储。 STOPPED:表示未启用转储。 不区分大小写。 请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 普通租户的token。 Authorization
描述 project_id 是 String 项目ID,获取方法请参考获取项目ID access_key 是 String 凭证AK 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 普通租户的token。 Authorization
t超过数据总条数,则结果返回空列表。 limit 否 Integer 返回结果的最大条目数,取值范围为1~100,默认值为10。 请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 普通租户的token。 Authorization
参数 是否必选 参数类型 描述 project_id 是 String 项目ID device_id 是 String 设备ID 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务
按照设备状态过滤,取值范围。 UNREGISTERED:未注册。 ONLINE:未邀约。 OFFLINE:已下线。 不区分大小写。 请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 普通租户的token。 Authorization
描述 project_id 是 String 项目ID,获取方法请参考获取项目ID access_key 是 String 凭证AK 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 普通租户的token。 Authorization
访问与使用 视频接入服务提供了Web化的管理控制台,以及基于HTTPS请求的API管理方式,您可以将视频接入服务集成到第三方系统后使用。 管理控制台方式 您在注册华为云后,可直接通过视频接入服务控制台访问视频接入服务。 API方式 如果您需要将视频接入服务的功能集成到第三方系统,
y 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目ID 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 普通租户的token。 Authorization
sername作为用户名。 ANONYMOUS:匿名,表示当使用该凭证作为设备凭证时,使用设备的ID作为用户名。 不区分大小写。 请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 普通租户的token。 Authorization
project_id 是 String 项目ID,获取方法请参考获取项目ID stream_name 是 String 视频流名称 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 普通租户的token。 Authorization