Describes the resources list of instance type families provided by Alibaba Cloud ECS. For more information, see Instance type families.

Request parameters

Name Type Required Description
Action String Yes The name of this interface. Value: DescribeInstanceTypeFamilies.
RegionId String Yes Regional ID. For more information, call DescribeRegions to obtain the latest region list.
Generation String No The generation of the instance type families. Optional values:
  • ecs-1: Generation I, which consists of the earliest and cost-effective instance types.
  • ecs-2: Generation II, which is available later than the first generation of type families.
  • ecs-3: Generation III which consists of the latest and high performance instance type families.

Return parameters

Name Type Description
InstanceTypeFamilies InstanceTypeFamilyItemType A collection composed of InstanceTypeFamilyItemType.

Examples

Request example
https://ecs.aliyuncs.com/?Action=DescribeInstanceTypeFamilies
&RegionId=cn-hangzhou
&<Common Request Parameters>
Response example

XML format

<DescribeInstanceTypeFamiliesResponse>
    <InstanceTypeFamilies>
        <InstanceTypeFamily>
            <InstanceTypeFamilyId>ecs.t1</InstanceTypeFamilyId>
            <Generation>ecs-1</Generation>
        </InstanceTypeFamily>
        <InstanceTypeFamily>
            <InstanceTypeFamilyId>ecs.s2</InstanceTypeFamilyId>
            <Generation>ecs-1</Generation>
        </InstanceTypeFamily>
        <InstanceTypeFamily>
            <InstanceTypeFamilyId>ecs.s3</InstanceTypeFamilyId>
            <Generation>ecs-1</Generation>
        </InstanceTypeFamily>
    </InstanceTypeFamilies>
    <RequestId>6B187E0A-C075-4D08-8B6F-6213950E8733</RequestId>
</DescribeInstanceTypeFamiliesResponse>
JSON format
{
    "InstanceTypeFamilies":{
        "InstanceTypeFamily":[
            {
                "InstanceTypeFamilyId":"ecs.t1",
                "Generation":"ecs-1"
            },
            {
                "InstanceTypeFamilyId":"ecs.s2",
                "Generation":"ecs-1"
            },
            {
                "InstanceTypeFamilyId":"ecs.s3",
                "Generation":"ecs-1"
            }
        ]
    },
    "RequestId":"6B187E0A-C075-4D08-8B6F-6213950E8733"
}

Error codes

All are common error codes. For more error codes, see the API error center.