文档首页/ 云数据库 GeminiDB/ API参考/ API v3（推荐）/ 备份与恢复/ 数据文件导入已有实例
更新时间：2025-10-17 GMT+08:00
查看PDF
分享

数据文件导入已有实例

功能介绍

数据导入已有实例。

接口约束

该接口支持如下数据库实例：

  • GeminiDB Redis

正在恢复的实例不能进行数据导入的操作。

目前支持RDB格式文件进行导入。

URI

POST /v3/{project_id}/redis/instances/{instance_id}/recovery

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

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

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

instance_id

是

String

参数解释：

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

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

x-auth-token

是

String

参数解释：

用户Token。

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

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。
表3 请求Body参数

参数

是否必选

参数类型

描述

recovery_info

否

RecoveryInfo object

参数解释：

备份文件所在OBS信息。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。
表4 RecoveryInfo

参数

是否必选

参数类型

描述

bucket_name

是

String

参数解释：

备份文件所在OBS bucket。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

files

是

Array of strings

参数解释：

备份文件名。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

响应参数

状态码：202

表5 响应Body参数

参数

参数类型

描述

job_id

String

参数解释：

任务ID。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

请求示例

使用RDB备份文件进行恢复

POST https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/redis/instances/a4d8ea2584e047439a667703c0684119in06/recovery    {  
  "recovery_info" : 
 { 
    "bucket_name" : "test-bucket",  
    "files" : [ "file1.rdb", "file2.rdb" ]  
  } 
}

响应示例

状态码：202

Success

{    
  "job_id" : "f85104b5-4a9c-4e0f-9505-fc5409d8f7ae"  
}

状态码

请参见状态码。

错误码

请参见错误码。

父主题： 备份与恢复