文档

ListResources

更新时间:

调用ListResources查询当前账号可以访问的资源组中的资源列表

说明 该API支持通过RAM角色方式调用,但不支持角色的会话策略。

调试

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

请求参数

名称

类型

是否必选

示例值

描述

Action String ListResources

要执行的操作。取值:ListResources

ResourceGroupId String rg-uPJpP****

资源组ID。

Service String ecs

云服务代码。

您可以从支持资源组的云服务云服务代码列获取。

Region String cn-hangzhou

地域ID。

ResourceType String instance

资源类型。

您可以从支持资源组的云服务资源类型列获取。

ResourceId String i-23v38****

资源ID。

PageNumber Integer 1

页码。

起始值:1。默认值:1。

PageSize Integer 10

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

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

ResourceTypes.N.Service String ecs

云服务代码。

N的取值范围:1~50。

您可以从支持资源组的云服务云服务代码列获取。

说明 ResourceTypes中的ServiceResourceType参数必须同时设置,否则将不生效。
ResourceTypes.N.ResourceType String instance

资源类型。

N的取值范围:1~50。

您可以从支持资源组的云服务资源类型列获取。

说明 ResourceTypes中的ServiceResourceType参数必须同时设置,否则将不生效。

返回数据

名称

类型

示例值

描述

TotalCount Integer 1

数据总条数。

RequestId String 04F0F334-1335-436C-A1D7-6C044FE73368

请求ID。

PageSize Integer 10

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

PageNumber Integer 1

页码。

Resources Array of Resource

资源信息。

Resource
Service String ecs

云服务代码。

ResourceType String instance

资源类型。

ResourceGroupId String rg-uPJpP****

资源组ID。

ResourceId String i-23v38****

资源ID。

CreateDate String 2015-01-23T12:33:18Z

资源创建时间(UTC时间)。

RegionId String cn-hangzhou

地域ID。

示例

请求示例

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

正常返回示例

XML格式

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

<?xml version="1.0" encoding="UTF-8" ?>
<ListResourcesResponse>
	<RequesgtId>04F0F334-1335-436C-A1D7-6C044FE73368</RequesgtId>
	<PageNumber>1</PageNumber>
	<PageSize>10</PageSize>
	<TotalCount>1</TotalCount>
	<Resources>
		<Resource>
			<ResourceGroupId>rg-uPJpP****</ResourceGroupId>
			<Service>ecs</Service>
			<ResourceType>instance</ResourceType>
			<ResourceId>i-23v38****</ResourceId>
			<RegionId>cn-hangzhou</RegionId>
			<CreateDate>2015-01-23T12:33:18Z</CreateDate>
		</Resource>
	</Resources>
</ListResourcesResponse>

JSON格式

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

{
  "RequesgtId" : "04F0F334-1335-436C-A1D7-6C044FE73368",
  "PageNumber" : 1,
  "PageSize" : 10,
  "TotalCount" : 1,
  "Resources" : {
    "Resource" : [ {
      "ResourceGroupId" : "rg-uPJpP****",
      "Service" : "ecs",
      "ResourceType" : "instance",
      "ResourceId" : "i-23v38****",
      "RegionId" : "cn-hangzhou",
      "CreateDate" : "2015-01-23T12:33:18Z"
    } ]
  }
}

错误码

HttpCode

错误码

错误信息

描述

400 InvalidParameter.ResourceIds The ResourceIds is invalid. 参数ResourceIds无效。
400 LimitExceeded.ResourceIds The maximum number of ResourceId is exceeded. ResourceId数量超出限制。

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