DescribeInstanceTypeFamilies -

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeInstanceTypeFamilies	The operation that you want to perform. Set the value to DescribeInstanceTypeFamilies.
RegionId	String	Yes	cn-hangzhou	The region ID of the instance family. You can call the DescribeRegions operation to query the most recent region list.
Generation	String	No	ecs-5	The generation of the instance family. For more information, see Overview of instance families. Valid values: ecs-1: Generation I, which consists of the earliest and cost-effective instance types ecs-2: Generation II, which provides upgraded software and hardware and higher performance than Generation I ecs-3: Generation III, which consists of high-performance instance families and is suitable for different business scenarios ecs-4: Generation IV, which consists of enterprise-level instance families (such as g5, c5, and r5), ECS Bare Metal Instance families (such as ebmc5s, ebmg5s, and ebmr5s), and burstable instance families (such as t5) and can meet a wide variety of business requirements with lower latency ecs-5: Generation V, which consists of enterprise-level instance families (such as g6, c6, and r6), ECS Bare Metal Instance families (such as ebmg6, ebmg6e, and ebmc6), and storage-enhanced instance families (such as g6e) and delivers quick response times and higher performance ecs-6: Generation VI, which consists of enterprise-level instance families (such as hfc7, hfg7, and hfr7) and ECS Bare Metal Instance families (such as ebmhfg7) and is in invitational preview

Response parameters

Parameter	Type	Example	Description
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****	The ID of the request.
InstanceTypeFamilies	Array of InstanceTypeFamily		The instance families.
InstanceTypeFamily
Generation	String	ecs-5	The generation of the instance family.
InstanceTypeFamilyId	String	ecs.g6	The ID of the instance family.

Examples

Sample requests

https://ecs.aliyuncs.com/?Action=DescribeInstanceTypeFamilies
&RegionId=cn-hangzhou
&Generation=ecs-5
&<Common request parameters>

Sample success responses

XML format

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

<DescribeInstanceTypeFamiliesResponse>
    <InstanceTypeFamilies>
        <InstanceTypeFamily>
            <InstanceTypeFamilyId>ecs.g6</InstanceTypeFamilyId>
            <Generation>ecs-5</Generation>
        </InstanceTypeFamily>
        <InstanceTypeFamily>
            <InstanceTypeFamilyId>ecs.ebmg6</InstanceTypeFamilyId>
            <Generation>ecs-5</Generation>
        </InstanceTypeFamily>
        <InstanceTypeFamily>
            <InstanceTypeFamilyId>ecs.ebmg6e</InstanceTypeFamilyId>
            <Generation>ecs-5</Generation>
        </InstanceTypeFamily>
        <InstanceTypeFamily>
            <InstanceTypeFamilyId>ecs.g6e</InstanceTypeFamilyId>
            <Generation>ecs-5</Generation>
        </InstanceTypeFamily>
        <InstanceTypeFamily>
            <InstanceTypeFamilyId>ecs.c6</InstanceTypeFamilyId>
            <Generation>ecs-5</Generation>
        </InstanceTypeFamily>
        <InstanceTypeFamily>
            <InstanceTypeFamilyId>ecs.r6</InstanceTypeFamilyId>
            <Generation>ecs-5</Generation>
        </InstanceTypeFamily>
        <InstanceTypeFamily>
            <InstanceTypeFamilyId>ecs.t6</InstanceTypeFamilyId>
            <Generation>ecs-5</Generation>
        </InstanceTypeFamily>
        <InstanceTypeFamily>
            <InstanceTypeFamilyId>ecs.hfc6</InstanceTypeFamilyId>
            <Generation>ecs-5</Generation>
        </InstanceTypeFamily>
        <InstanceTypeFamily>
            <InstanceTypeFamilyId>ecs.hfg6</InstanceTypeFamilyId>
            <Generation>ecs-5</Generation>
        </InstanceTypeFamily>
        <InstanceTypeFamily>
            <InstanceTypeFamilyId>ecs.hfr6</InstanceTypeFamilyId>
            <Generation>ecs-5</Generation>
        </InstanceTypeFamily>
        <InstanceTypeFamily>
            <InstanceTypeFamilyId>ecs.ebmc6</InstanceTypeFamilyId>
            <Generation>ecs-5</Generation>
        </InstanceTypeFamily>
        <InstanceTypeFamily>
            <InstanceTypeFamilyId>ecs.ebmr6</InstanceTypeFamilyId>
            <Generation>ecs-5</Generation>
        </InstanceTypeFamily>
    </InstanceTypeFamilies>
    <RequestId>A66D039A-EC35-4130-B0D1-E9873C07****</RequestId>
</DescribeInstanceTypeFamiliesResponse>

JSON format

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

{
  "InstanceTypeFamilies" : {
    "InstanceTypeFamily" : [ {
      "InstanceTypeFamilyId" : "ecs.g6",
      "Generation" : "ecs-5"
    }, {
      "InstanceTypeFamilyId" : "ecs.ebmg6",
      "Generation" : "ecs-5"
    }, {
      "InstanceTypeFamilyId" : "ecs.ebmg6e",
      "Generation" : "ecs-5"
    }, {
      "InstanceTypeFamilyId" : "ecs.g6e",
      "Generation" : "ecs-5"
    }, {
      "InstanceTypeFamilyId" : "ecs.c6",
      "Generation" : "ecs-5"
    }, {
      "InstanceTypeFamilyId" : "ecs.r6",
      "Generation" : "ecs-5"
    }, {
      "InstanceTypeFamilyId" : "ecs.t6",
      "Generation" : "ecs-5"
    }, {
      "InstanceTypeFamilyId" : "ecs.hfc6",
      "Generation" : "ecs-5"
    }, {
      "InstanceTypeFamilyId" : "ecs.hfg6",
      "Generation" : "ecs-5"
    }, {
      "InstanceTypeFamilyId" : "ecs.hfr6",
      "Generation" : "ecs-5"
    }, {
      "InstanceTypeFamilyId" : "ecs.ebmc6",
      "Generation" : "ecs-5"
    }, {
      "InstanceTypeFamilyId" : "ecs.ebmr6",
      "Generation" : "ecs-5"
    } ]
  },
  "RequestId" : "A66D039A-EC35-4130-B0D1-E9873C07****"
}

Error codes

For a list of error codes, see Service error codes.