可授权的资源及操作

最近更新时间:2021-07-26 11:20:20

注意:

本文档主要介绍 实时音视频 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 房间管理 移出用户
StartMCUMixTranscode 混流转码 启动云端混流
StopMCUMixTranscode 混流转码 结束云端混流转码
CreateTroubleInfo 通话质量监控 创建异常信息
DescribeAbnormalEvent 通话质量监控 查询异常体验事件
DescribeCallDetail 通话质量监控 查询用户列表与通话指标
DescribeHistoryScale 通话质量监控 查询历史房间和用户数
DescribeRealtimeNetwork 通话质量监控 查询实时网络状态
DescribeRealtimeQuality 通话质量监控 查询实时质量数据
DescribeRealtimeScale 通话质量监控 查询实时规模
DescribeRoomInformation 通话质量监控 查询房间列表

控制台 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 操作

接口名称 接口分类 功能描述 特殊限制说明
DescribeDetailEvent 通话质量监控 获取详细事件 输入参数无 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 参数,无法进行资源级授权。
注意:

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

目录