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

Description

The DescribeInstanceTypes returns the list of instance types that are the same as the list of the Pay-As-You-Go instances on the instance creation web page. For more information, see Pay-As-You-Go and  Limits.

If you want to create instances that are not available to you, open a ticket to make them available.

Request parameters

Name Type Required  Description
Action String Yes The name of this interface. Value: DescribeInstanceTypes.
InstanceTypeFamily String No The family of the instance type. For more information, see Instance type families.

Response parameters

Name Type Description
InstanceTypes InstanceTypeItemType A collection composed of InstanceTypeItemType.

Examples

Request example
https://ecs.aliyuncs.com/?Action=DescribeInstanceTypes
&<Common Request Parameters>
Response example

XML format

<DescribeInstanceTypesResponse>
    <RequestId>1651FBB6-4FBF-49FF-A9F5-DF5D696C7EC6</RequestId>
    <InstanceTypes>
        <InstanceType>
            <InstanceTypeId>ecs.t1.xsmall</InstanceTypeId>
            <CpuCoreCount>1</CpuCoreCount>
            <MemorySize>0.5</MemorySize>
        </InstanceType>
        <InstanceType>
            <InstanceTypeId>ecs.t1.small</InstanceTypeId>
            <CpuCoreCount>1</CpuCoreCount>
            <MemorySize>1</MemorySize>
        </InstanceType>
    </InstanceTypes>
</DescribeInstanceTypesResponse>
JSON format
{
    "RequestId": "1651FBB6-4FBF-49FF-A9F5-DF5D696C7EC6",
    "InstanceTypes": {
        "InstanceType": [{
            "InstanceTypeId": "ecs.t1.xsmall",
            "CpuCoreCount": 1,
            "MemorySize": 0.5
        },
        {
            "InstanceTypeId": "ecs.t1.small",
            "CpuCoreCount": 1,
            "MemorySize": 1
        }]
    }
}

Error codes

All are common error codes. For more information, see Common error codes.