文档中心

云数据库 MySQL 版

实例管理

CreateDrDBInstance - 为指定实例创建灾备实例

CreateDrDBInstance - 为指定实例创建灾备实例

调用 CreateDrDBInstance 接口为指定实例创建灾备实例。

请求类型

异步请求。

注意事项

该请求需发往灾备实例所在的地域。

MySQL 8.4 版本的实例不支持创建灾备实例。

开启 TDE 加密功能的实例不支持创建灾备实例。

单节点实例不支持创建灾备实例。

蓝绿部署中的绿色实例不支持创建灾备实例。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

请求参数

参数	类型	是否必选	示例值	描述
MasterInstanceId	String	是	mysql-cb50000b****	主实例的 ID。
MasterRegion	String	是	cn-shanghai	主实例所在的地域。
NodeInfo	Array of NodeInfoObject	是	请参见请求示例。	灾备实例的规格。
StorageSpace	Integer	是	20	灾备实例的存储空间。每个规格对应的存储空间取值范围不同，关于存储空间取值范围的详细信息，请参见产品规格。单位为 GiB，步长 10 GiB。
VpcId	String	是	vpc-3revrf005h5a85zsk2hlu****	私有网络（VPC） ID。可调用 DescribeVpcs 查询。说明不支持使用共享 VPC。
SubnetId	String	是	subnet-2bzpnnjy4b1ts2dx0efn9****	子网 ID。可调用 DescribeSubnets 通过指定 VpcId 和 ZoneId （主节点或备节点所在的可用区）查询可用的子网。
InstanceName	String	否	测试实例	实例名称。实例名称的命名规则如下：不能以数字、中划线开头。只能包含中文、字母、数字、下划线和中划线。长度限制在 1~128 之间。说明如不设定，则会以实例 ID 对实例进行命名。
DeletionProtection	String	否	Enabled	是否启用实例的删除保护功能。取值： Enabled：是。 Disabled：否。默认值。
ProxyNodeCustom	Object of ProxyNodeCustom	否	请参见请求示例。	实例的数据库代理配置。说明当主实例为多节点实例时，该字段为必选。当主实例为双节点实例时，不支持进行数据库代理配置。
StorageType	String	否	LocalSSD	实例的存储类型。取值范围： LocalSSD：本地盘。 CloudESSD_FlexPL：FlexPL 云盘。 CloudESSD_PL0：PL0 云盘。 CloudESSD_HighPerf：高性能云盘。说明如需设定 StorageSpace 参数，StorageType 参数为必传。当 InstanceType 取值为 SingleNode 时，StorageType 取值只能为 CloudESSD_FlexPL、CloudESSD_PL0 或 CloudESSD_HighPerf。在不同接口中，该参数取值范围不同。具体规则如下：在以下接口中作为请求参数时，StorageType 的取值只能为 LocalSSD。 RestoreToCrossRegionInstance RestoreToNewInstanceFromUserTos 在部分接口中作为请求参数时，该参数的取值范围与原实例的存储类型有关，具体规则如下：原实例的存储类型为 LocalSSD时，不支持变更存储类型。原实例的存储类型为 CloudESSD_PL0 时，可取值为 CloudESSD_PL0、 CloudESSD_FlexPL 或 CloudESSD_HighPerf。涉及的接口是： RebuildDBInstance RestoreToNewInstance ModifyDBNodeSpec
PrivateIpAddress	String	否	192.168.xxx.xxx	指定实例的默认终端在指定私有网络和子网下的 IP 地址。说明如不设定，则自动为实例的默认终端分配指定私有网络和子网下的 IP 地址。
AutoUpgradeMinorVersion	String	否	Auto	实例内核小版本的升级策略。取值： Auto：自动升级。当发布新的内核小版本时，实例将在设置的可维护时间段内，自动升级至最新的内核小版本。 Manual：手动升级。当发布新的内核小版本时，您需要在控制台手动至最新的内核小版本。具体操作，请参见手动升级实例内核小版本。说明若实例的内核小版本超出维护周期时，系统会暂时忽略内核小版本的升级策略设定，自动为实例升级内核小版本。

NodeInfoObject

参数	类型	是否必选	示例值	描述
NodeId	String	否	mysql-050b3e08****-r6e25	节点 ID。说明创建实例或新增节点时无需传入该参数，变更节点配置或删除节点时必传。
NodeType	String	是	Primary	节点类型，取值： Primary：主节点。 Secondary：备节点。 ReadOnly：只读节点。说明在查询实例价格详情接口（DescribeDBInstancePriceDetail）中，该字段为可选。在增加节点（CreateDBNodes）时，该字段取值只能为 ReadOnly（双节点实例）或 Secondary（多节点实例）。对于双节点实例，主节点和备节点有且只有 1 个，只读节点可选 0~10 个。对于多节点实例，主节点有且只有 1 个，最多可添加 8 个备节点，最少需有 1 个备节点。建议预留一个不承载业务的独立备节点，以便在必要时将其切换为主节点。若因未设置独立备节点致使所有备节点主备延迟过高，进而导致主节点切换失败，云数据库 MySQL 版不承担相关责任。
NodeSpec	String	是	rds.mysql.1c2g	节点规格。关于节点规格的详细信息，请参见产品规格。说明备节点的规格需与主节点的规格保持一致。只读节点规格可低于主节点的规格。但需注意，当只读节点规格低于主节点规格时，可能会因为主节点负载过高导致只读节点存在延迟甚至只读节点 OOM。建议为只读节点选择采与主节点相同或更高的规格。如 StorageType 取值为 CloudESSD_FlexPL 或 CloudESSD_PL0，NodeSpec 只能传入通用规格。
ZoneId	String	是	cn-beijing-a	节点所在可用区，可调用 DescribeAvailabilityZones 接口查询。在创建实例和新增节点时必传，变更节点配置或删除节点时可不传。说明一个实例的节点最多可分布在三个可用区。在一次变配中，最多可增删三个可用区下的节点。
NodeOperateType	String	否	Modify	操作类型。创建实例时无需传入该参数，修改节点配置时需要传入。取值范围： Create：增加节点。 Modify：修改节点配置。说明在增加节点（CreateDBNodes）时，该字段只能取值为 Create。在变更配置时，该字段只能取值为Modify。填写为 Delete时，该取值无实际意义。

ProxyNodeCustom

参数	类型	是否必选	示例值	描述
CpuNum	Integer	否	4	实例数据库代理服务的 CPU 核数。取值如下：取值范围：上限 1024。对于多节点实例：推荐代理核数为实例所有可服务节点总 CPU 数0.25，结果向上取整。代理核数的取值下限为 2 与主节点 CPU 核数0.125之间的较大值。对于双节点实例：推荐代理核数为实例所有可服务节点总CPU数 * 0.5，结果向上取整。代理核数的取值下限为 2 与主节点 CPU 核数*0.5之间的较大值。

返回参数

参数	类型	示例值	描述
InstanceId	String	mysql-9522449c****	创建的灾备实例的 ID。

示例

请求示例

返回示例

错误码

更多详情，请参见错误码。

最近更新时间：2026.10.23 17:52:44

这个页面对您有帮助吗？

有用

有用

无用

无用