调用CreateGadInstanceMember接口在RDS全球多活数据库集群中添加节点。

前提条件

已创建RDS全球多活数据库集群。可调用CreateGADInstance创建。

本功能的更多信息,请参见添加或移除单元节点

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateGadInstanceMember

系统规定参数。取值:CreateGadInstanceMember

CentralRegionId String cn-hangzhou

中心节点(主节点)所在地域ID,可调用DescribeRegions查询。

CentralDBInstanceId String gad-rm-bp1npi2j8********

中心节点ID,可调用DescribeGadInstances查询。

GadInstanceId String gad-rm-bp1npi2j8********

RDS全球多活数据库集群ID,可调用DescribeGadInstances查询。

CentralRdsDtsAdminAccount String test

中心节点的高权限账号,可调用DescribeAccounts查询。

CentralRdsDtsAdminPassword String Test12345

中心节点的高权限账号对应的密码。

DBList String { "testdb": { "name": "testdb", "all": false, "Table": { "order": { "name": "order", "all": true }, "ordernew": { "name": "ordernew", "all": true } } } }

中心节点中数据库信息的JSON数组,数组中所有数据库信息将同步至当前单元节点。参数说明:

  • name:数据库名称。
  • all:是否同步当前库或表中的所有数据。取值:true|false
  • Table:表名称。若all参数为false,则还需要在JSON数组中套入需要同步的表名称。

示例:{ "testdb": { "name": "testdb", "all": false, "Table": { "order": { "name": "order", "all": true }, "ordernew": { "name": "ordernew", "all": true } } } }

说明 更多信息,请参见迁移、同步或订阅对象说明
UnitNode.N.RegionID String cn-hangzhou

新建单元节点(备节点)所在的地域ID,可调用DescribeRegions查询。

N1~10的整数,代表第N个单元节点。一个RDS全球多活数据库集群中最多可以创建10个单元节点。

UnitNode.N.ZoneID String cn-hangzhou-h

新建单元节点所在的可用区ID,可调用DescribeRegions查询。

N1~10的整数,代表第N个单元节点。一个RDS全球多活数据库集群中最多可以创建10个单元节点。

UnitNode.N.VpcID String vpc-bp19ame5m1r3o********

新建单元节点的专有网络(VPC)ID。

N1~10的整数,代表第N个单元节点。一个RDS全球多活数据库集群中最多可以创建10个单元节点。

UnitNode.N.VSwitchID String vsw-bp1tg609m5j85********

新建单元节点的虚拟交换机(vSwitch) ID。

N1~10的整数,代表第N个单元节点。一个RDS全球多活数据库集群中最多可以创建10个单元节点。

UnitNode.N.SecurityIPList String 10.10.10.10

新建单元节点的IP白名单。多条记录请以英文逗号(,)隔开,不可重复,最多1000条记录。支持如下两种格式:

  • IP地址形式,例如:10.10.10.10
  • CIDR形式,例如:10.10.10.10/24(无类域间路由,24表示了地址中前缀的长度,范围为1~32)。

N1~10的整数,代表第N个单元节点。一个RDS全球多活数据库集群中最多可以创建10个单元节点。

UnitNode.N.DBInstanceStorage Long 20

新建单元节点的存储空间大小。单位:GB。每5 GB进行递增,取值范围请参见实例规格表。您也可以调用DescribeAvailableResource接口查询目标实例规格中可用的存储空间范围。

N1~10的整数,代表第N个单元节点。一个RDS全球多活数据库集群中最多可以创建10个单元节点。

UnitNode.N.ZoneIDSlave1 String cn-hangzhou-h

新建单元节点的备节点可用区ID。可调用DescribeRegions查询。

  • 如果和当前单元节点的ZoneId相同,则为单可用区部署。
  • 如果和当前单元节点的ZoneId不同,则为多可用区部署。

N1~10的整数,代表第N个单元节点。一个RDS全球多活数据库集群中最多可以创建10个单元节点。

UnitNode.N.ZoneIDSlave2 String cn-hangzhou-h

