文档首页/云堡垒机 CBH/API参考/API说明/操作管理/获取堡垒机实例列表 - ListInstances
更新时间：2026-03-06 GMT+08:00
在线调试
CLI示例
查看PDF
分享

获取堡垒机实例列表 - ListInstances

功能介绍

获取当前租户下的堡垒机实例列表。

调用方法

请参见如何调用API。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID。

获取方法请参见获取项目ID。

表2 Query参数

参数

是否必选

参数类型

描述

instance_id

否

Long

云堡垒机实例ID。（非必传，需要查询单个实例详情时传入）

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

获取方法请参见获取用户Token。

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

total

Integer

云堡垒机实例总数。

instance

Array of InstanceDetail objects

云堡垒机实例列表信息。

表5 InstanceDetail

参数

参数类型

描述

name

String

云堡垒机实例名称。

server_id

String

云堡垒机服务器id。

instance_id

String

云堡垒机实例id。

alter_permit

Boolean

云堡垒机实例是否可以扩容。

  • true：是

  • false：否

enterprise_project_id

String

项目ID。

period_num

String

云堡垒机实例订购周期数。

start_time

String

云堡垒机实例开始时间，使用时间戳格式表示。

end_time

String

云堡垒机实例结束时间，使用时间戳格式表示。

created_time

String

云堡垒机实例创建时间，使用UTC时间表示。

upgrade_time

Long

云堡垒机实例升级定时时间，使用时间戳格式表示。

update

String

云堡垒机实例是否可以升级。

  • OLD：当前已是最新版本

  • NEW：可以升级小版本

  • CROSS_OS：可以跨版本升级

  • ROLLBACK：可以回滚

bastion_version

String

云堡垒机实例当前版本。

az_info

az_info object

可用区信息。

status_info

status_info object

状态信息。

resource_info

resource_info object

资源信息。

network

network object

网络信息。

ha_info

ha_info object

主备信息。

表6 az_info

参数

参数类型

描述

region

String

云堡垒机实例所在可用区ID。

zone

String

云堡垒机实例所在可用分区ID。(实例为主备模式时作为主机实例所在可用分区)

availability_zone_display

String

云堡垒机实例所在可用分区中文名称。(实例为主备模式时作为主机实例所在可用分区中文名称)

slave_zone

String

云堡垒机备机实例所在可用区。

slave_zone_display

String

云堡垒机备机实例所在可用区中文名称。

表7 status_info

参数

参数类型

描述

status

String

云堡垒机实例状态。

  • SHUTOFF：已关闭

  • ACTIVE：运行中

  • DELETING：删除中

  • BUILD：创建中

  • DELETED：已删除

  • ERROR：故障

  • HAWAIT：等待备机创建成功

  • FROZEN：已冻结

  • UPGRADING：升级中

  • UNPAID：待支付

  • RESIZE：规格变更中

  • DILATATION：扩容中

  • HA：配置HA中

task_status

String

云堡垒机实例当前的任务状态。

  • powering-on：开启

  • powering-off：关闭

  • rebooting：重启

  • delete_wait：删除

  • frozen：冻结

  • NO_TASK：运行

  • unfrozen：解冻

  • alter：变更

  • updating：升级中

  • configuring-ha：配置HA

  • data-migrating：数据迁移中

  • rollback：版本回滚中

  • traffic-switchover：流量切换中

create_instance_status

String

云堡垒机实例在创建实例过程中的状态信息。

  • Waiting for payment：等待支付

  • creating-network：创建网络

  • creating-server：创建服务

  • tranfering-horizontal-network：网络打通

  • adding-policy-route：添加路由策略

  • configing-dns：配置DNS

  • starting-cbs-service：服务运行中

  • setting-init-conf：初始化

  • buying-EIP：购买弹性公网IP

instance_status

String

云堡垒机实例状态。

  • building：创建中

  • deleting：删除中

  • deleted：删除了

  • unpaid：未支付

  • upgrading：升级中

  • resizing：扩容中

  • abnormal：异常

  • error：故障

  • ok：正常

