更新时间:2025-10-17 GMT+08:00
分享

查询回收站实例列表

功能介绍

查询回收站所有接口的实例列表。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

GET /v3/{project_id}/recycle-instances

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

用户在某一region下的project ID。获取方法请参见获取项目ID

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

表2 Query参数

参数

是否必选

参数类型

描述

offset

Integer

参数解释:

索引位置偏移量。从第一条数据偏移offset条数据后开始查询。

约束限制:

大于或等于0。

取值范围:

不涉及。

默认取值:

0,表示从第一条数据开始查询。

limit

Integer

参数解释:

查询个数上限值。

约束限制:

不涉及。

取值范围:

1~100。

默认取值:

100。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

用户Token。

通过调用IAM服务获取用户Token接口获取。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

total_count

Integer

参数解释:

总记录数。

取值范围:

不涉及。

instances

Array of objects

参数解释:

实例信息。详情请参考表5

取值范围:

不涉及。

表5 RecycleInstance

参数

参数类型

描述

id

String

参数解释:

实例ID。

取值范围:

不涉及。

name

String

参数解释:

实例名称。

取值范围:

不涉及。

mode

String

参数解释:

实例类型。

取值范围:

  • 取值为“Cluster”,表示GeminiDB CassandraGeminiDB InfluxGeminiDB Redis 经典部署模式Proxy 集群实例类型。
  • 取值为“CloudNativeCluster”,表示GeminiDB Cassandra、GeminiDB Influx、GeminiDB Redis云原生部署模式集群实例类型。
  • 取值为“RedisCluster”,表示GeminiDB Redis经典部署模式Cluster集群实例类型。
  • 取值为“Replication”,表示GeminiDB Redis经典部署模式主备实例类型。
  • 取值为“InfluxdbSingle”,表示GeminiDB Influx 经典部署模式单节点实例类型。
  • 取值为“ReplicaSet”,表示GeminiDB Mongo副本集实例类型。

product_type

String

参数解释:

产品类型。

取值范围:

GeminiDB Redis云原生部署模式集群涉及此字段,取值:

  • Standard:标准型。
  • Capacity:容量型。

datastore

object

参数解释:

数据库信息。详情请参考表6

取值范围:

不涉及。

charge_mode

String

参数解释:

计费方式。

取值范围:

  • prePaid:预付费,即包年/包月。
  • postPaid:后付费,即按需付费。

enterprise_project_id

String

参数解释:

企业项目ID,取值为“0”,表示为default企业项目

取值范围:

不涉及。

backup_id

String

参数解释:

备份ID。

取值范围:

不涉及。

created_at

String

参数解释:

实例创建时间。

取值范围:

不涉及。

deleted_at

String

参数解释:

实例删除时间。

取值范围:

不涉及。

retained_until

String

参数解释:

回收备份保留截止时间。

取值范围:

不涉及。

表6 RecycleDatastore

参数

参数类型

描述

type

String

参数解释:

数据库类型。

取值范围:

  • 取值为“cassandra”,表示GeminiDB Cassandra数据库实例。
  • 取值为“mongodb”,表示GeminiDB Mongo数据库实例。
  • 取值为“influxdb”,表示GeminiDB Influx数据库实例。
  • 取值为“redis”,表示GeminiDB Redis数据库实例。

version

String

参数解释:

数据库版本。

取值范围:

不涉及。

请求示例

  • URI样例
    GET https://gaussdb-nosql.cn-north-7.myhuaweicloud.com/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/recycle-instances?offset=0&limit=100
  • 请求体样例

    无。

响应示例

状态码: 200

Success.

{ 
  "total_count" : 1, 
  "instances" : [ { 
    "id" : "07fc12a8e0e94df7a3fcf53d0b5e1605in06", 
    "name" : "test", 
    "mode" : "Cluster", 
    "datastore" : { 
      "type" : "cassandra", 
      "version" : "3.11" 
    }, 
    "charge_mode" : "postPaid", 
    "enterprise_project_id" : "0", 
    "backup_id" : "bf9ee62a7f7044c583c6765c916c36edbr02", 
    "created_at" : "2022-01-01T10:00:00", 
    "deleted_at" : "2022-02-01T11:00:00", 
    "retained_until" : "2022-02-02T11:00:00" 
  } ] 
}

状态码

请参见状态码

错误码

请参见错误码

相关文档