DescribeInstanceTypes

1. 接口描述

调用本接口用于查询实例机型配置。

注意事项

DescribeInstanceTypes仅查询实例机型的配置和性能信息，如果您需要查询具体地域下可购买的实例机型，请查询 DescribeAvailableResources。

2. 请求参数

以下请求参数列表仅列出了接口中需要的请求参数

参数名称	必选	类型	描述
instanceTypeIds	否	Array of String	实例机型ID。 数量不超过100个。
minimumCpuCoreCount	否	Integer	查询实例机型时，期望最小CPU内核的数目。 取值范围：正整数。
maximumCpuCoreCount	否	Integer	查询实例机型时，期望最大CPU内核的数目。 取值范围：正整数。
minimumMemorySize	否	Integer	查询实例机型时，期望最小内存大小。 取值范围：正整数。 单位：GB。
maximumMemorySize	否	Integer	查询实例机型时，期望最大内存大小。 取值范围：正整数。 单位：GB。
minimumBandwidth	否	Integer	查询实例机型时，期望最小公网入方向带宽限制。 单位：Mbps。
supportRaids	否	Array of Integer	查询实例机型时，对实例机型做raid时所支持的raid类型。 Raid可选值包括：0, 1, 5, 10。
supportSubnet	否	Boolean	查询实例机型时，机型是否支持内网组网。
minimumDiskSize	否	Integer	查询实例机型时，期望最小磁盘大小。 取值范围：正整数。 单位：GB。
maximumDiskSize	否	Integer	查询实例机型时，期望最大磁盘大小。 取值范围：正整数。 单位：GB。
isHA	否	Boolean	查询实例机型时，是否是高可用机型。
imageId	否	String	查询实例机型时，支持某镜像的机型。

3. 响应结果

参数名称	类型	描述
instanceTypes	Array of InstanceType	查询的机型信息。
requestId	String	唯一请求 ID。 每次请求都会返回。定位问题时需要提供该次请求的 requestId。

4. 代码示例

示例

1. 获取所有的机型。

POST /api/v2/bmc HTTP/1.1
Host: console.zenlayer.com
Content-Type: application/json
X-ZC-Action: DescribeInstanceTypes
<Common Request Params>

Response:
{
  "requestId": "TE056C563-E5B1-46B5-9C5A-514B7501F420",
  "response": {
    "requestId": "TE056C563-E5B1-46B5-9C5A-514B7501F420",
    "instanceTypes": [
      {
        "imageIds": [
          "e3f1cf2e-8929-4b8a-8747-d0b779b770f7",
          "6059cf45-daf7-4954-80a2-346e8c3c5fd7"
        ],
        "instanceTypeId": "M9O",
        "description": "2x6248",
        "cpuCoreCount": 80,
        "memorySize": 256,
        "maximumBandwidth": 10000,
        "supportRaids": [0,1,5,10],
        "supportSubnet": true,
        "isHA": true,
        "diskInfo": {
          "totalDiskSize": 4000,
          "diskDescription": "4x1.2TB SAS",
          "disks": [
            {
              "diskSize": 1000,
              "diskCount": 4
            }
          ]
        }
      },
      {
        "imageIds": [
          "f9f9f8a2-24a1-44dd-9f60-36c3bc5c0dae"
        ],
        "instanceTypeId": "MGI",
        "description": "2x6248",
        "cpuCoreCount": 80,
        "memorySize": 256,
        "maximumBandwidth": 10000,
        "supportRaids": [0,1],
        "supportSubnet": true,
        "isHA": true,
        "diskInfo": {
          "totalDiskSize": 2000,
          "diskDescription": "2x1.2TB SAS",
          "disks": [
            {
              "diskSize": 1000,
              "diskCount": 2
            }
          ]
        }
      }
    ]
  }
}

5. 开发者工具

Zenlayer Cloud API 2.0 提供了配套的开发工具集（SDK），未来会陆续支持更多开发语言，方便快速接入和使用Zenlayer的产品和服务。

6. 错误码

下面包含业务逻辑中遇到的错误码，其他错误码见公共错误码

HTTP状态码	错误码	说明
****	****	****