instance_description

String

云堡垒机实例信息描述。

fail_reason

String

云堡垒机实例创建实例失败原因。

表8 resource_info

参数

参数类型

描述

specification

String

云堡垒机实例规格。

order_id

String

订单id。

resource_id

String

云堡垒机实例的资源id，UUID格式显示。

data_disk_size

Number

云堡垒机实例数据盘大小，单位TB。

disk_resource_id

Array of strings

云堡垒机实例数据盘资源ID。

表9 network

参数

参数类型

描述

vip

String

云堡垒机实例浮动ip。(实例为主备模式时返回对应的值)

web_port

String

云堡垒机实例WEB界面访问的端口号。

public_ip

String

云堡垒机实例弹性公网IP。

public_id

String

云堡垒机实例绑定公网的弹性IP的ID，UUID格式表示。

private_ip

String

云堡垒机实例私有ip。

vpc_id

String

云堡垒机实例所在虚拟私有云ID。

subnet_id

String

云堡垒机实例所在子网ID。

security_group_id

String

云堡垒机实例所属的安全组ID。

表10 ha_info

参数

参数类型

描述

ha_id

String

主备ID。

instance_type

String

实例类型。

  • master：主

  • slave：备

状态码：400

表11 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_description

String

请求参数错误。

状态码：401

表12 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_description

String

校验TOKEN失败。

状态码：403

表13 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_description

String

租户无权限操作。

状态码：404

表14 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_description

String

没有找到CBH资源。

请求示例

无

响应示例

状态码：200

Cbh List Instance Success

{
  "total" : 1,
  "instance" : [ {
    "name" : "CBH-e2b4",
    "server_id" : "760aeee4-9916-436a-8854-837a9ae94b2b",
    "instance_id" : "5473",
    "alter_permit" : false,
    "enterprise_project_id" : "0",
    "period_num" : "1,2",
    "start_time" : 1692245215000,
    "end_time" : 1694966399000,
    "created_time" : "2023-08-17 12:05:02.0",
    "update" : false,
    "bastion_version" : "3.3.49.0",
    "az_info" : {
      "region" : "cn-north-7",
      "zone" : "cn-north-7a",
      "availability_zone_display" : "可用区1",
      "slave_zone" : "cn-north-7b",
      "slave_zone_display" : "可用区2"
    },
    "status_info" : {
      "status" : "ACTIVE",
      "task_status" : "NO_TASK",
      "create_instance_status" : "NO_TASK",
      "fail_reason" : "No FailReason Now",
      "instance_status" : "ok",
      "instance_description" : ",2023-08-21 15:19:07,{\"d_usage\":\"0.30\",\"m_usage\":\"43.66\",\"c_usage\":\"1.00\",\"session_count\":\"0\""
    },
    "resource_info" : {
      "specification" : "cbh.basic.5",
      "order_id" : "CS2308171141G8C14",
      "resource_id" : "c7a07a7f-e5ee-49cf-8355-aee46c5a4fcf",
      "data_disk_size" : 200,
      "disk_resource_id" : [ ]
    },
    "network" : {
      "vip" : "192.168.0.228",
      "web_port" : "443",
      "public_ip" : "100.xx.xx.1",
      "public_id" : "56220ed7-0f75-4d42-85c4-013d5414c81c",
      "private_ip" : "192.168.0.190",
      "vpc_id" : "03211ecf-697e-4306-a7a0-6e939bf948de",
      "subnet_id" : "dd08a6a9-ced7-484b-ace6-1b821854a772",
      "security_group_id" : "02dcf62d-b84d-4a14-aad3-c310f2ceea55"
    },
    "ha_info" : {
      "ha_id" : "332",
      "instance_type" : "master"
    }
  } ]
}

状态码

状态码

描述

200

Cbh List Instance Success

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

错误码

请参见错误码。

父主题：操作管理