功能介绍

实例建立跨云或跨Region容灾关系时配置灾备实例的容灾能力。

使用该功能前，必须要确保跨云和跨Region数据库实例之间的网络打通。

调用接口前，您需要了解API 认证鉴权。

调试

您可以在API Explorer中调试该接口。

接口约束

主实例配置容灾能力成功后才能配置灾备实例容灾能力，否则容灾关系会建立失败。
主实例和灾备实例状态正常，主实例和灾备实例在不同云或不同Region且灾备实例为单实例。
灾备实例的规格要保持大于等于主实例。
灾备实例的底层架构和数据库大版本要与主实例一致。
仅RDS for PostgreSQL 12支持建立跨云或跨Region容灾关系，且功能正在公测。
不支持跨大版本建立跨云或跨Region容灾关系。
灾备实例搭建成功后，不能进行小版本升级。

URI

URI格式

POST /v3/{project_id}/instances/{instance_id}/action

参数说明

表1 参数说明

名称	是否必选	说明
project_id	是	租户在某一region下的project ID。 获取方法请参见获取项目ID。
instance_id	是	实例ID。

请求消息

参数说明

表2 参数说明

名称	是否必选	参数类型	说明
build_slave_dr_relation	是	Object	配置容灾实例灾备关系所需要的主实例信息。 详情请参见表3。

表3 build_slave_dr_relation字段数据结构说明

名称	是否必选	参数类型	说明
target_instance_id	是	String	主实例的实例ID。
target_project_id	是	String	主实例所在租户的项目ID。
target_region	是	String	主实例所在的区域ID。
target_ip	是	String	主实例的数据虚拟IP（数据VIP）。

请求示例

配置容灾实例灾备关系，主实例所在的区域为aaa

POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/24c6678f474241fe89ee9c42f768022ein03/action 
{
    "build_slave_dr_relation": {
           "target_instance_id":"c39bd176fb0540929f6add80b91b212cin03",
           "target_project_id":"054b61972980d4552f0bc00ac8d3f5cd",
           "target_region":"aaa",
           "target_ip":"192.168.3.238"
     }
}

响应消息

正常响应要素说明

表4 要素说明

名称	参数类型	说明
job_id	String	工作流ID。

正常响应样例

{
	"job_id": "184f29cd-be1a-43f1-5b6bc5500e73"
}

异常响应

请参见异常请求结果。

状态码

正常

200

异常

请参见状态码。

错误码

请参见错误码。

父主题： 灾备实例

同意关联代理商云淘科技，购买华为云产品更优惠（QQ 78315851）

内容没看懂？ 不太想学习？想快速解决？ 有偿解决： 联系专家