You need to enable JavaScript to run this app.
导航
云服务器
  • 文档首页
    • /
  • 云服务器

DescribeInstanceTypeFamilies

最近更新时间：2023.11.20 10:48:35

首次发布时间：2022.07.01 09:21:49

我的收藏

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

调试

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

请求参数

名称类型是否必填示例值描述
ActionString是DescribeInstanceTypeFamilies要执行的操作，取值：DescribeInstanceTypeFamilies。
VersionString是2020-04-01API的版本，取值：2020-04-01。
ZoneIdString否cn-beijing-a实例所在可用区ID，您可以调用DescribeZones查询一个地域下的可用区信息。

Generation

String

否

ecs-2

实例规格族代系，取值：

  • ecs-1：一代实例规格

  • ecs-2：二代实例规格

  • ecs-3：三代实例规格

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

返回数据

名称类型示例值描述
InstanceTypeFamiliesArray of Struct-实例规格族信息，具体请参见下表“ InstanceTypeFamiles 结构 ”。

InstanceTypeFamiles 结构

名称类型示例值描述
InstanceTypeFamilyStringecs.g2i实例规格族。
ZoneIdsList["cn-beijing-a","cn-beijing-b"]实例规格族所在的可用区ID。
GenerationStringecs-2实例规格族代系。

请求示例

GET /?Action=DescribeInstanceTypeFamilies&Version=2020-04-01&ZoneId=cn-beijing-a HTTP/1.1
Host: open.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"
            }
          ]
    }
}

错误码

HttpCode错误码错误信息描述
404InvalidZone.NotFoundThe specified zone does not exist.指定的可用区不存在。
500InternalErrorAn internal error has occurred.内部错误，请重试。如果多次尝试失败，请提交工单。