查询备份迁移任务详细信息
功能介绍
获取指定备份迁移任务详细信息。
URI
GET /v5/{project_id}/backup-migration-jobs/{job_id}
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
租户在某一Region下的Project ID。 获取方法请参见获取项目ID |
|
job_id |
是 |
String |
备份迁移任务ID。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
Content-Type |
是 |
String |
发送的实体的MIME类型。推荐用户默认使用application/json,如果API是对象、镜像上传等接口,媒体类型可按照流类型的不同进行确定。 |
|
X-Auth-Token |
是 |
String |
从IAM服务获取的用户Token。 用户Token也就是调用获取用户Token接口的响应值,该接口是唯一不需要认证的接口。 请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 |
|
X-Language |
否 |
String |
请求语言类型。
|
响应参数
状态码: 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
任务ID。 |
|
status |
String |
任务状态。 |
|
create_time |
String |
任务创建时间。 |
|
finish_time |
String |
任务完成时间。 |
|
backup_info |
BackupInfoResp object |
备份文件信息。 |
|
base_info |
BackupJobBaseInfo object |
创建备份迁移任务基本信息体。 |
|
target_db_info |
BackupJobEndpointInfo object |
备份迁移任务恢复目标RDS for SQL Server实例信息。 |
|
options |
BackupRestoreOptionInfo object |
备份迁移相关配置参数。 |
|
new_db_names |
String |
备份恢复数据库映射新名称。 |
|
instance_name |
String |
RDS实例名称。 |
|
error_log |
String |
迁移过程中失败原因。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
file_source |
String |
备份文件来源,包括OBS和RDS两种。 |
|
bucket_name |
String |
OBS桶名称。 |
|
file_info |
Array of BackupFileResp objects |
备份文件列表。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
file_name |
String |
文件名称。 |
|
file_size |
String |
备份文件大小。 |
|
file_last_modify |
String |
备份文件最近修改时间。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
name |
String |
任务名称。 约束:任务名称在4位到50位之间,不区分大小写,可以包含字母、数字、中划线或下划线,不能包括其他特殊字符。 - 最小长度:4 - 最大长度:50 |
|
engine_type |
String |
数据库引擎。 - sqlserver:RDS for SQL Server引擎 |
|
description |
String |
任务描述。 |
|
tags |
Array of ResourceTag objects |
标签信息。 标签的值可以包含任意语种字母、数字、空格和_ . : / = + - @。 |
|
enterprise_project_id |
String |
企业项目ID。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
key |
String |
标签键。 约束:最大长度36,只能包含字母、数字、下划线、中划线和中文。 |
|
value |
String |
标签值。标签的值可以包含任意语种字母、数字、空格和_ . : / = + - @。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
target_instance_id |
String |
备份迁移任务恢复目标RDS for SQL Server实例ID。 |
|
ms_file_stream_status |
String |
目标实例是否开启FileStream模式。可通过RDS for SQL Server详情接口获取。 |
|
file_id |
String |
RDS for SQL Server备份文件的文件ID,通过RDS全量恢复时必填。可通过云数据库RDS备份管理页面获取。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
is_cover |
Boolean |
是否覆盖目标数据库,不填默认为false。 值为“true”表示覆盖。 值为“false”表示不覆盖。 |
|
is_default_restore |
Boolean |
是否默认恢复,默认恢复所有数据库。 “true”是代表默认恢复还原备份文件中的全部数据库。 “false”代表需要在db_names这个字段中指定需要恢复的数据库名。 |
|
is_last_backup |
Boolean |
一次典型的增量恢复过程,会涉及多次恢复增量备份。每个增量备份恢复均会使目标数据库保持还原中状态,此时数据库不可读写,直至最后一个增量备份恢复完成后,数据库才能变成可用状态。此后数据库将无法继续进行增量恢复,所以确定为最后一个备份的场景有: 一次性全量迁移,后续将不再进行增量恢复时,设置该字段值为“true”。 增量恢复流程中,确定为最后割接阶段的最后一个增量备份时,设置该字段值为“false”。 |
|
is_precheck |
Boolean |
是否执行预校验。 true:执行。 false:不执行。 |
|
recovery_mode |
String |
恢复模式: “full”表示全量迁移。 “incre”表示增量迁移 。 |
|
db_names |
Array of strings |
数据库名称。 |
|
reset_db_name_map |
Map<String,String> |
该字段为一个map,目前使用格式key是"",value是新数据库名字。 该功能将忽略备份文件中原有的数据库名,通过DRS将其恢复为指定的新数据库名。 使用条件:
|
|
is_delete_backup_file |
Boolean |
该参数控制使用OBS桶中备份文件恢复时,当任务结束时是否删除下载到RDS for SQL server磁盘中的OBS备份文件,默认删除。
|
状态码: 400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误码。 |
|
error_msg |
String |
错误描述。 |
请求示例
查询备份迁移任务详情。
https://{endpoint}/v5/054ba152d480d55b2f5dc0069e7ddef0/backup-migration-jobs/341de3a3-c58a-445d-82e3-8e062b6jb703
响应示例
状态码: 200
OK
{
"id" : "0667845a-6291-4e2a-95b0-190c0abjb703",
"status" : "SUCCESS",
"create_time" : "2024-08-19T02:27:15Z",
"finish_time" : "2024-08-19T02:29:03Z",
"backup_info" : {
"file_source" : "OBS",
"bucket_name" : "zyy-obs",
"file_info" : [ {
"file_name" : "1706510914000_1_Test_Database.bak",
"file_size" : "704KB",
"file_last_modify" : "1706511360000"
} ]
},
"base_info" : {
"name" : "DRS-6813",
"engine_type" : "sqlserver",
"enterprise_project_id" : "0",
"description" : "目标RDS实例名称:rds-sqlserver2022-stand"
},
"target_db_info" : {
"target_instance_id" : "0a3182607bc549bcb46cc9a8755761a6in04"
},
"options" : {
"is_cover" : true,
"is_default_restore" : true,
"is_last_backup" : false,
"is_precheck" : true,
"is_delete_backup_file" : false,
"recovery_mode" : "full",
"db_names" : [ ]
},
"new_db_names" : "[]",
"instance_name" : ""
}
状态码: 400
Bad Request
{
"error_code" : "DRS.10000010",
"error_msg" : "Job does not exist, please check job ID."
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
OK |
|
400 |
Bad Request |
错误码
请参见错误码。