# 查询回收站所有引擎实例列表 #### 功能介绍 查询回收站所有引擎实例列表。 - 调用接口前，您需要了解API [认证鉴权](https://support.huaweicloud.com/api-gaussdb/gaussdb_api_011.html)。 - 调用接口前，您需要提前获取到[地区和终端节点](https://developer.huaweicloud.com/endpoint)。 #### 调试 您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=GaussDBforopenGauss&api=ListRecycleInstances)中调试该接口。 #### URI GET /v3/{project_id}/recycle-instances 表1参数说明 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释：** 租户在某一Region下的项目ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-gaussdb/gaussdb_api_196.html)。 **约束限制：** 不涉及。 **取值范围：** 只能由英文字母、数字组成，且长度为32个字符。 **默认取值**： 不涉及。 | | instance_name | 否 | String | 实例名称。 | | offset | 否 | Integer | 索引位置，偏移量。从第一条数据偏移offset条数据后开始查询，默认为0（偏移0条数据，表示从第一条数据开始查询），必须为数字，不能为负数。例如：该参数指定为0，limit指定为10，则只展示第1-10条数据。 | | limit | 否 | Integer | 查询记录数。默认为50，不能为负数，最小值为1，最大值为50。例如该参数设定为10，则查询结果最多只显示10条记录。 | #### 请求参数 无。 #### 响应参数 表2参数说明 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | total_count | Integer | 总记录数。 | | instances | Array of objects | 回收站所有的实例信息，具体参数请参考[表3]。 | 表3instances字段数据结构说明 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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.cn-north-4.myhuaweicloud.com/v3/619d3e78f61b4be68bc5aa0b59edcf7b/recycle-instances ``` #### 响应示例 ``` { "total_count" : 2, "instances" : [ { "id" : "21f20e55999947a9938ad0453b757e72in14", "name" : "gaussdbv5_CCv20_bms_default_1_20220827012852", "ha_mode" : "Ha", "engine_name" : "gaussdbv5", "engine_version" : "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" : "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" } ] } ``` #### 状态码 - 正常 200 - 异常 请参见[状态码](https://support.huaweicloud.com/api-gaussdb/gaussdb_api_194.html)。 #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-gaussdb/gaussdb_api_195.html)。