全部产品
Search
文档中心

资源管理:ListResources - 查看当前账号可以访问的资源列表

更新时间:Jun 05, 2024

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

接口说明

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

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
ResourceGroupIdstring

资源组 ID。

rg-uPJpP****
Servicestring

云服务代码。

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

ecs
Regionstring

地域 ID。

cn-hangzhou
ResourceTypestring

资源类型。

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

instance
ResourceIdstring

资源 ID。

i-23v38****
PageNumberinteger

页码。

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

1
PageSizeinteger

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

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

10
ResourceTypesobject []

资源类型列表。最多支持 50 组。

说明 如果您设置了ResourceTypes,则请求参数中单独设置的ServiceResourceType将不生效。
Servicestring

云服务代码。

N 的取值范围:1~50。

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

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

资源类型。

N 的取值范围:1~50。

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

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

返回参数

名称类型描述示例值
object

返回结果。

TotalCountinteger

数据总条数。

1
RequestIdstring

请求 ID。

04F0F334-1335-436C-A1D7-6C044FE73368
PageSizeinteger

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

10
PageNumberinteger

页码。

1
Resourcesobject []

资源信息。

Servicestring

云服务代码。

ecs
ResourceTypestring

资源类型。

instance
ResourceGroupIdstring

资源组 ID。

rg-uPJpP****
ResourceIdstring

资源 ID。

i-23v38****
CreateDatestring

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

2015-01-23T12:33:18Z
RegionIdstring

地域 ID。

cn-hangzhou

示例

正常返回示例

JSON格式

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

错误码

HTTP status code错误码错误信息描述
400InvalidParameter.ResourceIdsThe ResourceIds is invalid.参数ResourceIds无效。
400LimitExceeded.ResourceIdsThe maximum number of ResourceId is exceeded.ResourceId数量超出限制。

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

变更历史

变更时间变更内容概要操作
2023-07-26OpenAPI 错误码发生变更、OpenAPI 入参发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    删除错误码:400
入参OpenAPI 入参发生变更
    新增入参:ResourceTypes