● 在认证鉴权章节,需要填入账号名、用户名或者AK/SK。
● 在调用API的时候,部分URL中需要填入项目ID(project_id)。
由于获取方法一样,所以这里放在一起介绍操作步骤。
从控制台获取项目 ID
1. 登录管理控制台。
2. 鼠标移动到右上角的用户名上,在下拉列表中选择“我的凭证”。
3. 在“我的凭证”页面,可以查看用户名、账号名,在项目列表中查看项目ID。
图11-1 查看账号 ID/项目 ID
4. 单击“管理访问密钥”,可以查看已添加的访问密钥ID(Access Key ID,AK)。
– 如果没有AK/SK,可单击“新增访问密钥”来添加。
– 如果已生成过AK/SK,找到原来已下载的AK/SK文件,文件名一般为:
credentials.csv。
调用 API 获取项目 ID
项目ID还用通过调用查询指定条件下的项目信息API获取。
获取项目ID的接口为“GET https://{Endpoint}/v3/projects”,其中{Endpoint}为IAM 的终端节点,可以从地区和终端节点获取。接口的认证鉴权请参见认证鉴权。
响应示例如下,例如VIS部署的区域为"cn-north-4",相应消息体中查找“name”为
"cn-north-4",其中projects下的“id”即为项目ID。
{ "projects": [ {
"domain_id": "65382450e8f64ac0870cd180d14e684b", "is_domain": false,
"parent_id": "65382450e8f64ac0870cd180d14e684b", "name": "cn-north-4",
"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"
} }
A 修订记录
发布日期 修改说明
2021-11-12 第九次正式发布 本次变更如下:
● 开通服务、获取服务开通信息接口中响应参数增加
http_num,http_active_num,rtmp_num。
● 新增更新桶授权、获取桶信息列表接口。
● 补充更新转储信息接口描述信息。
2021-09-27 第八次正式发布 本次变更如下:
● 获取视频流地址接口中增加请求参数expire_time。
● 修改创建视频流接口中推流鉴权规则的地址链接。
2021-09-22 第七次正式发布 本次变更如下:
修改开通服务、创建视频流、创建GB/T28181凭证和创建 AK/SK凭证接口中创建成功的状态码200为201。
2021-09-18 第六次正式发布 本次变更如下:
● 删除更新GB/T28181设备通道信息接口中请求体的 suffix字段,接口约束说明不允许修改后缀。
● 修改获取视频流信息接口Stream_Flow_Info的部分字 段无法提供数据说明。
● 修改获取视频包接受率接口功能介绍说明。
发布日期 修改说明 2021-08-23 第五次正式发布
本次变更如下:
● 删除更新转储信息接口的retention_forever字段,并修 改响应示例。
● 修改获取视频流地址接口的请求和响应示例,增加防盗 链提示。
2021-02-02 第四次正式发布 本次变更如下:
修改更新转储信息、获取视频流地址、创建GB/T28181设 备通道、获取设备列表接口。
2019-08-07 第三次正式发布 本次变更如下:
● 新增获取新上线设备列表、获取新掉线设备列表、获取 长期不在线设备列表、获取近期掉线的设备列表、获取 在线未推流设备列表、获取曾经上线设备列表、获取视 频包接收率接口。
● 修改获取服务开通信息、获取视频流信息、获取视频流 列表接口。
2019-04-30 第二次正式发布 本次变更如下:
● GB/T28181设备支持NVR类型,新增以下接口:
– 获取NVR设备通道列表
– 更新NVR设备通道列表
– 删除GB/T28181设备
● 部分接口增加retention_forever(是否永久保存)参 数。
● 更新错误码中的“错误码说明”。
2019-02-28 第一次正式发布。