资源目录中的管理账号或委派管理员账号可以删除账号组。
接口说明
背景信息
删除账号组之后,配置审计变化如下:
-
账号组中的规则和合规包自动被删除,且不可恢复。
-
账号组中产生的所有合规结果自动被删除,且不可恢复。
-
账号组中成员的配置审计服务关联角色被保留。
-
如果某个成员所属的账号组均被删除,则该成员作为独立的阿里云账号使用配置审计服务。
使用说明
本文将提供一个示例,删除账号组ca-9190626622af00a9****。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
config:DeleteAggregators |
delete |
*Aggregator
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| AggregatorIds |
string |
是 |
账号组 ID。多个账号组 ID 之间用半角逗号(,)分隔。 |
ca-9190626622af00a9**** |
| ClientToken |
string |
否 |
保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符,且不能超过 64 个字符。 |
AAAAAdDWBF2**** |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
返回结果。 |
||
| RequestId |
string |
请求 ID。 |
8195B664-9565-4685-89AC-8B5F04B44B92 |
| OperateAggregatorsResult |
object |
删除账号组的操作结果。 |
|
| OperateAggregators |
array<object> |
账号组信息。 |
|
|
object |
账号组操作结果。 |
||
| ErrorCode |
string |
错误码。 说明
如果删除账号组成功,则错误码为空。 |
AccountNotExisted |
| Success |
boolean |
操作是否成功。取值:
|
false |
| AggregatorId |
string |
账号组 ID。 |
ca-dacf86d8314e00eb**** |
示例
正常返回示例
JSON格式
{
"RequestId": "8195B664-9565-4685-89AC-8B5F04B44B92",
"OperateAggregatorsResult": {
"OperateAggregators": [
{
"ErrorCode": "AccountNotExisted",
"Success": false,
"AggregatorId": "ca-dacf86d8314e00eb****"
}
]
}
}
错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | NoPermission | You are not authorized to perform this operation. | 您无权执行此操作。 |
| 400 | Invalid.AggregatorIds.Empty | You must specify AggregatorIds. | 账号组ID列表不能为空。 |
| 400 | Invalid.AggregatorIds.SizeExceed | The maximum number of AggregatorIds is 5. | 账号组ID不能超过5个。 |
| 403 | AggregatorMemberNoPermission | The aggregator member is not authorized to perform the operation. | 账号组内的成员账号无权限执行此操作。 |
| 404 | AccountNotExisted | Your account does not exist. | |
| 503 | ServiceUnavailable | The request has failed due to a temporary failure of the server. | 服务不可用。 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。