注意
访问管理的核心功能可以表达为:允许或禁止某账号对某些资源进行某些操作。TRTC 访问管理支持 资源级授权,资源的粒度是 TRTC 应用,操作的粒度是 云 API,包括 服务端 API 以及访问 TRTC 控制台时可能会用到的 API。
可授权的资源类型
支持资源级授权的 API
授权所有应用访问权限:
qcs::trtc::uin/${uin}:sdkappid/*
。授权单个应用访问权限:
qcs::trtc::uin/${uin}:sdkappid/${SdkAppId}
。服务端 API 操作
接口名称 | 接口分类 | 功能描述 |
房间管理 | 解散房间 | |
房间管理 | 移出用户 | |
房间管理 | 移出用户(字符串房间号) | |
房间管理 | 解散房间(字符串房间号) | |
混流转码 | 启动云端混流 | |
混流转码 | 结束云端混流转码 | |
混流转码 | 启动云端混流(字符串房间号) | |
混流转码 | 结束云端混流(字符串房间号) | |
通话质量监控 | 创建异常信息 | |
通话质量监控 | 查询异常体验事件 | |
通话质量监控 | 查询用户列表与通话指标 | |
通话质量监控 | 查询历史房间和用户数 | |
通话质量监控 | 查询房间列表 | |
通话质量监控 | 查询历史用户列表 |
控制台 API 操作
接口名称 | 使用模块 | 功能描述 |
DescribeAppStatList | TRTC 控制台 概览 用量统计 监控仪表盘 应用管理 | 获取应用列表 |
DescribeSdkAppInfo | TRTC 控制台 应用管理 > 应用信息 | 获取应用信息 |
ModifyAppInfo | TRTC 控制台 应用管理 > 应用信息 | 编辑应用信息 |
ChangeSecretKeyFlag | TRTC 控制台 应用管理 > 应用信息 | 修改权限密钥状态 |
CreateWatermark | TRTC 控制台 应用管理 > 素材管理 | 上传图片 |
DeleteWatermark | TRTC 控制台 应用管理 > 素材管理 | 删除图片 |
ModifyWatermark | TRTC 控制台 应用管理 > 素材管理 | 编辑图片 |
DescribeWatermark | TRTC 控制台 应用管理 > 素材管理 | 查找图片 |
CreateSecret | TRTC 控制台 应用管理 > 快速上手 | 创建对称式加密密钥 |
ToggleSecretVersion | TRTC 控制台应用管理 > 快速上手 | 切换密钥版本(公私钥/对称式加密密钥) |
DescribeSecret | TRTC 控制台 | 获取对称式加密密钥 |
DescribeTrtcAppAndAccountInfo | TRTC 控制台 开发辅助 > UserSig 生成&校验 | 获取应用及账号信息来获取公私钥 |
CreateSecretUserSig | TRTC 控制台 开发辅助 > UserSig 生成&校验 | 使用对称式加密密钥生成 UserSig |
DescribeSig | TRTC 控制台 | 获取使用旧版公私钥生成的UserSig |
VerifySecretUserSig | TRTC 控制台 开发辅助 > UserSig 生成&校验 | 对称式加密密钥生成的 UserSig 校验 |
VerifySig | TRTC 控制台 开发辅助 > UserSig 生成&校验 | 公私钥生成的 UserSig 校验 |
CreateSpearConf | TRTC 控制台 应用管理 > 画面设定 | 新增画面设定配置。此功能设置卡片仅对 iLiveSDK 1.9.6 及之前的版本可见,TRTC SDK 6.0及以后版本请参见 设定画面质量 |
DeleteSpearConf | TRTC 控制台 应用管理 > 画面设定 | 删除画面设定配置。此功能设置卡片仅对 iLiveSDK 1.9.6 及之前的版本可见,TRTC SDK 6.0及以后版本请参见 设定画面质量 |
ModifySpearConf | TRTC 控制台 应用管理 > 画面设定 | 修改画面设定配置。此功能设置卡片仅对 iLiveSDK 1.9.6 及之前的版本可见,TRTC SDK 6.0及以后版本请参见 设定画面质量 |
DescribeSpearConf | TRTC 控制台 应用管理 > 画面设定 | 获取画面设定配置。此功能设置卡片仅对 iLiveSDK 1.9.6 及之前的版本可见,TRTC SDK 6.0及以后版本请参见 设定画面质量 |
ToggleSpearScheme | TRTC 控制台 应用管理 > 画面设定 | 切换画面设定场景。此功能设置卡片仅对 iLiveSDK 1.9.6 及之前的版本可见,TRTC SDK 6.0及以后版本请参见 设定画面质量 |
不支持资源级授权的 API
由于特殊限制,下述 API 不支持资源级授权:
服务端 API 操作
接口名称 | 接口分类 | 功能描述 | 特殊限制说明 |
通话质量监控 | 获取详细事件 | 输入参数无 SDKAppID ,无法进行资源级授权。 | |
其他接口 | 查询云端录制计费时长 | 业务原因,暂不支持资源级授权 | |
其他接口 | 查询音视频互动计费时长 | 业务原因,暂不支持资源级授权 | |
其他接口 | 查询旁路转码计费时长 | 业务原因,暂不支持资源级授权 |
控制台 API 操作
接口名称 | 使用模块 | 功能描述 | 特殊限制说明 |
DescribeTrtcStatistic | TRTC 控制台 概览 用量统计 | 获取计费时长用量统计数据 | 该接口包含返回全量 SDKAppID 的统计数据,限制非全量 SDKAppID 将返回错误。如有需要,可通过 DescribeAppStatList 接口来限制可查询的应用列表 |
DescribeDurationPackages | TRTC 控制台 概览 套餐包管理 | 获取预付费套餐包列表 | 预付费套餐包为单个腾讯云账号下的所有 TRTC 应用共享,套餐包信息中无 SDKAppID 参数,无法进行资源级授权 |
GetUserList | TRTC 控制台 监控仪表盘 | 获取用户列表 | 输入参数无 SDKAppID,无法进行资源级授权。如有需要,可通过 DescribeAppStatList 接口来限制可查询的应用列表 |
GetUserInfo | TRTC 控制台 监控仪表盘 | 获取用户信息 | 输入参数无 SDKAppID,无法进行资源级授权。如有需要,可通过 DescribeAppStatList 接口来限制可查询的应用列表 |
GetCommState | TRTC 控制台 监控仪表盘 | 获取通话状态 | 输入参数无 SDKAppID,无法进行资源级授权。如有需要,可通过 DescribeAppStatList 接口来限制可查询的应用列表 |
GetElasticSearchData | TRTC 控制台 监控仪表盘 | 查询 ES 数据 | 输入参数无 SDKAppID,无法进行资源级授权。如有需要,可通过 DescribeAppStatList 接口来限制可查询的应用列表 |
CreateTrtcApp | TRTC 控制台 应用管理 | 创建 TRTC 应用 | 输入参数无 SDKAppID,无法进行资源级授权。SDKAppID 是 TRTC 应用的唯一标识,创建应用之后才有 SDKAppID 信息 |
HardDescribeMixConf | TRTC 控制台 应用管理 > 功能配置 | 查询自动旁路推流状态 | 输入参数无 SDKAppID,无法进行资源级授权。如有需要,可通过 DescribeAppStatList 接口来限制可查询的应用列表 |
ModifyMixConf | TRTC 控制台 应用管理 > 功能配置 | 开启/关闭自动旁路推流 | 输入参数无 SDKAppID,无法进行资源级授权。如有需要,可通过 DescribeAppStatList 接口来限制可查询的应用列表 |
RemindBalance | TRTC 控制台 套餐包管理 | 获取预付费套餐包余额告警信息 | 预付费套餐包为单个腾讯云账号下的所有 TRTC 应用共享,套餐包信息中无 SDKAppID 参数,无法进行资源级授权 |
注意