文档首页/ 数据仓库服务 DWS/ 更多文档/ API参考（联盟区域）/ API说明/ 容灾管理/ 创建容灾
更新时间：2025-12-10 GMT+08:00
在线调试
CLI示例
查看PDF
分享

创建容灾

功能介绍

该接口用于创建集群间容灾。

集群处于可用状态或者非均衡状态才可进行创建容灾操作。

仅支持DWS 2.0集群。

调用方法

请参见如何调用API。

URI

POST /v2/{project_id}/disaster-recoveries

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

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

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

disaster_recovery

是

CreateDisasterRecovery object

参数解释：

容灾信息。

取值范围：

不涉及。
表3 CreateDisasterRecovery

参数

是否必选

参数类型

描述

name

是

String

参数解释：

名称。

取值范围：

不涉及。

dr_type

是

String

参数解释：

容灾类型。

取值范围：

不涉及。

primary_cluster_id

是

String

参数解释：

主集群ID。

取值范围：

不涉及。

standby_cluster_id

是

String

参数解释：

备集群ID。

取值范围：

不涉及。

dr_sync_period

是

String

参数解释：

同步周期。

取值范围：

不涉及。

primary_obs_bucket

否

String

参数解释：

主集群OBS桶。

取值范围：

不涉及。

standby_obs_bucket

否

String

参数解释：

备集群obs桶。

取值范围：

不涉及。

discovery_recovery_id

否

String

参数解释：

容灾ID。

取值范围：

不涉及。

primary_cluster_region

否

String

参数解释：

容灾主Region。

取值范围：

不涉及。

standby_cluster_region

否

String

参数解释：

容灾备Region。

取值范围：

不涉及。

primary_cluster_project_id

否

String

参数解释：

容灾主集群项目ID。

取值范围：

不涉及。

standby_cluster_project_id

否

String

参数解释：

容灾备集群项目ID。

取值范围：

不涉及。

cluster_role

否

String

参数解释：

集群角色。

取值范围：

不涉及。

primary_cluster_info

否

CreateDrClusterDto object

参数解释：

容灾主集群信息。

取值范围：

不涉及。
表4 CreateDrClusterDto

参数

是否必选

参数类型

描述

cluster_name

否

String

参数解释：

集群名称。

取值范围：

不涉及。

cluster_id

否

String

参数解释：

集群ID。

取值范围：

不涉及。

cidr

否

String

参数解释：

子网的网段。

取值范围：

不涉及。

gateway_ip

否

String

参数解释：

子网的网关。

取值范围：

不涉及。

internal_ips

否

String

参数解释：

主网卡IP。

取值范围：

不涉及。

private_ips

否

String

参数解释：

内网IP。

取值范围：

不涉及。

endpoint

否

String

参数解释：

域名。

取值范围：

不涉及。

db_admin_pwd

否

String

参数解释：

数据库管理员密码。

取值范围：

不涉及。

disaster_recovery_id

否

String

参数解释：

容灾ID。

取值范围：

不涉及。

kernel_version

否

String

参数解释：

内核的版本。

取值范围：

不涉及。

响应参数

状态码：200

表5 响应Body参数

参数

参数类型

描述

disaster_recovery

DisasterRecoveryId object

参数解释：

容灾ID对象。

取值范围：

不涉及。
表6 DisasterRecoveryId

参数

参数类型

描述

id

String

参数解释：

容灾ID。

取值范围：

不涉及。

请求示例

创建名为test_dr4的跨AZ容灾，设置每5分钟同步一次数据，其中主集群ID为“3ef5daaa-d017-4354-80b3-8a69caf2e09”，备集群ID为“e7fed7fe-f4a7-499a-afed-1fdb5c1978cb”。

POST https://{Endpoint}/v2/89cd04f168b84af6be287f71730fdb4b/disaster-recoveries

{
  "disaster_recovery" : {
    "name" : "test_dr4",
    "dr_type" : null,
    "primary_cluster_id" : "3ef5daaa-d017-4354-80b3-8a69caf2e09",
    "standby_cluster_id" : "e7fed7fe-f4a7-499a-afed-1fdb5c1978cb",
    "dr_sync_period" : "5m",
    "primary_obs_bucket" : null,
    "standby_obs_bucket" : null
  }
}

响应示例

状态码：200

创建容灾成功。

{
  "disaster_recovery" : {
    "id" : "e59d6b86-9072-46eb-a996-13f8b44994c1"
  }
}

状态码

状态码

描述

200

创建容灾成功。

400

请求错误。

401

鉴权失败。

403

没有操作权限。

404

找不到资源。

500

服务内部错误。

503

服务不可用。
父主题： 容灾管理