创建备份导入任务
功能介绍
创建备份导入任务。
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
task_name | 是 | String | 备份导入任务名称。 |
description | 否 | String | 备份导入任务描述。 |
migration_type | 是 | String | 迁移任务类型。 取值范围:
|
migration_method | 是 | String | 迁移方式,包括全量迁移和增量迁移两种类型。 取值范围:
|
backup_files | 否 | BackupFilesBody object | 迁移任务类型为备份文件导入场景时的备份文件列表。 |
network_type | 否 | String | 迁移任务类型为在线迁移时,表示源Redis和目标Redis连通的网络类型,包括vpc和vpn两种类型。目前已不支持用该接口创建在线迁移任务,请调用CreateOnlineMigrationTask创建在线迁移任务。 |
source_instance | 否 | SourceInstanceBody object | 迁移任务类型为在线迁移场景时该参数为必填参数,表示源Redis信息。目前已不支持用该接口创建在线迁移任务,请调用CreateOnlineMigrationTask创建在线迁移任务。 |
target_instance | 是 | TargetInstanceBody object | 表示目标Redis信息。 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
file_source | 是 | String | 数据来源
|
bucket_name | 否 | String | OBS桶名,如果数据来源是OBS桶的话,该参数为必填参数。 |
files | 是 | Array of Files objects | 导入的备份文件列表,数据来源为OBS桶时必须填写。 |
backup_id | 否 | String | 备份记录ID,数据来源为备份记录时必须填写。 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
file_name | 是 | String | 备份文件名。 |
size | 否 | String | 文件大小(单位:Byte)。 |
update_at | 否 | String | 文件最后修改时间(格式YYYY-MM-DD HH:MM:SS)。 |
响应参数
状态码:200
参数 | 参数类型 | 描述 |
|---|---|---|
id | String | 迁移任务ID。 |
name | String | 迁移任务名称。 |
status | String | 迁移任务状态,这个字段的值包括:SUCCESS(成功), FAILED(失败), MIGRATING(迁移中),TERMINATED(已结束)。 |
error | String | 错误信息。 |
状态码:400
参数 | 参数类型 | 描述 |
|---|---|---|
error_msg | String | 参数解释: 错误信息。 取值范围: 不涉及。 |
error_code | String | 参数解释: 错误码。 取值范围: 请参见错误码。 |
error_ext_msg | String | 参数解释: 扩展错误信息(暂未使用,赋值为null)。 取值范围: 不涉及。 |
状态码:401
参数 | 参数类型 | 描述 |
|---|---|---|
error_msg | String | 参数解释: 错误信息。 取值范围: 不涉及。 |
error_code | String | 参数解释: 错误码。 取值范围: 请参见错误码。 |
error_ext_msg | String | 参数解释: 扩展错误信息(暂未使用,赋值为null)。 取值范围: 不涉及。 |
状态码:403
参数 | 参数类型 | 描述 |
|---|---|---|
error_msg | String | 参数解释: 错误信息。 取值范围: 不涉及。 |
error_code | String | 参数解释: 错误码。 取值范围: 请参见错误码。 |
error_ext_msg | String | 参数解释: 扩展错误信息(暂未使用,赋值为null)。 取值范围: 不涉及。 |
状态码:404
参数 | 参数类型 | 描述 |
|---|---|---|
error_msg | String | 参数解释: 错误信息。 取值范围: 不涉及。 |
error_code | String | 参数解释: 错误码。 取值范围: 请参见错误码。 |
error_ext_msg | String | 参数解释: 扩展错误信息(暂未使用,赋值为null)。 取值范围: 不涉及。 |
状态码:500
参数 | 参数类型 | 描述 |
|---|---|---|
error_msg | String | 参数解释: 错误信息。 取值范围: 不涉及。 |
error_code | String | 参数解释: 错误码。 取值范围: 请参见错误码。 |
error_ext_msg | String | 参数解释: 扩展错误信息(暂未使用,赋值为null)。 取值范围: 不涉及。 |
请求示例
创建备份导入迁移任务,备份数据来源于OBS桶。
POST https://{dcs_endpoint}/v2/{project_id}/migration-task
{
"task_name" : "migration1",
"description" : "Test",
"migration_type" : "backupfile_import",
"migration_method" : "full_amount_migration",
"backup_files" : {
"bucket_name" : "bucketName",
"file_source" : "self_build_obs",
"files" : [ {
"size" : "754.0MB",
"file_name" : "fileName"
} ]
},
"target_instance" : {
"id" : "d2c8399f-bdba-43c1-8069-3ff17a1a79d5",
"name" : "dcs-test",
"password" : "xxxxxx"
}
} 响应示例
状态码:200
创建备份导入任务成功。
{
"id" : "8aa6999e71cb638b0171f485f5266ef0",
"name" : "dcs-test",
"status" : "MIGRATING",
"error" : ""
} 状态码
状态码 | 描述 |
|---|---|
200 | 创建备份导入任务成功。 |
400 | 非法请求。 |
401 | 认证信息非法。 |
403 | 请求被拒绝访问。 |
404 | 所请求的资源不存在。 |
500 | 内部服务错误。 |
错误码
请参见错误码。

