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

调试

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

请求参数

名称 类型 是否必选 示例值 描述
RegionId String cn-hangzhou

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

Action String DescribeInstanceTypeFamilies

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

Generation String ecs-3

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

  • ecs-1:系列I实例规格,上线时间较早,性价比高。
  • ecs-2:系列II实例规格族,第二次软硬件升级,实例性能增强。
  • ecs-3:系列III实例规格族,实例性能优良,能承载不同业务需求,响应更快。
  • ecs-4:系列IV实例规格族,最新规格族,具有强大的场景适应性,能承载海量热门业务需求,延迟更低。
OwnerAccount String ECSforCloud@Alibaba.com

RAM用户的账号登录名称。

返回数据

名称 类型 示例值 描述
InstanceTypeFamilies

由实例规格族InstanceTypeFamilyItemType组成的集合。

Generation String ecs-1

实例规格族所属代数。

InstanceTypeFamilyId String ecs.g5

实例规格族ID。

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求ID。

示例

请求示例

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

正常返回示例

XML 格式

<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 格式

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

错误码

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