文档首页/ 数据复制服务 DRS/ API参考/ API v3(推荐)/ 实时灾备/ 批量查询RPO和RTO - BatchListRposAndRtos
更新时间:2026-07-29 GMT+08:00

批量查询RPO和RTO - BatchListRposAndRtos

功能介绍

批量查询RPO和RTO。

调试

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

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项

URI

POST /v3/{project_id}/jobs/batch-rpo-and-rto

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

租户在某一Region下的Project ID。

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

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

参数解释

发送的实体的MIME类型。推荐用户默认使用application/json,如果API是对象、镜像上传等接口,媒体类型可按照流类型的不同进行确定。

约束限制:

不涉及。

取值范围:

application/json

默认取值:

application/json

X-Auth-Token

String

参数解释

从IAM服务获取的用户Token。 用户Token也就是调用获取用户Token接口的响应值,该接口是唯一不需要认证的接口。 请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

X-Language

String

参数解释

请求语言类型。

约束限制:

不涉及。

取值范围:

  • en-us:英语
  • zh-cn:中文

默认取值:

en-us

表3 请求Body参数

参数

是否必选

参数类型

描述

jobs

Array of strings

参数解释:

批量查询RPO和RTO的任务ID列表,通过该参数指定需要查询的一个或多个任务。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码:202

表4 响应Body参数

参数

参数类型

描述

count

Integer

参数解释:

返回的RPO和RTO查询结果总数,与results数组的长度一致。

约束限制:

不涉及。

取值范围:

不涉及。

results

Array of objects

参数解释:

批量查询RPO和RTO的响应体集合,每个元素包含一个任务的RPO和RTO信息。

详情请参见表5

表5 results字段数据结构说明

参数

参数类型

描述

job_id

String

参数解释:

数据复制任务ID,用于唯一标识一个任务。

约束限制:

不涉及。

取值范围:

不涉及。

rpo_info

Object

参数解释:

RPO(Recovery Point Objective,恢复点目标)信息,表示灾备任务的数据可恢复到的最近时间点。

详情请参见表6

rto_info

Object

参数解释:

RTO(Recovery Time Objective,恢复时间目标)信息,表示灾备任务的服务恢复所需最长时间。

详情请参见表6

error_code

String

参数解释:

错误码,当查询任务RPO和RTO失败时返回的错误代码。

约束限制:

不涉及。

取值范围:

格式为DRS.XXXXXX。

error_msg

String

参数解释:

错误详细信息,当查询任务RPO和RTO失败时返回的具体错误描述。

约束限制:

不涉及。

取值范围:

不涉及。

表6 rpo_info和rto_info字段数据结构说明

参数

参数类型

描述

check_point

String

参数解释:

数据复制的检查点位置,标识已同步数据的Binlog位置。

约束限制:

不涉及。

取值范围:

不涉及。

delay

String

参数解释:

数据延迟时间(单位ms)。

约束限制:

不涉及。

取值范围:

不涉及。

gtid_set

String

参数解释:

全局事务ID集合(Global Transaction Identifier),用于标识已执行的事务。

约束限制:

不涉及。

取值范围:

不涉及。

time

String

参数解释:

RPO或RTO的统计时间点,格式为“yyyy-MM-dd HH:mm:ss”。

约束限制:

不涉及。

取值范围:

不涉及。

请求示例

批量查询RPO和RTO示例:

https://{endpoint}/v3/054ba152d480d55b2f5dc0069e7ddef0/jobs/batch-rpo-and-rto

{
  "jobs" : [ "8d0e8e36-a618-490d-8a46-8c61ac9jb502" ]
}

响应示例

状态码:202

Accepted

{
  "count" : 1,
  "results" : [ {
    "job_id" : "8d0e8e36-a618-490d-8a46-8c61ac9jb502",
    "rpo_info" : {
      "delay" : "0",
      "time" : "2020-12-18 15:47:05",
      "gtid_set" : "NA",
      "check_point" : "mysql-bin.000514:197"
    },
    "rto_info" : {
      "delay" : "0",
      "time" : "2020-12-18 15:47:05",
      "gtid_set" : "NA",
      "check_point" : "mysql-bin.000514:197"
    }
  } ]
}

状态码

状态码

描述

202

Accepted

400

Bad Request

其他状态请参见状态码

错误码

请参见错误码