文档首页/ 云数据库 GeminiDB/ API参考/ API v3(推荐)/ 备份与恢复/ 获取GeminiDB Cassandra实例表级恢复的数据库信息
更新时间:2025-10-17 GMT+08:00
分享

获取GeminiDB Cassandra实例表级恢复的数据库信息

功能介绍

获取GeminiDB Cassandra实例表级恢复的数据库信息。

接口约束

  • 只支持GeminiDB Cassandra数据库实例获取表级恢复的数据库信息。

URI

GET /v3/{project_id}/instances/{instance_id}/databases

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

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

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

instance_id

String

参数解释:

实例ID,可以调用7.3.3 查询实例列表和详情接口获取。如果未申请实例,可以调用7.3.1 创建实例接口创建。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

表2 Query参数

参数

是否必选

参数类型

描述

offset

Integer

参数解释:

索引位置偏移量,表示从指定project ID下最新的专属资源创建时间开始,按时间的先后顺序偏移offset条数据后查询对应的专属资源信息。

约束限制:

不涉及。

取值范围:

大于或等于0。

默认取值:

0,表示从最新的创建时间对应的专属资源开始查询。

limit

Integer

参数解释:

查询专属资源个数上限值。

约束限制:

不涉及。

取值范围:

1~100。

默认取值:

100,默认查询100条实例信息。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

用户Token。

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

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

total_count

Integer

参数解释:

总记录数。

取值范围:

不涉及。

database_names

Array of strings

参数解释:

数据库名称列表。

取值范围:

不涉及。

请求示例

GET https://{endpoint}/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/a6d3c8a9857b4c81b3c1fe4802dfa4d0in06/databases?offset=0&limit=10

响应示例

状态码: 200

Success

{ 
  "total_count" : 1, 
  "database_names" : [ "db01" ] 
}

状态码

请参见状态码

错误码

请参见错误码

相关文档