批量查询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
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 租户在某一Region下的Project ID。 获取方法请参见获取项目ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| 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 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| jobs | 是 | Array of strings | 参数解释: 批量查询RPO和RTO的任务ID列表,通过该参数指定需要查询的一个或多个任务。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
响应参数
状态码:202
| 参数 | 参数类型 | 描述 |
|---|---|---|
| count | Integer | 参数解释: 返回的RPO和RTO查询结果总数,与results数组的长度一致。 约束限制: 不涉及。 取值范围: 不涉及。 |
| results | Array of objects | 参数解释: 批量查询RPO和RTO的响应体集合,每个元素包含一个任务的RPO和RTO信息。 详情请参见表5。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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失败时返回的具体错误描述。 约束限制: 不涉及。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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"
}
} ]
} 错误码
请参见错误码。