文档首页/ 数据复制服务 DRS/ API参考/ API v3（不再推广）/ 实时灾备管理/ 批量查询灾备初始化对象详情
更新时间：2025-08-13 GMT+08:00
在线调试
CLI示例
查看PDF
分享

批量查询灾备初始化对象详情

功能介绍

根据任务ID批量查询灾备初始化对象详情。

调试

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

URI

POST /v3/{project_id}/jobs/{type}/batch-struct-detail

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户在某一Region下的Project ID。

获取方法请参见获取项目ID。

type

是

String

数据库支持迁移对象类型。取值：

  • database
  • schema
  • table
  • view
  • procedure
  • trigger
  • index
  • table_indexs
  • table_structure

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

指定类型为application/json。

缺省值：application/json

X-Auth-Token

是

String

从IAM服务获取的用户Token。

X-Language

否

String

请求语言类型。

缺省值：en-us

取值：

  • en-us
  • zh-cn
表3 请求Body参数

参数

是否必选

参数类型

描述

jobs

是

Array of strings

批量查询任务详情。

page_req

否

Object

分页信息。

详情请参见表4。
表4 page_req字段数据结构说明

参数

是否必选

参数类型

描述

cur_page

否

Integer

当前页, 不能超过item数量除每页任务数量的最大页，缺省值：1。

per_page

否

Integer

每页item数量，填0获取全部item。

  • 最小值：0
  • 最大值：100
  • 缺省值：5

响应参数

状态码： 200

表5 响应Body参数

参数

参数类型

描述

count

Integer

总数。

results

Array of objects

批量查询灾备初始化对象详情返回列表。

详情请参见表6。
表6 results字段数据结构说明

参数

参数类型

描述

job_id

String

任务ID。

error_code

String

错误码。

error_message

String

错误信息。

struct_detail

Object

灾备初始化对象详情信息。

详情请参见表7。
表7 struct_detail字段数据结构说明

参数

参数类型

描述

total_record

Long

任务总数。

create_time

String

数据生成时间。

list

Array of objects

对比结果。

详情请参见表8。
表8 list字段数据结构说明

参数

参数类型

描述

progress

Integer

进度。

src_DB

String

源数据库名称。如果源数据库存在三层结构，格式为：database.schema。

src_TB

String

源对象名称。

dst_DB

String

目标数据库名称。

dst_TB

String

目标对象名称。

请求示例

批量查询灾备初始化对象详情示例：

https://{endpoint}/v3/054ba152d480d55b2f5dc0069e7ddef0/jobs/database/batch-struct-detail

{
  "jobs" : [ "0ea5c5a0-e1b5-4421-80a9-7c9ff27jb502" ],
  "page_req" : {
    "cur_page" : 1,
    "per_page" : 10
  }
}

响应示例

状态码： 200

OK

{
  "count" : 1,
  "results" : [ {
    "job_id" : "8d0e8e36-a618-490d-8a46-8c61ac9jb502",
    "struct_detail" : {
      "list" : [ {
        "progress" : 100,
        "src_DB" : "test1",
        "src_TB" : "test1",
        "dst_DB" : "test1",
        "dst_TB" : "test1"
      } ],
      "total_record" : 1,
      "create_time" : "1608429484785"
    }
  } ]
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。

父主题： 实时灾备管理

相关文档