文档首页/ 云堡垒机 CBH/ API参考/ API说明/ 规格管理/ 查询云堡垒机可创建和可变更的规格信息 - ListSpecifications
更新时间:2026-09-15 GMT+08:00
分享

查询云堡垒机可创建和可变更的规格信息 - ListSpecifications

功能介绍

查询云堡垒机可创建和可变更的规格信息。

调用方法

请参见如何调用API

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,需具备如下身份策略权限。

    授权项

    访问级别

    资源类型(*为必须)

    条件键

    别名

    依赖的授权项

    cbh::listSpecifications

    List

    -

    -

    -

    -

URI

GET /v2/{project_id}/cbs/instance/specification

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

项目ID,用于唯一标识用户项目。获取方法请参见获取项目ID

约束限制

不涉及

取值范围

只能由字母和数字组成,长度为32个字符。

默认取值

不涉及

表2 Query参数

参数

是否必选

参数类型

描述

action

String

参数解释

查询云堡垒机规格的动作类型。

约束限制

不涉及

取值范围

  • create:查询当前可创建云堡垒机的规格

  • update:查询当前可变更云堡垒机的规格

默认取值

不涉及

spec_code

String

参数解释

云堡垒机规格编码。可通过本接口“action”参数传“create”时获取所有可用规格编码。

约束限制

当action为update时此字段必填,且必须为有效的云堡垒机规格编码。

取值范围

字符串,长度为1~64个字符。

默认取值

不涉及

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释

用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。获取方法请参见获取用户Token

约束限制

不涉及

取值范围

字符串,长度为1~28000个字符。

默认取值

不涉及

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

[数组元素]

Array of CbsGetSpecInfo objects

堡垒机规格信息。

表5 CbsGetSpecInfo

参数

参数类型

描述

resource_spec_code

String

参数解释

云堡垒机规格名称。

取值范围

字符串,长度为1~64个字符。

ecs_system_data_size

Integer

参数解释

云堡垒机系统盘磁盘大小,单位GB。

取值范围

整数,取值范围为0~9223372036854775807。

cpu

Integer

参数解释

云堡垒机CPU核心数。

取值范围

整数,取值范围为0~9223372036854775807。

ram

Integer

参数解释

云堡垒机内存大小,单位GB。

取值范围

整数,取值范围为0~9223372036854775807。

asset

Integer

参数解释

云堡垒机资产数量。

取值范围

整数,取值范围为0~9223372036854775807。

connection

Integer

参数解释

云堡垒机最大连接数。

取值范围

整数,取值范围为0~9223372036854775807。

type

String

参数解释

云堡垒机规格类型。

取值范围

  • basic:标准版

  • enhance:专业版

data_disk_size

Number

参数解释

云堡垒机数据盘大小,单位TB。

取值范围

数字,取值范围为0~9223372036854775807。

状态码:400

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_description

String

请求参数错误。

状态码:401

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_description

String

校验Token失败。

状态码:403

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_description

String

租户无权限操作。

状态码:404

表9 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_description

String

没有找到CBH资源。

请求示例

响应示例

状态码:200

[ {
  "data_disk_size" : 1,
  "ecs_system_data_size" : 10,
  "cpu" : 4,
  "connection" : 10,
  "resource_spec_code" : "cbh.basic.xxx",
  "asset" : 10,
  "type" : "basic",
  "ram" : 8
} ]

状态码

状态码

描述

200

CBH instance specifications queried

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

错误码

请参见错误码

相关文档