文档首页/ 云数据库 GaussDB/ API参考/ API（推荐）/ 回收站/ 查询回收站所有引擎实例列表
更新时间：2025-08-11 GMT+08:00
查看PDF
分享

查询回收站所有引擎实例列表

功能介绍

查询回收站所有引擎实例列表。

URI

GET /v3.1/{project_id}/recycle-instances

表1 参数说明

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

租户在某一Region下的项目ID。

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

约束限制：

不涉及。

取值范围：

只能由英文字母、数字组成，且长度为32个字符。

默认取值：

不涉及。

instance_name

否

String

参数解释：

实例名称。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

offset

否

Integer

参数解释：

索引位置，偏移量。

约束限制：

不涉及。

取值范围：

0 ~ 2,147,483,647。

默认取值：

默认为0（偏移0条数据，表示从第一条数据开始查询）。

limit

否

Integer

参数解释：

查询记录数。

约束限制：

不涉及。

取值范围：

1~50。

默认取值：

默认为50。

请求参数

无。

响应参数

表2 参数说明

参数

参数类型

描述

total_count

Integer

参数解释：

总记录数。

取值范围：

不涉及。

instances

Array of objects

参数解释：

回收站所有的实例信息，具体参数请参考表3。
表3 instances字段数据结构说明

参数

参数类型

描述

id

String

参数解释：

实例ID。

取值范围：

不涉及。

name

String

参数解释：

实例名称。

取值范围：

不涉及。

ha_mode

String

参数解释：

部署形态。

取值范围：

  • Ha：集中式版。
  • Independent：独立部署。
  • Combined：混合部署。

engine_name

String

参数解释：

引擎名称。

取值范围：

不涉及。

engine_version

String

参数解释：

引擎版本号。

取值范围：

不涉及。

pay_model

String

参数解释：

计费模式。

取值范围：

0：按需计费。

1：包年包月。

created_at

String

参数解释：

创建时间，格式为“yyyy-mm-ddThh:mm:ssZ”。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。

取值范围：

不涉及。

deleted_at

String

参数解释：

删除时间，格式为“yyyy-mm-ddThh:mm:ssZ”。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。

取值范围：

不涉及。

volume_type

String

参数解释：

磁盘类型。

取值范围：

  • high：高IO。
  • ultrahigh：超高IO。
  • essd：急速型SSD。

volume_size

String

参数解释：

磁盘大小。

取值范围：

不涉及。

data_vip

String

参数解释：

数据vip。

取值范围：

不涉及。

enterprise_project_id

String

参数解释：

企业项目ID，"0"代表默认的企业项目。

取值范围：

不涉及。

enterprise_project_name

String

参数解释：

企业项目名称。

取值范围：

不涉及。

backup_level

String

参数解释：

备份级别。

取值范围：

不涉及。

recycle_backup_id

String

参数解释：

备份ID。（指删除实例时产生备份信息中的备份ID）。

取值范围：

不涉及。

recycle_status

String

参数解释：

回收站备份状态。

取值范围：

  • Running：运行中。
  • Active：有效。

mode

String

参数解释：

产品类型。

取值范围：

  • basic：基础版。
  • standard：标准版。
  • enterprise：企业版。

请求示例

GET https://gaussdb-opengauss.ap-southeast-1.myhuaweicloud.com/v3.1/619d3e78f61b4be68bc5aa0b59edcf7b/recycle-instances

响应示例

{ 
  "total_count" : 2, 
  "instances" : [ { 
    "id" : "21f20e55999947a9938ad0453b757e72in14", 
    "name" : "gaussdbv5_CCv20_bms_default_1_20220827012852", 
    "ha_mode" : "Ha", 
    "engine_name" : "gaussdbv5", 
    "engine_version" : "V2.0-2.3.0", 
    "pay_model" : 0, 
    "created_at" : "2022-08-09T09:26:44.000+08:00", 
    "deleted_at" : "2022-08-09T09:26:44.000+08:00", 
    "volume_type" : "localssd", 
    "volume_size" : "", 
    "data_vip" : "25.213.0.41 / 25.213.0.188 / 25.213.0.101 / 25.213.0.82", 
    "enterprise_project_id" : 0, 
    "enterprise_project_name" : null, 
    "backup_level" : null,
    "recycle_backup_id" : "00b755ed678e41d18c74b28e2ad41bdcbr14", 
    "recycle_status" : "Active", 
    "mode" : "enterprise"
  }, { 
    "id" : "a9df5b52b32e4571b1b6425a78a32956in14", 
    "name" : "ecs-lxy-backup-3", 
    "ha_mode" : "Ha", 
    "engine_name" : "gaussdbv5", 
    "engine_version" : "V2.0-2.3.0", 
    "pay_model" : 0, 
    "created_at" : "2022-08-09T09:26:44.000+08:00", 
    "deleted_at" : "2022-08-09T09:26:44.000+08:00", 
    "volume_type" : "ultrahigh", 
    "volume_size" : "", 
    "data_vip" : "173.202.10.246 / 173.202.10.205 / 173.202.10.175", 
    "enterprise_project_id" : 0, 
    "enterprise_project_name" : null, 
    "backup_level" : null, 
    "recycle_backup_id" : "ef393704ef0045d1b6226b6f2cdc48a7br14", 
    "recycle_status" : "Active", 
    "mode" : "enterprise"
  } ] 
}

状态码

错误码

请参见错误码。

父主题： 回收站