全部产品
Search
文档中心

云控制API:ListResourceTypes - 列举资源类型

更新时间:Aug 28, 2026

列举产品的资源类型。

接口说明

GET /api/v1/providers/{provider}/products/{product}/resourceTypes。

调试

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

调试

授权信息

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

请求语法

GET /api/v1/providers/{provider}/products/{product}/resourceTypes HTTP/1.1

路径参数

名称

类型

必填

描述

示例值

provider

string

云厂商,目前只支持 Aliyun。

Aliyun

product

string

产品 Code。

ECS

请求参数

名称

类型

必填

描述

示例值

x-acs-accept-language

string

选择返回产品的语言。

zh_CH:中文 (默认)

en_US:英文。

枚举值:

  • zh_CH :

    zh_CH

  • en_US :

    en_US

zh_CH

resourceTypes

array

资源类型列表。

string

资源类型。

Instance

nextToken

string

用来标记当前开始读取的位置,置空表示从头开始。

ECS::Disk

maxResults

integer

分页查询时每页行数。

10

返回参数

名称

类型

描述

示例值

object

返回结构。

maxResults

integer

本次请求所返回的最大记录条数。

10

nextToken

string

表示当前调用返回读取到的位置,空代表数据已经读取完毕

ECS::Disk

requestId

string

请求 ID。

473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

resourceTypes

array<object>

资源类型列表。

array<object>

资源类型。

createOnlyProperties

array

创建操作私有参数集合。资源查询操作中不会返回的属性,但是创建操作中需要传入的参数。

string

创建操作私有参数。

/properties/AutoRenew

deleteOnlyProperties

array

删除操作私有参数集合。资源查询操作中不会返回的属性,但是删除操作中需要传入的参数。

string

删除操作私有参数。

/properties/ForceDelete

filterProperties

array

list 操作时可以作为 filter 参数的属性集合。

string

filter 参数。

/properties/ResourceGroupId

getOnlyProperties

array

查询操作私有参数集合。资源查询操作中不会返回的属性,但是查询操作中需要传入的参数。

string

查询操作私有参数。

/properties/DryRun

getResponseProperties

array

查询返回的属性集合。

string

查询返回的属性。

/properties/NetworkInterfaces/items/properties/IpvSets

handlers

object

支持的资源操作信息(包括 RAM 权限)。

create

object

创建操作关联信息。

permissions

array

所需 RAM 权限信息集合。

string

RAM 权限。

ecs:CreateInstance

delete

object

删除操作关联信息。

permissions

array

所需 RAM 权限信息集合。

string

RAM 权限。

ecs:DeleteInstance

get

object

查询操作关联信息。

permissions

array

所需 RAM 权限信息集合。

string

RAM 权限。

ecs:DescribeInstanceAttachmentAttributes

list

object

列举操作关联信息。

permissions

array

所需 RAM 权限信息集合。

string

RAM 权限。

ecs:DescribeInstances

update

object

更新操作关联信息。

permissions

array

所需 RAM 权限信息集合。

string

RAM 权限。

ecs:ModifyInstanceNetworkSpec

info

object

资源类型基础信息。

chargeType

string

付费形式
paid(付费) free(免费)

枚举值:

  • paid :

    paid

  • free :

    free

paid

deliveryScope

string

交付级别

center(中心化部署级别)

region(地域部署级别)

zone(可用区部署级别)

枚举值:

  • zone :

    zone

  • center :

    center

  • region :

    region

region

description

string

资源类型描述。

An ECS instance is equivalent to a virtual machine, including the most basic computing components such as CPU, memory, operating system, network, and disk. You can easily customize and change the configuration of the instance. You have full control over the virtual machine.

title

string

资源类型名称。

Instance

listOnlyProperties

array

列举操作私有参数集合。资源查询操作中不会返回的属性,但是列举操作中需要传入的参数。

string

列举操作私有参数。

/properties/DryRun

listResponseProperties

array

列举返回的属性集合。

string

列举返回的属性。

/properties/InstanceId

primaryIdentifier

string

资源 ID

/properties/InstanceId

product

string

产品 Code。

ECS

properties

object

资源属性定义,key 是属性名,value 为属性详细信息。

publicProperties

array

公共的属性集合,为资源基本属性。非操作私有参数。

string

公共属性。

/properties/Description

readOnlyProperties

array

只读参数集合,只在 list 或者 get 操作中返回,创建及变更时不作为入参。

string

只读参数

/properties/CreateTime

required

array

资源创建必填参数集合。

string

资源创建必填参数。

RegionId

resourceType

string

资源类型。

Instance

sensitiveInfoProperties

array

敏感属性集合,例如密码等。

string

敏感属性。

/properties/VncPassword

updateOnlyProperties

array

更新操作私有参数集合。资源查询操作中不会返回的属性,但是更新操作中需要传入的参数。

string

更新操作私有参数。

/properties/DryRun

updateTypeProperties

array

可以修改的属性集合。

string

可改属性。

/properties/InstanceName

totalCount

integer

本次请求条件下的数据总量。

20

示例

正常返回示例

JSON格式

{
  "maxResults": 10,
  "nextToken": "ECS::Disk",
  "requestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "resourceTypes": [
    {
      "createOnlyProperties": [
        "/properties/AutoRenew"
      ],
      "deleteOnlyProperties": [
        "/properties/ForceDelete"
      ],
      "filterProperties": [
        "/properties/ResourceGroupId"
      ],
      "getOnlyProperties": [
        "/properties/DryRun\n"
      ],
      "getResponseProperties": [
        "/properties/NetworkInterfaces/items/properties/IpvSets"
      ],
      "handlers": {
        "create": {
          "permissions": [
            "ecs:CreateInstance"
          ]
        },
        "delete": {
          "permissions": [
            "ecs:DeleteInstance"
          ]
        },
        "get": {
          "permissions": [
            "ecs:DescribeInstanceAttachmentAttributes"
          ]
        },
        "list": {
          "permissions": [
            "ecs:DescribeInstances"
          ]
        },
        "update": {
          "permissions": [
            "ecs:ModifyInstanceNetworkSpec"
          ]
        }
      },
      "info": {
        "chargeType": "paid",
        "deliveryScope": "region",
        "description": "An ECS instance is equivalent to a virtual machine, including the most basic computing components such as CPU, memory, operating system, network, and disk. You can easily customize and change the configuration of the instance. You have full control over the virtual machine.",
        "title": "Instance"
      },
      "listOnlyProperties": [
        "/properties/DryRun"
      ],
      "listResponseProperties": [
        "/properties/InstanceId"
      ],
      "primaryIdentifier": "/properties/InstanceId",
      "product": "ECS",
      "properties": {
        "test": "test",
        "test2": 1
      },
      "publicProperties": [
        "/properties/Description"
      ],
      "readOnlyProperties": [
        "/properties/CreateTime"
      ],
      "required": [
        "RegionId"
      ],
      "resourceType": "Instance",
      "sensitiveInfoProperties": [
        "/properties/VncPassword"
      ],
      "updateOnlyProperties": [
        "/properties/DryRun"
      ],
      "updateTypeProperties": [
        "/properties/InstanceName"
      ]
    }
  ],
  "totalCount": 20
}

错误码

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

变更历史

更多信息,参考变更详情