可授权的资源及操作

注意:

本文档主要介绍 实时音视频 TRTC 访问管理功能的相关内容,其他产品访问管理相关内容请参见 支持 CAM 的产品

访问管理的核心功能可以表达为:允许或禁止某账号对某些资源进行某些操作。TRTC 访问管理支持 资源级授权,资源的粒度是 TRTC 应用,操作的粒度是 云 API,包括 服务端 API 以及访问 TRTC 控制台时可能会用到的 API。

如有 TRTC 访问管理需求,请登录腾讯云 主账号 使用 预设策略自定义策略 完成具体授权操作。

可授权的资源类型

TRTC 访问管理可授权的资源类型为 应用

支持资源级授权的 API

除了部分 不支持资源级授权的 API ,本小节列出的所有 API 操作均支持资源级授权。 授权策略语法 中对这些 API 操作的资源语法描述均相同,具体为:

  • 授权所有应用访问权限:qcs::trtc::uin/${uin}:sdkappid/*
  • 授权单个应用访问权限:qcs::trtc::uin/${uin}:sdkappid/${SdkAppId}

服务端 API 操作

接口名称接口分类功能描述
DismissRoom房间管理解散房间
RemoveUser房间管理移出用户
RemoveUserByStrRoomId房间管理移出用户(字符串房间号)
DismissRoomByStrRoomId房间管理解散房间(字符串房间号)
StartMCUMixTranscode混流转码启动云端混流
StopMCUMixTranscode混流转码结束云端混流转码
StartMCUMixTranscodeByStrRoomId混流转码启动云端混流(字符串房间号)
StopMCUMixTranscodeByStrRoomId混流转码结束云端混流(字符串房间号)
CreateTroubleInfo通话质量监控创建异常信息
DescribeAbnormalEvent通话质量监控查询异常体验事件
DescribeCallDetail通话质量监控查询用户列表与通话指标
DescribeHistoryScale通话质量监控查询历史房间和用户数
DescribeRoomInformation通话质量监控查询房间列表
DescribeUserInformation通话质量监控查询历史用户列表

控制台 API 操作

接口名称使用模块功能描述
DescribeAppStatListTRTC 控制台获取应用列表
DescribeSdkAppInfoTRTC 控制台 应用管理 > 应用信息获取应用信息
ModifyAppInfoTRTC 控制台 应用管理 > 应用信息编辑应用信息
ChangeSecretKeyFlagTRTC 控制台 应用管理 > 应用信息修改权限密钥状态
CreateWatermarkTRTC 控制台 应用管理 > 素材管理上传图片
DeleteWatermarkTRTC 控制台 应用管理 > 素材管理删除图片
ModifyWatermarkTRTC 控制台 应用管理 > 素材管理编辑图片
DescribeWatermarkTRTC 控制台 应用管理 > 素材管理查找图片
CreateSecretTRTC 控制台 应用管理 > 快速上手创建对称式加密密钥
ToggleSecretVersionTRTC 控制台应用管理 > 快速上手切换密钥版本(公私钥/对称式加密密钥)
DescribeSecretTRTC 控制台获取对称式加密密钥
DescribeTrtcAppAndAccountInfoTRTC 控制台 开发辅助 > UserSig 生成&校验获取应用及账号信息来获取公私钥
CreateSecretUserSigTRTC 控制台 开发辅助 > UserSig 生成&校验使用对称式加密密钥生成 UserSig
DescribeSigTRTC 控制台获取使用旧版公私钥生成的UserSig
VerifySecretUserSigTRTC 控制台 开发辅助 > UserSig 生成&校验对称式加密密钥生成的 UserSig 校验
VerifySigTRTC 控制台 开发辅助 > UserSig 生成&校验公私钥生成的 UserSig 校验
CreateSpearConfTRTC 控制台 应用管理 > 画面设定新增画面设定配置。此功能设置卡片仅对 iLiveSDK 1.9.6 及之前的版本可见,TRTC SDK 6.0及以后版本请参见 设定画面质量
DeleteSpearConfTRTC 控制台 应用管理 > 画面设定删除画面设定配置。此功能设置卡片仅对 iLiveSDK 1.9.6 及之前的版本可见,TRTC SDK 6.0及以后版本请参见 设定画面质量
ModifySpearConfTRTC 控制台 应用管理 > 画面设定修改画面设定配置。此功能设置卡片仅对 iLiveSDK 1.9.6 及之前的版本可见,TRTC SDK 6.0及以后版本请参见 设定画面质量
DescribeSpearConfTRTC 控制台 应用管理 > 画面设定获取画面设定配置。此功能设置卡片仅对 iLiveSDK 1.9.6 及之前的版本可见,TRTC SDK 6.0及以后版本请参见 设定画面质量
ToggleSpearSchemeTRTC 控制台 应用管理 > 画面设定切换画面设定场景。此功能设置卡片仅对 iLiveSDK 1.9.6 及之前的版本可见,TRTC SDK 6.0及以后版本请参见 设定画面质量

不支持资源级授权的 API

由于特殊限制,下述 API 不支持资源级授权:

服务端 API 操作

接口名称接口分类功能描述特殊限制说明
DescribeDetailEvent通话质量监控获取详细事件输入参数无 SDKAppID ,无法进行资源级授权。
DescribeRecordStatistic其他接口查询云端录制计费时长业务原因,暂不支持资源级授权
DescribeTrtcInteractiveTime其他接口查询音视频互动计费时长业务原因,暂不支持资源级授权
DescribeTrtcMcuTranscodeTime其他接口查询旁路转码计费时长业务原因,暂不支持资源级授权

控制台 API 操作

接口名称使用模块功能描述特殊限制说明
DescribeTrtcStatisticTRTC 控制台获取计费时长用量统计数据该接口包含返回全量 SDKAppID 的统计数据,限制非全量 SDKAppID 将返回错误。如有需要,可通过 DescribeAppStatList 接口来限制可查询的应用列表
DescribeDurationPackagesTRTC 控制台获取预付费套餐包列表预付费套餐包为单个腾讯云账号下的所有 TRTC 应用共享,套餐包信息中无 SDKAppID 参数,无法进行资源级授权
GetUserListTRTC 控制台 监控仪表盘获取用户列表输入参数无 SDKAppID,无法进行资源级授权。如有需要,可通过 DescribeAppStatList 接口来限制可查询的应用列表
GetUserInfoTRTC 控制台 监控仪表盘获取用户信息输入参数无 SDKAppID,无法进行资源级授权。如有需要,可通过 DescribeAppStatList 接口来限制可查询的应用列表
GetCommStateTRTC 控制台 监控仪表盘获取通话状态输入参数无 SDKAppID,无法进行资源级授权。如有需要,可通过 DescribeAppStatList 接口来限制可查询的应用列表
GetElasticSearchDataTRTC 控制台 监控仪表盘查询 ES 数据输入参数无 SDKAppID,无法进行资源级授权。如有需要,可通过 DescribeAppStatList 接口来限制可查询的应用列表
CreateTrtcAppTRTC 控制台 创建 TRTC 应用输入参数无 SDKAppID,无法进行资源级授权。SDKAppID 是 TRTC 应用的唯一标识,创建应用之后才有 SDKAppID 信息
HardDescribeMixConfTRTC 控制台 应用管理 > 功能配置查询自动旁路推流状态输入参数无 SDKAppID,无法进行资源级授权。如有需要,可通过 DescribeAppStatList 接口来限制可查询的应用列表
ModifyMixConfTRTC 控制台 应用管理 > 功能配置开启/关闭自动旁路推流输入参数无 SDKAppID,无法进行资源级授权。如有需要,可通过 DescribeAppStatList 接口来限制可查询的应用列表
RemindBalanceTRTC 控制台 套餐包管理获取预付费套餐包余额告警信息预付费套餐包为单个腾讯云账号下的所有 TRTC 应用共享,套餐包信息中无 SDKAppID 参数,无法进行资源级授权
注意:

针对不支持资源级授权的 API 操作,您仍然可以通过 自定义策略 向用户授予使用该操作的权限,但是策略语句的资源元素必须指定为*