文档首页> 云数据库 GeminiDB> API参考> API v3(推荐)> 容灾管理> 获取容灾实例数据同步状态
更新时间:2023-11-21 GMT+08:00
分享

获取容灾实例数据同步状态

功能介绍

获取容灾实例数据同步状态,主备实例id,数据同步指标值,以及倒换和切换场景下的RPO,RTO指标值。

接口约束

该接口支持GeminiDB Redis数据库实例。

调试

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

URI

GET https://{Endpoint}/v3/{project_id}/instances/{instance_id}/disaster-recovery/data-synchronization

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

用户在某一region下的project ID。获取方法请参见获取项目ID

instance_id

String

实例ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

master_instance_id

String

主实例id

slave_instance_id

String

备实例id

status

String

容灾实例数据同步状态。

枚举值:

  • NA:实例尚未搭建容灾关系。
  • NEW:尚未启动的数据同步状态。
  • SYNCING:数据同步正常进行中。
  • SUSPENDING:正在暂停数据同步。
  • SUSPENDED:数据同步已暂停。
  • RECOVERYING:正在恢复数据同步。

data_sync_indicators

object

数据同步指标,仅当请求实例id为主实例时有值。详情请参考表4

rto_and_rpo_indicators

Array of objects

切换或倒换RPO和RTO值,仅当请求实例id为主实例时有值。详情请参考表5

表4 NoSQLDrDataSyncIndicators

参数

参数类型

描述

rsync_ops

Long

节点内同步命令的执行速率,每秒多少条数据;

rsync_wal_size

Long

节点内的同步WAL堆积大小,单位MB;

rsync_push_cost

Long

同步消息从放入消息队列,直到收到对端响应的平均耗时,单位us;

rsync_send_cost

Long

同步消息从消息队列取出,直到收到对端响应的平均耗时,单位us;

rsync_max_push_cost

Long

采集周期内rsync的同步推送耗时最大值,单位us;

rsync_max_send_cost

Long

采集周期内rsync的同步发送耗时最大值,单位us;

rsync_status

Integer

rsync的同步状态,1表示正在同步,0表示没有同步;

表5 NoSQLDrRpoAndRto

参数

参数类型

描述

scene

String

场景,枚举值 FAILOVER 强制切换; SWITCHOVER 主备倒换

枚举值:

  • FAILOVER
  • SWITCHOVER

rpo

Long

倒换或切换丢失数据时长,单位:秒(s)

rto

Long

倒换或切换恢复时长,单位:秒(s)

请求示例

  • URI样例
    GET https://gaussdb-nosql.cn-north-7.myhuaweicloud.com/v3/0549b4a43100d4f32f51c01c2fe4acdb/instances/b0965c9010f44ffca9af4ee00746aa8din12/disaster-recovery/data-synchronization
  • 请求体样例

    无。

响应示例

状态码: 200

Success

请求实例id为主实例id: 
{ 
  "master_instance_id": "b0965c9010f44ffca9af4ee00746aa8din12", 
  "slave_instance_id": "c0965c9010f44ffca9af4ee00746aa8din12", 
  "status": "SYNCING", 
  "data_sync_indicators": { 
    "rsync_ops": 100, 
    "rsync_wal_size": 30, 
    "rsync_push_cost": 30, 
    "rsync_send_cost": 20, 
    "rsync_max_push_cost": 35, 
    "rsync_max_send_cost": 25, 
    "rsync_status": 1 
  }, 
  "rto_and_rpo_indicators": [ 
    { 
      "scene": "SWITCHOVER", 
      "rpo": 20, 
      "rto": 40 
    }, 
    { 
      "scene": "FAILOVER", 
      "rpo": 20, 
      "rto": 40 
    } 
  ] 
} 
请求实例id为备实例id: 
{ 
  "master_instance_id": "c0965c9010f44ffca9af4ee00746aa8din12", 
  "slave_instance_id": "b0965c9010f44ffca9af4ee00746aa8din12", 
   "status": "SYNCING" 
}

状态码

请参见状态码

错误码

请参见错误码

分享:

    相关文档

    相关产品