调用 DeleteSubAccount 接口，删除指定子账号。子账号删除后，对应的 IAM 用户不会被删除。
注意事项
- 请求频率：单用户请求频率限制为 10 次/秒。
- 前提条件：确保您拥有火山引擎主账号或具备账户中心 > 权限管理 > 可编辑权限的子账号。有关如何添加子账号，详见子账号管理。
请求说明
- 请求方式：POST
- 请求地址：https://livesaas.volcengineapi.com/?Action=DeleteSubAccount&Version=2023-08-01
请求参数
下表仅列出该接口特有的请求参数和部分公共参数。更多信息详见公共参数。
Query
| 参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|
| Action | String | 是 | DeleteSubAccount | 接口名称。当前 API 的名称为 DeleteSubAccount。 |
| Version | String | 是 | 2023-08-01 | 接口版本。当前 API 的版本为 2023-08-01。 |
Body
| 参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|
| Name | String | 是 | on_22222222222222 | 子账号的账号，是子账号的唯一标识。您可通过调用 ListSubAccounts 接口获取账号。 |
返回参数
| 参数 | 类型 | 示例值 | 描述 |
|---|
| Status | Boolean | true | 子账号是否删除成功。成功返回 true。 |
请求示例
POST https://livesaas.volcengineapi.com/?Action=DeleteSubAccount&Version=2023-08-01
{
"Name": "on_22222222222222"
}
返回示例
{
"ResponseMetadata": {
"RequestId": "20230604110420****100232280022D31",
"Action": "DeleteSubAccount",
"Version": "2023-08-01",
"Service": "livesaas",
"Region": "cn-north-1",
"SystemTime": 1697446406
},
"Result": {
"Status": true
}
}
错误码
访问公共错误码和错误码获取详细信息。