资源池额度管理
资源池额度管理
本模块包含两类能力:
- 资源池(01–13):为子账号或设备通道配置流量额度池,在 Open SDK、轻应用、直播地址(HLS/FLV/RTMP)等场景下限制池内累计播放流量。概念与步骤见 资源池额度管理、配置资源池流量额度。
- OAuth 场景(14–15):为 OAuth 2.0 授权 下的终端用户设置或查询自然月 Media Flow 上限(GB),使用
Ot_token,与子账号/通道入池无关。概念见 OAuth 终端用户流量额度。
每个方法单独一页,permalink 为方法名;参数、示例与错误码在方法页维护。
接口
| 接口 | 说明 |
|---|---|
| createResourcePool:创建资源池 | 创建流量资源池 |
| getResourcePool:查询资源池详情 | 查询配置与消耗 |
| listResourcePoolByPage:分页查询资源池 | 账号下资源池列表 |
| modifyResourcePool:修改资源池配置 | 修改额度或周期 |
| removeResourcePool:删除资源池 | 删除池并解除绑定 |
| bindSubAccountToResourcePool:绑定子账号到资源池 | 子账号入池 |
| bindDeviceToResourcePool:绑定设备通道到资源池 | 设备通道入池 |
| unbindSubAccountFromResourcePool:从资源池移除子账号 | 子账号出池 |
| unbindDeviceFromResourcePool:从资源池移除设备通道 | 设备通道出池 |
| listSubAccountResourcePoolConfigByPage:分页查询池中子账号 | 池内子账号列表 |
| listDeviceResourcePoolConfigByPage:分页查询池中设备通道 | 池内通道列表 |
| getSubAccountResourcePoolConfig:查询子账号关联的资源池 | 按 openId 反查 |
| getDeviceResourcePoolConfig:查询设备通道关联的资源池 | 按设备通道反查 |
| queryOauthUserQuota:查询 OAuth 用户流量额度 | OAuth 终端用户本月流量额度(GB) |
| saveOauthUserQuota:设置 OAuth 用户流量额度 | 设置 OAuth 终端用户每月流量额度(GB) |
说明
createResourcePool等 01–13 方法仅支持管理员 accessToken(At_前缀)。queryOauthUserQuota/saveOauthUserQuota须传终端用户 OAuth token(Ot_前缀),见 oauthTokenV2;面向 OAuth 2.0 授权 流量限额,与子账号/设备通道资源池不同。- 不存在或不属于当前开发者账号的
resourcePoolKey,可能返回鉴权/权限类错误码,见 错误码。 - 达到池上限时,播放可能返回
FL1008(子账号维度)或FL1009(设备通道维度),见 错误码 · FL。 - 账号级带宽/流量套餐与接口日限额见 接口调用限制。
