调用ListResources查询当前账号可以访问的资源组中的资源列表。
说明 该API支持通过RAM角色方式调用,但不支持角色的会话策略。
本文将提供一个示例,查询当前账号可以访问的资源组中的资源列表。返回结果显示,当前账号仅能访问资源组rg-uPJpP****
中的ECS实例i-23v38****
。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ListResources |
要执行的操作。取值:ListResources。 |
ResourceGroupId | String | 否 | rg-uPJpP**** |
资源组ID。 |
Service | String | 否 | ecs |
云服务ID。 您可以从支持资源组的云服务的云服务编码列获取云服务ID。 |
Region | String | 否 | cn-hangzhou |
地域ID。 |
ResourceType | String | 否 | instance |
资源类型。 关于支持的资源类型,请参见支持资源组的云服务的资源类型列。 |
ResourceId | String | 否 | i-23v38**** |
资源ID。 |
PageNumber | Integer | 否 | 1 |
页码。 起始值:1。默认值:1。 |
PageSize | Integer | 否 | 10 |
分页时每页显示的数据条数。 取值范围:1~100。默认值:10。 |
关于公共请求参数的详情,请参见公共参数。
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
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 |
云服务ID。 |
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数量超出限制。 |
访问错误中心查看更多错误码。