调用GetAggregator查询账号组详情-配置审计-阿里云

查询账号组的名称、创建时间、成员和账号组类型等。

接口说明

本文将提供一个示例，查询账号组ca-88ea626622af0055****的详情。返回结果显示，账号组名称为Test_Group、账号组描述为测试组、账号组类型为CUSTOM（自定义账号组）、账号组状态为1 （创建完成）等。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

config:GetAggregator

get

*Aggregator

acs:config:*:{#accountId}:aggregator/{#AggregatorId}

无

请求参数

名称	类型	必填	描述	示例值
AggregatorId	string	是	账号组 ID。	ca-88ea626622af0055****
Tag `deprecated`	array<object>	否	资源的标签。该入参已弃用，请忽略，传入不会生效。最多支持绑定 20 个标签。
	object	否	资源的标签。最多支持绑定 20 个标签。
Key	string	否	资源的标签键。最多支持绑定 20 个标签键。	key-1
Value	string	否	资源的标签值。最多支持绑定 20 个标签值。	value-1

关于公共请求参数的详情，请参见公共参数。

返回参数

名称	类型	描述	示例值
	object	无
RequestId	string	请求 ID。	733DD93C-2277-4905-AE0C-0BA95C04B8BC
Aggregator	object	账号组信息。
AggregatorCreateTimestamp	string	创建账号组的时间戳。单位：毫秒。	1623034091000
AggregatorAccounts	array<object>	账号组内的成员信息。
	object	无
RecorderStatus	string	成员的资源监控状态。取值： REGISTRABLE：未注册。 BUILDING：构建中。 REGISTERED：已注册。 REBUILDING：重新构建中。	REGISTERED
AccountId	integer	成员 ID。	171322098523****
AccountType	string	成员归属。仅支持 ResourceDirectory（资源目录）。	ResourceDirectory
AccountName	string	成员名称。	Alice
AggregatorAccountCount	integer	账号组内成员的数量。	2
Description	string	账号组描述。	The description of the aggregator.
AggregatorName	string	账号组名称。	Test_Group
AggregatorStatus	integer	账号组状态。取值： 0：创建中。 1：创建完成。	1
AggregatorType	string	账号组类型。取值： RD：全局账号组。 FOLDER：资源夹账号组。 CUSTOM：自定义账号组。	CUSTOM
AccountId	integer	创建账号组的管理账号 ID。	100931896542****
AggregatorId	string	账号组 ID。	ca-88ea626622af0055****
FolderName	string	资源夹账号组绑定的资源夹名称。多值以半角逗号分隔。	Example-name
Tags	array<object>	资源标签。
	object	资源标签。
TagKey	string	标签键。	key-1
TagValue	string	标签值。	value-1
FolderId	string	资源夹账号组绑定的资源夹 ID。	fd-brHdgv****

示例

正常返回示例

JSON格式

{
  "RequestId": "733DD93C-2277-4905-AE0C-0BA95C04B8BC",
  "Aggregator": {
    "AggregatorCreateTimestamp": "1623034091000",
    "AggregatorAccounts": [
      {
        "RecorderStatus": "REGISTERED",
        "AccountId": 0,
        "AccountType": "ResourceDirectory",
        "AccountName": "Alice"
      }
    ],
    "AggregatorAccountCount": 2,
    "Description": "The description of the aggregator.",
    "AggregatorName": "Test_Group",
    "AggregatorStatus": 1,
    "AggregatorType": "CUSTOM",
    "AccountId": 0,
    "AggregatorId": "ca-88ea626622af0055****",
    "FolderName": "Example-name",
    "Tags": [
      {
        "TagKey": "key-1",
        "TagValue": "value-1"
      }
    ],
    "FolderId": "fd-brHdgv****"
  }
}

错误码

HTTP status code	错误码	错误信息	描述
400	Invalid.AggregatorId.Value	The specified AggregatorId is invalid.	账号组ID不存在或无权限使用该账号组。
404	AccountNotExisted	Your account does not exist.
503	ServiceUnavailable	The request has failed due to a temporary failure of the server.	服务不可用。

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。