调用DescribeAvailableResource查询指定地域和可用区下支持的ECS实例规格族。

接口说明

调用CreateContainerGroup创建ECI实例时支持通过InstanceType参数来指定ECS规格,以满足特定的规格需求。为保证ECI实例能够创建成功,在创建ECI实例前,您可以先调用本接口查询指定地域和可用区下支持哪些ECS实例规格族。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeAvailableResource

系统规定参数。取值:DescribeAvailableResource

RegionId String cn-hangzhou

地域ID。

您可以调用DescribeRegions查看最新的阿里云地域列表。

ZoneId String cn-hangzhou-e

可用区ID。

默认值为空,此时查询指定地域下的所有可用区。

DestinationResource Object

要查询的资源信息。

Category String InstanceTypeFamily

资源类型,目前仅支持InstanceTypeFamily,表示查询实例规格族。

Value String ecs.c6

指定实例规格族。

返回数据

名称 类型 示例值 描述
RequestId String 6829735A-FF76-58C6-AECB-27CBF135A7AA

请求ID。

AvailableZones Array of AvailableZone

可用区级别的资源信息集合。

AvailableZone
RegionId String cn-hangzhou

地域ID。

ZoneId String cn-hangzhou-e

可用区ID。

AvailableResources Array of AvailableResource

该可用区支持的资源信息集合。

AvailableResource
Type String InstanceTypeFamily

资源类型。目前仅支持InstanceTypeFamily,表示实例规格族。

SupportedResources Array of SupportedResource

资源信息组成的数组。

SupportedResource
Value String ecs.c6

当Type为InstanceTypeFamily时,value表示实例规格族。

示例

请求示例

https://eci.aliyuncs.com/?Action=DescribeAvailableResource
&RegionId=cn-hangzhou
&ZoneId=cn-hangzhou-e
&DestinationResource={"Category":"InstanceTypeFamily"}
&公共请求参数

正常返回示例

XML格式

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

<DescribeAvailableResourceResponse>
    <RequestId>6829735A-FF76-58C6-AECB-27CBF135A7AA</RequestId>
    <AvailableZones>
        <AvailableZone>
            <ZoneId>cn-hangzhou-e</ZoneId>
            <AvailableResources>
                <AvailableResource>
                    <Type>InstanceTypeFamily</Type>
                    <SupportedResources>
                        <SupportedResource>
                            <Value>ecs.e3</Value>
                        </SupportedResource>
                        <SupportedResource>
                            <Value>ecs.n2</Value>
                        </SupportedResource>
                        <SupportedResource>
                            <Value>ecs.n1</Value>
                        </SupportedResource>
                    </SupportedResources>
                </AvailableResource>
            </AvailableResources>
            <RegionId>cn-hangzhou</RegionId>
        </AvailableZone>
    </AvailableZones>
</DescribeAvailableResourceResponse>

JSON格式

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

{
  "RequestId" : "6829735A-FF76-58C6-AECB-27CBF135A7AA",
  "AvailableZones" : {
    "AvailableZone" : [ {
      "ZoneId" : "cn-hangzhou-e",
      "AvailableResources" : {
        "AvailableResource" : [ {
          "Type" : "InstanceTypeFamily",
          "SupportedResources" : {
            "SupportedResource" : [ {
              "Value" : "ecs.e3"
            }, {
              "Value" : "ecs.n2"
            }, {
              "Value" : "ecs.n1"
            } ]
          }
        } ]
      },
      "RegionId" : "cn-hangzhou"
    } ]
  }
}

错误码

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