查询回收站实例信息
URI
- 参数说明
表1 参数说明 名称
是否必选
说明
project_id
是
参数解释：
租户在某一Region下的项目ID。
获取方法请参见获取项目ID。
约束限制：
不涉及。
取值范围：
不涉及。
默认取值：
不涉及。
offset
是
参数解释：
索引位置，偏移量。从第一条数据偏移offset条数据后开始查询。
约束限制：
不涉及。
取值范围：
必须为数字，不能为负数。
默认取值：
不涉及。
limit
是
参数解释：
每页数据条数。
约束限制：
不涉及。
取值范围：
[1, 50]
默认取值：
不涉及。
请求消息
响应消息
- 正常响应要素说明
表2 要素说明 名称
参数类型
说明
total_count
Integer
参数解释：
回收站数据条数。
取值范围：
不涉及。
instances
Array of objects
参数解释：
回收站信息，详细说明请参见表3。
表3 instances字段数据结构说明 参数
参数类型
描述
id
String
参数解释：
实例ID。
取值范围：
不涉及。
name
String
参数解释：
实例名称。
取值范围：
不涉及。
ha_mode
String
参数解释：
实例主备模式。
取值范围：
不区分大小写。
- Single：单机实例。
- Ha：主备实例。
engine_name
String
参数解释：
引擎名称。
取值范围：
不涉及。
engine_version
String
参数解释：
数据库引擎版本。
取值范围：
不涉及。
pay_model
String
参数解释：
计费方式。
取值范围：
0：按需计费。
created_at
String
参数解释：
创建时间。
取值范围：
格式为“yyyy-mm-ddThh:mm:ssZ”。
其中，T指某个时间的开始；Z指时区偏移量，例如偏移1个小时显示为+0100。
deleted_at
String
参数解释：
删除时间。
取值范围：
格式为“yyyy-mm-ddThh:mm:ssZ”。
其中，T指某个时间的开始；Z指时区偏移量，例如偏移1个小时显示为+0100。
volume_type
String
参数解释：
磁盘类型。
取值范围：
- ULTRAHIGH，表示超高IO型磁盘。
- CLOUDSSD，表示SSD云盘，仅支持通用型和独享型规格实例。
- LOCALSSD，表示本地SSD盘。
volume_size
Integer
参数解释：
磁盘大小。
取值范围：
40 GB~4000 GB，必须为10的整数倍。
data_vip
String
参数解释：
内网地址。
取值范围：
不涉及。
data_vip_v6
String
参数解释：
IPv6内网地址。
取值范围：
不涉及。
enterprise_project_id
String
参数解释：
企业项目ID。
取值范围：
不涉及。
retained_until
String
参数解释：
保留时间。
取值范围：
格式为“yyyy-mm-ddThh:mm:ssZ”。
其中，T指某个时间的开始；Z指时区偏移量，例如偏移1个小时显示为+0100。
recycle_backup_id
String
参数解释：
备份ID。
取值范围：
不涉及。
recycle_status
String
参数解释：
备份状态。
取值范围：
- BUILDING：备份中，不能进行重建。
- COMPLETED：备份完成，可以重建实例。
- 正常响应样例 RDS for MySQL响应样例
{ "total_count": 1, "instances": [ { "id": "f55da7ba462f414da2f9505fda3562b9in01", "name": "mysql_57_ha_test3", "ha_mode": "Ha", "engine_name": "mysql", "engine_version": "5.7.44", "pay_model": "0", "created_at": "2025-09-02T09:04:06+0000", "deleted_at": "2025-09-03T10:06:33+0000", "volume_type": "SSD", "volume_size": 40, "data_vip": "172.168.235.59", "enterprise_project_id": "0", "retained_until": "2025-09-10T10:07:05+0000", "recycle_backup_id": "37a3d791431045a782d72496d384150abr01", "recycle_status": "COMPLETED", "recycle_backups": [ { "backup_id": "37a3d791431045a782d72496d384150abr01", "backup_name": "mysql-f55da7ba462f414da2f9505fda3562b9in01-20250903100705426", "backup_status": "COMPLETED", "backup_create_at": "2025-09-03T10:07:05+0000", "backup_update_at": "2025-09-03T10:08:20+0000", "backup_size": 3600 } ], "is_serverless": false } ] }RDS for PostgreSQL响应样例
{ "total_count": 1, "instances": [{ "id": "b0fd0c715ad043c98107ad12398653adin03", "name": "rds-9111", "ha_mode": "Single", "engine_name": "postgresql", "engine_version": "17.5", "pay_model": "0", "created_at": "2025-09-03T07:59:20+0000", "deleted_at": "2025-09-03T08:24:18+0000", "volume_type": "SSD", "volume_size": 40, "data_vip": "192.168.10.251", "enterprise_project_id": "0", "retained_until": "2025-09-10T08:20:20+0000", "recycle_backup_id": "644b1a945db648868af8f54e04f5d6a6br03", "recycle_status": "COMPLETED", "recycle_backups": [{ "backup_id": "644b1a945db648868af8f54e04f5d6a6br03", "backup_name": "postgresql-b0fd0c715ad043c98107ad12398653adin03-20250903082020735", "backup_status": "COMPLETED", "backup_create_at": "2025-09-03T08:20:20+0000", "backup_update_at": "2025-09-03T08:21:27+0000", "backup_size": 3629 }, { "backup_id": "e225352d1f9b4c51aa170ea2c2fc4d4bbr03", "backup_name": "postgresql-rds-9111-20250903075947338", "backup_status": "COMPLETED", "backup_create_at": "2025-09-03T07:59:47+0000", "backup_update_at": "2025-09-03T08:00:57+0000", "backup_size": 3633 } ], "is_serverless": false }] }
- 异常响应
请参见异常请求结果。
状态码
- 正常
- 异常
请参见状态码。
错误码
请参见错误码。
