调用GetAggregator接口查询账号组详情。

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

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String GetAggregator

要执行的操作,取值:GetAggregator

AggregatorId String ca-88ea626622af0055****

账号组ID。

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

返回数据

名称 类型 示例值 描述
RequestId String 733DD93C-2277-4905-AE0C-0BA95C04B8BC

请求ID。

Aggregator Object

账号组信息。

AggregatorCreateTimestamp String 1623034091000

创建账号组的时间戳。

AggregatorAccounts Array of AggregatorAccounts

账号组内的成员账号信息。

RecorderStatus String 2

成员账号的资源监控状态。取值:

  • REGISTRABLE:未注册。
  • BUILDING:构建中。
  • REGISTERED:已注册。
  • REBUILDING:重新构建中。
AccountId Long 171322098523****

成员账号ID。

AccountType String ResourceDirectory

成员账号归属。仅支持ResourceDirectory(资源目录)。

AccountName String Alice

成员账号名称。

AggregatorAccountCount Long 2

账号组内成员账号的数量。

Description String 测试组

账号组描述。

AggregatorName String Test_Group

账号组名称。

AggregatorStatus Integer 1

账号组状态。取值:

  • 0:创建中。
  • 1:创建完成。
AggregatorType String CUSTOM

账号组类型。取值:

  • RD:全局账号组。
  • CUSTOM:自定义账号组。
AccountId Long 100931896542****

创建账号组的企业管理账号ID。

AggregatorId String ca-88ea626622af0055****

账号组ID。

示例

请求示例

http(s)://[Endpoint]/?Action=GetAggregator
&AggregatorId=ca-88ea626622af0055****
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<GetAggregatorResponse>
	<RequestId>733DD93C-2277-4905-AE0C-0BA95C04B8BC</RequestId>
	<Aggregator>
		<AggregatorName>Test_Group</AggregatorName>
		<AccountId>100931896542****</AccountId>
		<Description>测试组</Description>
		<AggregatorAccounts>
			<AccountId>171322098523****</AccountId>
			<RecorderStatus>REGISTERED</RecorderStatus>
			<AccountType>ResourceDirectory</AccountType>
			<AccountName>Alice</AccountName>
		</AggregatorAccounts>
		<AggregatorAccounts>
			<AccountId>100532098349****</AccountId>
			<RecorderStatus>REGISTERED</RecorderStatus>
			<AccountType>ResourceDirectory</AccountType>
			<AccountName>Tom</AccountName>
		</AggregatorAccounts>
		<AggregatorCreateTimestamp>1623034091000</AggregatorCreateTimestamp>
		<AggregatorAccountCount>2</AggregatorAccountCount>
		<AggregatorStatus>1</AggregatorStatus>
		<AggregatorType>CUSTOM</AggregatorType>
		<AggregatorId>ca-88ea626622af0055****</AggregatorId>
	</Aggregator>
</GetAggregatorResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "733DD93C-2277-4905-AE0C-0BA95C04B8BC",
  "Aggregator" : {
    "AggregatorName" : "Test_Group",
    "AccountId" : "100931896542****",
    "Description" : "测试组",
    "AggregatorAccounts" : [ {
      "AccountId" : "171322098523****",
      "RecorderStatus" : "REGISTERED",
      "AccountType" : "ResourceDirectory",
      "AccountName" : "Alice"
    }, {
      "AccountId" : "100532098349****",
      "RecorderStatus" : "REGISTERED",
      "AccountType" : "ResourceDirectory",
      "AccountName" : "Tom"
    } ],
    "AggregatorCreateTimestamp" : 1623034091000,
    "AggregatorAccountCount" : 2,
    "AggregatorStatus" : 1,
    "AggregatorType" : "CUSTOM",
    "AggregatorId" : "ca-88ea626622af0055****"
  }
}

错误码

HttpCode 错误码 错误信息 描述
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. 服务不可用。

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