文档首页/ 云容器引擎 CCE/ API参考/ API/ 集群管理/ 查询集群可售卖规格
更新时间:2025-08-26 GMT+08:00

查询集群可售卖规格

功能介绍

该API用于查询集群可售卖规格

集群管理的URL格式为:https://Endpoint/uri。其中uri为资源路径,也即API访问的路径。

调用方法

请参见如何调用API

URI

GET /api/v2/flavor/specifications

表1 Query参数

参数

是否必选

参数类型

描述

clusterType

String

参数解释

该参数用于按集群架构查询可售卖规格

取值范围

  • VirtualMachine: CCE集群

  • ARM64: 鲲鹏集群

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

参数解释:

消息体的类型(格式)

约束限制:

GET方法不做校验

取值范围:

  • application/json

  • application/json;charset=utf-8

  • application/x-pem-file

  • multipart/form-data(注:存在FormData参数时使用)

默认取值:

不涉及

X-Auth-Token

String

参数解释:

调用接口的认证方式分为Token和AK/SK两种,如果您使用的Token方式,此参数为必填,请填写Token的值,获取方式请参见获取token

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

clusterFlavorSpecs

ClusterFlavorSpecification object

参数解释

集群可售卖规格详情

表4 ClusterFlavorSpecification

参数

参数类型

描述

name

String

参数解释

规格名称

取值范围

  • cce.s1.small: 小规模单控制节点CCE集群(最大50节点)

  • cce.s1.medium: 中等规模单控制节点CCE集群(最大200节点)

  • cce.s2.small: 小规模三控制节点CCE集群(最大50节点)

  • cce.s2.medium: 中等规模三控制节点CCE集群(最大200节点)

  • cce.s2.large: 大规模三控制节点CCE集群(最大1000节点)

  • cce.s2.xlarge: 超大规模三控制节点CCE集群(最大2000节点)

专属云特殊规格如下:

  • cce.dec.s1.small: 小规模单控制节点的专属云CCE集群(最大50节点)

  • cce.dec.s1.medium: 中等规模单控制节点的专属云CCE集群(最大200节点)

  • cce.dec.s1.large: 大规模单控制节点的专属云CCE集群(最大1000节点)

  • cce.dec.s1.xlarge: 超大规模单控制节点的专属云CCE集群(最大2000节点)

  • cce.dec.s2.small: 小规模三控制节点的专属云CCE集群(最大50节点)

  • cce.dec.s2.medium: 中等规模三控制节点的专属云CCE集群(最大200节点)

  • cce.dec.s2.large: 大规模三控制节点的专属云CCE集群(最大1000节点)

  • cce.dec.s2.xlarge: 超大规模三控制节点的专属云CCE集群(最大2000节点)

nodeCapacity

Integer

参数解释

集群节点规模

取值范围

  • 50: 最大支持50节点

  • 200: 最大支持200节点

  • 100: 最大支持1000节点

  • 2000: 最大支持2000节点

availableMasterFlavors

Array of MasterFlavorSpec objects

参数解释

控制节点详情

isSoldOut

Boolean

参数解释

集群规格是否售罄

取值范围

不涉及

isSupportMultiAZ

Boolean

参数解释

是否支持控制节点多可用区分布

取值范围

不涉及

表5 MasterFlavorSpec

参数

参数类型

描述

name

String

参数解释

控制节点规格

取值范围

不涉及

azs

Array of strings

参数解释

控制节点支持的可用区

azFaultDomains

Map<String,Array<String>>

参数解释

控制节点所在可用区支持的故障域

请求示例

响应示例

状态码:200

表示获取集群可售卖规格成功。

{
  "clusterFlavorSpecs" : [ {
    "name" : "cce.s2.large",
    "nodeCapacity" : 1000,
    "availableMasterFlavors" : [ {
      "name" : "ac6.4xlarge.2",
      "azs" : [ "az1", "az2" ],
      "azFaultDomains" : {
        "az1" : [ "FD1", "FD2" ]
      }
    } ]
  } ]
}

状态码

状态码

描述

200

表示获取集群可售卖规格成功。

错误码

请参见错误码