文档首页/ 云数据库 GaussDB/ API参考/ API（推荐）/ 容灾管理/ 搭建容灾关系
更新时间：2025-08-11 GMT+08:00
查看PDF
分享

搭建容灾关系

功能介绍

搭建容灾关系。

约束限制

从主实例端下发。

URI

POST /v3.5/{project_id}/instances/{instance_id}/disaster-recovery/construct

表1 参数说明

名称

是否必选

说明

project_id

是

参数解释：

租户在某一Region下的项目ID。

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

约束限制：

不涉及。

取值范围：

只能由英文字母、数字组成，且长度为32个字符。

默认取值：

不涉及。

instance_id

是

参数解释：

实例ID，此参数是用户创建实例的唯一标识。

约束限制：

不涉及。

取值范围：

只能由英文字母、数字组成，且长度为36个字符。

默认取值：

不涉及。

请求参数

表2 参数说明

名称

是否必选

参数类型

说明

disaster_type

是

String

参数解释：

容灾类型。

约束限制：

不涉及。

取值范围：

  • stream：流式容灾。

默认取值：

不涉及。

dr_ip

是

String

参数解释：

对端实例数据IP。可通过查询查询数据库实例列表接口获取。

  • 集中式版：对端实例任意节点数据IP（非仲裁节点、非日志节点）。
  • 分布式版：对端实例CN节点的数据IP。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

dr_user_name

是

String

参数解释：

对端实例账户名称。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

dr_user_password

是

String

参数解释：

对端实例账户密码。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

dr_task_name

否

String

参数解释：

容灾任务名称。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

响应参数

表3 响应Body参数列表

名称

参数类型

说明

job_id

String

参数解释：

任务ID。

取值范围：

不涉及。

请求示例

POST https://gaussdb-opengauss.ap-southeast-1.myhuaweicloud.com/v3.5/0483b6b16e954cb88930a360d2c4e663/instances/9089bbf7377442daa55bc28d514c08bdin14/disaster-recovery/construct
{ 
   "disaster_type" : "stream", 
   "dr_ip" : "127.0.0.1", 
   "dr_user_name" : "root", 
   "dr_user_password" : "password",
   "dr_task_name": "dr-task-123" 
 }

响应示例

{
"job_id":"8bf0175e-562e-45f6-942a-2e2c72c577d7"
}

状态码

错误码

请参见错误码。

父主题： 容灾管理