调用 ListSubAccountRoles 接口获取子账号的角色列表，包含角色的 ID、名称和类型。
请求频率：单用户请求频率限制为 10 次/秒。
下表仅列出该接口特有的请求参数和部分公共参数。更多信息详见公共参数。
| 参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | ListSubAccountRoles | 接口名称。当前 API 的名称为 ListSubAccountRoles。 |
| Version | String | 是 | 2023-08-01 | 接口版本。当前 API 的版本为 2023-08-01。 |
| KeyWord | String | 否 | A | 角色名称。支持模糊搜索，大小写不敏感。 例如，该参数取值为 A，则返回角色 A、角色 ab 等名称的角色。 |
| PageNumber | Integer | 否 | 1 | 分页查询页码。默认值为 1。取值大于等于 1。 |
| PageSize | Integer | 否 | 100 | 分页查询数量。默认值为 10。取值范围为 [1,100]。 |
| 参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| TotalCount | Long | 1 | 查询结果总数。 |
| Roles | Array of Roles | - | 角色列表。 |
| 参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| Id | Long | 181432****480235 | 角色 ID。 |
| Name | String | 运营 A | 角色名称。 |
Type | Integer |
| 角色类型。取值如下：
|
GET https://livesaas.volcengineapi.com/?Action=ListSubAccountRoles&Version=2023-08-01&KeyWord=A&PageNumber=1&PageSize=100
{ "ResponseMetadata": { "RequestId": "20230604110420****100232280022D31", "Action": "ListSubAccountRoles", "Version": "2023-08-01", "Service": "livesaas", "Region": "cn-north-1", "SystemTime": 1697446406 }, "Result": { "TotalCount": 1, "Roles": [ { "Id": 181432****480235, "Name": "运营 A", "Type": 4 } ] } }