云服务器内容精选

  • 请求示例 POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/disaster-recovery-infos { "status": "normal", "order": "ASC", "sort_field": "time", "offset": 0, "limit": 10 }
  • 响应消息 正常响应要素说明 表3 要素说明 名称 参数类型 说明 total_count Integer 总记录数。 instance_dr_infos Array of objects 容灾信息列表。 详情请参见表4。 表4 instance_dr_infos字段说明 名称 参数类型 说明 id String 容灾关系ID。 status String 容灾搭建状态。 failed_message String 失败消息。 replica_state String 同步状态。取值范围是0或-1,0表示正常,-1表示异常。 wal_write_receive_delay_in_mb String 发送延迟大小(MB),即主实例当前wal日志写入位点与灾备实例当前接收wal日志位点的差值。 wal_write_replay_delay_in_mb String 端到端延迟大小(MB),即主实例当前wal日志写入位点与灾备实例当前回放wal日志位点的差值。 wal_receive_replay_delay_in_ms String 回放延迟时间(ms),即数据在灾备上回放的延迟时间。 master_instance_id String 主实例ID。 master_region String 主实例所在Region。 slave_instance_id String 灾备实例ID。 slave_region String 灾备实例所在Region。 build_process String 搭建流程。 master,表示配置主实例容灾能力流程。 slave,表示配置灾备实例容灾能力流程。 time Long 灾备搭建时间。 正常响应样例 { "total_count": 1, "instance_dr_infos": [ { "id": "57160f82-e6bb-44bc-80db-0d950d4f3b40", "status": "failed", "failed_message": "the network is disconnected", "replica_state": "0", "wal_write_receive_delay_in_mb": "10.0", "wal_write_replay_delay_in_mb": "10.0", "wal_receive_replay_delay_in_ms": "0", "master_instance_id": "fab4e3df67c24aa0a5b41bc2bcb41918in03", "master_region": "region-A", "slave_instance_id": "df50adb922ef42a495943b304f8aa551in03", "slave_region": " region-B", "time": 1702551254685 } ] } 异常响应 请参见异常请求结果。
  • 请求消息 表2 参数说明 名称 是否必选 参数类型 说明 id 否 String 容灾关系ID。 status 否 String 容灾搭建状态。 master_instance_id 否 String 主实例ID。 master_region 否 String 主实例Region。 slave_instance_id 否 String 灾备实例ID。 slave_region 否 String 灾备实例Region。 create_at_start 否 Long 创建起始时间。 create_at_end 否 Long 创建结束时间。 order 否 String 排序方式。 DESC,降序。 ASC,升序。 默认降序。 sort_field 否 String 排序字段。 status 容灾搭建状态。 time 容灾搭建时间。 master_region 主实例region。 slave_region 灾备实例region 默认容灾搭建时间。 offset 否 Integer 索引位置,偏移量。从第一条数据偏移offset条数据后开始查询,默认为0(偏移0条数据,表示从第一条数据开始查询),必须为数字,不能为负数。 limit 否 Integer 查询记录数。默认为10,不能为负数,最小值为1,最大值为100。
  • 请求示例 配置主实例灾备关系,灾备实例所在的区域为aaa。 POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/24c6678f474241fe89ee9c42f768022ein03/action { "build_master_dr_relation": { "target_instance_id":"c39bd176fb0540929f6add80b91b212cin03", "target_project_id":"054b61972980d4552f0bc00ac8d3f5cd", "target_region":"aaa", "target_ip":"192.168.3.238", "target_subnet":"192.168.3.1/24" } }
  • 接口约束 主实例和灾备实例状态正常,主实例和灾备实例在不同云或不同Region上,且主实例为主备实例,灾备实例为单实例。 灾备实例的规格要大于等于主实例的规格。 灾备实例的底层架构和数据库大版本要与主实例一致。 调用配置主实例容灾接口后直至成功搭建容灾关系,不能进行规格变更、主备倒换操作。 RDS for PostgreSQL 12及以上版本支持建立跨云或跨Region容灾关系。 不支持跨大版本建立跨云或跨Region容灾关系。
  • 请求消息 表2 参数说明 名称 是否必选 参数类型 说明 build_master_dr_relation 是 Object 配置主实例灾备关系所需要的灾备实例信息。 详情请参见表3。 表3 build_master_dr_relation字段数据结构说明 名称 是否必选 参数类型 说明 target_instance_id 是 String 灾备实例的实例ID。 target_project_id 是 String 灾备实例所在租户的项目 ID。 target_region 是 String 灾备实例所在的区域 ID。 target_ip 是 String 灾备实例的数据虚拟IP(数据VIP)。 target_subnet 是 String 灾备实例的子网地址。