调用ListResourceGroups查询资源组列表。

本文将提供一个示例，查询当前账号下的资源组列表。返回结果显示，一共存在2个资源组。

调试

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

请求参数

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

要执行的操作。取值：ListResourceGroups。

Status String 否 OK

资源组状态。

  • Creating：创建中。
  • OK：创建成功。
  • PendingDelete：等待删除。
PageNumber Integer 否 1

页码。

起始值：1。默认值：1。
PageSize Integer 否 10

分页时每页显示的数据条数。

取值范围：1~100。默认值：10。

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

返回数据

名称 类型 示例值 描述
TotalCount Integer 2

数据总条数。
RequestId String 4B450CA1-36E8-4AA2-8461-86B42BF4CC4E

请求ID。
PageSize Integer 10

每页条数。
PageNumber Integer 1

页码。
ResourceGroups Array of ResourceGroup

资源组信息。
ResourceGroup
DisplayName String my-project

资源组显示名称。
Status String OK

资源组状态。

  • Creating：创建中。
  • OK：创建成功。
  • PendingDelete：等待删除。
AccountId String 123456789****

资源组所属的阿里云账号ID。
Name String my-project

资源组唯一标识。
CreateDate String 2015-01-23T12:33:18Z

资源组创建时间（UTC时间）。
Id String rg-9gLOoK****

资源组ID。

示例

请求示例

https://resourcemanager.aliyuncs.com/?Action=ListResourceGroups
&<公共请求参数>

正常返回示例

XML格式 

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

<?xml version="1.0" encoding="UTF-8" ?>
<ListResourceGroupsResponse>
	<RequestId>4B450CA1-36E8-4AA2-8461-86B42BF4CC4E</RequestId>
	<PageNumber>1</PageNumber>
	<PageSize>10</PageSize>
	<TotalCount>2</TotalCount>
	<ResourceGroups>
		<ResourceGroups>
			<Id>rg-1hSBH2****</Id>
			<AccountId>123456789****</AccountId>
			<Name>default</Name>
			<DisplayName>默认资源组</DisplayName>
			<Status>OK</Status>
			<CreateDate>2015-01-23T12:33:18Z</CreateDate>
		</ResourceGroups>
		<ResourceGroups>
			<Id>rg-9gLOoK****</Id>
			<AccountId>123456789****</AccountId>
			<Name>my-project</Name>
			<DisplayName>my-project</DisplayName>
			<Status>OK</Status>
			<CreateDate>2015-01-23T12:33:18Z</CreateDate>
		</ResourceGroups>
	</ResourceGroups>
</ListResourceGroupsResponse>

JSON格式 

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

{
  "RequestId" : "4B450CA1-36E8-4AA2-8461-86B42BF4CC4E",
  "PageNumber" : 1,
  "PageSize" : 10,
  "TotalCount" : 2,
  "ResourceGroups" : {
    "ResourceGroups" : [ {
      "Id" : "rg-1hSBH2****",
      "AccountId" : "123456789****",
      "Name" : "default",
      "DisplayName" : "默认资源组",
      "Status" : "OK",
      "CreateDate" : "2015-01-23T12:33:18Z"
    }, {
      "Id" : "rg-9gLOoK****",
      "AccountId" : "123456789****",
      "Name" : "my-project",
      "DisplayName" : "my-project",
      "Status" : "OK",
      "CreateDate" : "2015-01-23T12:33:18Z"
    } ]
  }
}

错误码

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