调用DescribeInstanceTypeFamilies接口查询实例规格族列表-云服务器 ECS-阿里云-阿里云帮助中心

本接口用于查询阿里云 ECS提供的实例规格族列表。通过该接口获取不同系列的实例规格族信息，从而更好地帮助您了解可用的实例规格资源，为您选择合适的实例规格创建 ECS 实例提供参考。

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。	cn-hangzhou
Generation	string	否	实例规格族的系列信息。更多信息，请参见实例规格族。取值范围： ecs-1：系列 I 实例规格，上线时间较早，性价比高。 ecs-2：系列 II 实例规格族，第二次软硬件升级，实例性能增强。 ecs-3：系列 III 实例规格族，实例性能优良，能承载不同业务需求。 ecs-4：系列 IV 实例规格族，包含常见的企业级实例规格（g5、c5、r5 等）、弹性裸金属服务器实例规格（ebmc5s、ebmg5s、ebmr5s 等）、突发性能实例规格（t5）等，具有强大的场景适应性，能承载海量热门业务需求，延迟更低。 ecs-5：系列 V 实例规格族，包含常见的企业级实例规格（g6、c6、r6 等）、弹性裸金属服务器实例规格（ebmg6、ebmg6e、ebmc6 等）、存储增强型实例规格（g6e）等，响应更快，性能更优越。 ecs-6：系列 VI 实例规格族，包含企业级实例规格（hfc7、hfg7、hfr7 等）、弹性裸金属服务器实例规格（ebmhfg7 等），该系列实例规格族正在邀测中。	ecs-5

返回参数

名称	类型	描述	示例值
	object	请求 ID。
RequestId	string	请求 ID。	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
InstanceTypeFamilies	array<object>	由实例规格族 InstanceTypeFamily 组成的集合。
InstanceTypeFamily	object	实例规格族所属代数。
Generation	string	实例规格族所属代数。	ecs-5
InstanceTypeFamilyId	string	实例规格族 ID。	ecs.g6

示例

正常返回示例

JSON格式

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "InstanceTypeFamilies": {
    "InstanceTypeFamily": [
      {
        "Generation": "ecs-5",
        "InstanceTypeFamilyId": "ecs.g6"
      }
    ]
  }
}

错误码

HTTP status code	错误码	错误信息	描述
404	InvalidRegionId.NotFound	The RegionId provided does not exist in our records.	地域信息错误

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

变更历史

变更时间	变更内容概要	操作
2025-01-14	OpenAPI 描述信息更新、OpenAPI 错误码发生变更	查看变更详情