新建单元节点的日志节点可用区ID。可调用DescribeRegions查询。

  • 如果和当前单元节点的ZoneId相同,则为单可用区部署。
  • 如果和当前单元节点的ZoneId不同,则为多可用区部署。

N1~10的整数,代表第N个单元节点。一个RDS全球多活数据库集群中最多可以创建10个单元节点。

UnitNode.N.DtsInstanceClass String medium

新建单元节点的数据同步链路规格。取值:

  • small
  • medium
  • large
  • micro
说明 关于各规格的区别,请参见数据同步规格链路说明

N1~10的整数,代表第N个单元节点。一个RDS全球多活数据库集群中最多可以创建10个单元节点。

UnitNode.N.DbInstanceClass String rds.mysql.t1.small

新建单元节点的实例规格。取值详情请参见主实例规格表。您也可以调用DescribeAvailableResource接口查询目标地域中可用的实例规格列表。

N1~10的整数,代表第N个单元节点。一个RDS全球多活数据库集群中最多可以创建10个单元节点。

UnitNode.N.DBInstanceDescription String test

新建单元节点的名称。命名规则如下:

  • 长度为2~255个字符。
  • 以中文、英文字母开头,可以包含数字、中文、英文、下划线(_)、短横线(-)。
  • 不能以http://https://开头。

N1~10的整数,代表第N个单元节点。一个RDS全球多活数据库集群中最多可以创建10个单元节点。

UnitNode.N.Engine String MySQL

新建单元节点的数据库引擎。当前仅支持MySQL

N1~10的整数,代表第N个单元节点。一个RDS全球多活数据库集群中最多可以创建10个单元节点。

UnitNode.N.EngineVersion String 8.0

新建单元节点的数据库版本。取值:

  • 8.0
  • 5.7
  • 5.6
  • 5.5

N1~10的整数,代表第N个单元节点。一个RDS全球多活数据库集群中最多可以创建10个单元节点。

UnitNode.N.DtsConflict String overwrite

新建单元节点在同步时发生主键冲突采取的修复策略。取值:

  • overwrite:覆盖目标节点中发生冲突的主键。
  • interrupt:中止同步任务,报错并退出。
  • ignore:覆盖当前节点中发生冲突的主键。

N1~10的整数,代表第N个单元节点。一个RDS全球多活数据库集群中最多可以创建10个单元节点。

返回数据

名称 类型 示例值 描述
RequestId String 16C62438-491B-5C02-9B49-BA924A1372A2

请求ID。

Result Object

返回信息组成的数组。

GadInstanceName String gad-rm-bp1npi2j8********

全球多活数据库集群ID。

CreateCount String 2

本次调用创建的节点数量。

示例

请求示例

http(s)://rds.aliyuncs.com/?Action=CreateGadInstanceMember
&CentralDBInstanceId=gad-rm-bp1npi2j8********
&CentralRegionId=cn-hangzhou
&CentralRdsDtsAdminAccount=test
&CentralRdsDtsAdminPassword=Test12345
&DBList={\"testdb\":{\"name\":\"testdb\",\"all\":true}}
&GadInstanceId=gad-rm-bp1npi2j8********
&UnitNode.1.RegionID=cn-hangzhou
&UnitNode.1.DBInstanceDescription=test789
&UnitNode.1.DtsConflict=overwrite
&UnitNode.1.DtsInstanceClass=medium
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateGadInstanceMemberResponse>
<RequestId>16C62438-491B-5C02-9B49-BA924A1372A2</RequestId>
<Result>
    <CreateCount>2</CreateCount>
    <GadInstanceName>gad-rm-bp1npi2j8********</GadInstanceName>
</Result>
</CreateGadInstanceMemberResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "16C62438-491B-5C02-9B49-BA924A1372A2",
  "Result" : {
    "CreateCount" : "1",
    "GadInstanceName" : "gad-rm-bp1npi2j8********"
  }
}

错误码

访问错误中心查看更多错误码。