调用DescribeInstanceTypeFamilies查询云服务器ECS提供的实例规格族列表。

调试

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

请求参数

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

接口名称。对于您自行拼凑HTTP/HTTPS URL发起的API请求，Action为必选参数。取值：DescribeInstanceTypeFamilies

RegionId String 是 cn-hangzhou

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

Generation String 否 ecs-3

实例规格族的系列信息。更多详情，请参见实例规格族。取值范围：

  • ecs-1：系列I实例规格，上线时间较早，性价比高。
  • ecs-2：系列II实例规格族，第二次软硬件升级，实例性能增强。
  • ecs-3：系列III实例规格族，实例性能优良，能承载不同业务需求。
  • ecs-4：系列IV实例规格族，具有强大的场景适应性，能承载海量热门业务需求，延迟更低。
  • ecs-5：系列V实例规格族，包含常见的企业级实例规格（g6、c6、r6等）、弹性裸金属服务器实例规格（ebmg6、ebmg6e、ebmc6等）、存储增强型实例规格（g6e）等，响应更快，性能更优越。

返回数据

名称 类型 示例值 描述
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求ID。
InstanceTypeFamilies Array

由实例规格族InstanceTypeFamily组成的集合。
InstanceTypeFamilyId String ecs.g6

实例规格族ID。
Generation String ecs-5

实例规格族所属代数。

示例

请求示例

https://ecs.aliyuncs.com/?Action=DescribeInstanceTypeFamilies
&RegionId=cn-hangzhou
&Generation=ecs-5
&<公共请求参数>

正常返回示例

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-E9873C0742D2</RequestId>
</DescribeInstanceTypeFamiliesResponse>

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-E9873C0742D2"
}

错误码

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