文档中心

云服务器

请输入

实例

DescribeInstanceTypeFamilies - 查询实例规格族列表

调用 DescribeInstanceTypeFamilies 查询云服务器提供的实例规格族信息。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：DescribeInstanceTypeFamilies

要执行的操作，取值：DescribeInstanceTypeFamilies。

Version string 必选示例值：2020-04-01

API的版本，取值：2020-04-01。

Generation string 可选示例值：ecs-1

实例规格族代系，取值：

ecs-1：一代实例规格

ecs-2：二代实例规格

ecs-3：三代实例规格

更多详情，请参见实例选型最佳实践和实例规格介绍。

ZoneId string 可选示例值：cn-beijing-a

实例所在可用区ID。

您可以调用DescribeZones查询一个地域下的可用区信息。

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

InstanceTypeFamilies object[] 示例值：--

实例规格族信息。

Generation string 示例值：ecs-2

实例规格族代系。

InstanceTypeFamily string 示例值：ecs.g2i

实例规格族。

ZoneIds string[] 示例值：cn-beijing-a

实例规格族所在的可用区ID。

请求示例

GET /?Action=DescribeInstanceTypeFamilies&Version=2020-04-01&ZoneId=cn-beijing-a HTTP/1.1​
Host: ecs.cn-beijing.volcengineapi.com​
Region: cn-beijing​
Service: ecs​

返回示例

{​
    "ResponseMetadata": {​
        "RequestId": "202106111445100102252431000052****",​
        "Action": "DescribeInstanceTypeFamilies",​
        "Version": "2020-04-01",​
        "Service": "ecs",​
        "Region": "cn-beijing"​
    },​
    "Result": {​
        "InstanceTypeFamilies": [​
            {​
                "InstanceTypeFamily": "ecs.c1ie",​
                "ZoneIds": [​
                    "cn-beijing-a"​
                ],​
                "Generation": "ecs-1"​
            },​
            {​
                "InstanceTypeFamily": "ecs.g2i",​
                "ZoneIds": [​
                    "cn-beijing-a"​
                ],​
                "Generation": "ecs-2"​
            }​
          ]​
    }​
}​

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
404	InvalidZone.NotFound	The specified zone does not exist.	指定的可用区不存在。
500	InternalError	An internal error has occurred.	内部错误，请重试。如果多次尝试失败，请提交工单。

最近更新时间：2025.09.04 16:59:39

这个页面对您有帮助吗？

有用

无用