接口说明
适用引擎
RDS MySQL
相关功能文档
注意 使用该接口前，请仔细阅读功能文档，确保完全了解使用接口的前提条件及使用后造成的影响后，再进行操作。
RDS MySQL集群版增加实例节点
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI
Explorer可以自动生成SDK代码示例。
调试
调试
授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| rds:CreateDBNodes | Write |
|
|
无 |
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| ClientToken | string | 否 |
该参数用于保证请求的幂等性，防止重复提交请求。参数值由客户端生成，保证在不同请求间唯一。 该参数值由ASCII字符组成，最长不超过64个字符，不能包含非ASCII字符。 |
ETnLKlblzczshOTUbOCz**** |
| DBInstanceId | string | 是 |
实例ID。可调用DescribeDBInstances获取。 |
rm-2ze450g4ctg6t**** |
| DBNode | object [] | 是 |
集群节点列表。 |
|
| classCode | string | 是 |
节点规格信息。 |
mysql.n2.medium.xc |
| zoneId | string | 是 |
节点所在的可用区ID。 |
cn-zhangjiakou-a |
| ResourceGroupId | string | 否 |
资源组ID。可调用DescribeDBInstanceAttribute接口获取。 |
rg-acfmy***** |
返回参数
| 名称 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| object |
返回参数详情。 |
||
| RequestId | string |
请求ID。 |
7A41C147-C8D0-4DAE-A1A2-17EBCD60DFA1 |
| DBInstanceId | string |
实例ID。 |
rm-2ze450g4ctg6t**** |
| OrderId | long |
订单ID。 |
2133400000**** |
| NodeIds | string |
创建的节点ID。取值类型为String，多个节点以 |
rn-abcd2**** |
示例
正常返回示例
JSON格式
{
"RequestId": "7A41C147-C8D0-4DAE-A1A2-17EBCD60DFA1",
"DBInstanceId": "rm-2ze450g4ctg6t****",
"OrderId": 0,
"NodeIds": "rn-abcd2****"
}错误码
| HTTP status code | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | DBNodeFormatFault | The specified parameter DBNode is malformed | dbNode格式不正确 |
| 400 | DBNodeParameterRequired | The specified parameter DBNode is required. | 缺少dbNode参数 |
| 400 | DBNodeParameterTooManyItems | The specified parameter DBNode has too many items. | 新增dbNode节点数过多 |
| 400 | DBNodeParameter.InvalidClassCode | The ClassCode of the item of the specified parameter DBNode is inconsistent. | 参数DBNode中的ClassCode配置不一致。 |
| 400 | DBNodeParameter.InvalidValue | The specific param DBNode is not valid. | 对应参数DBNode无效。 |
| 400 | DBNodeParameter.NotFound | The specified parameter DBNode is not valid. | 指定的参数DBNode无效。 |
| 400 | InvalidMultiTenant | Multi tenants cannot exist in a same instance. | 一个实例中不允许存在多种租户类型的节点。 |
| 400 | InvalidClassCode | The specification code in the parameter is invalid. | 参数中的规格码是无效的。 |
| 403 | GroupReplicationNotSupport.InvalidEngineVersion | Group Replication requires the instance engine version to be 8.0. | 实例数据库版本不是MySQL 8.0，不支持组复制。 |
| 403 | GroupReplicationNotSupport.InvalidNodeClassCode | Group Replication requires the ClassCode of each node to be consistent. | 实例各节点间规格不一致，不支持组复制。 |
| 403 | GroupReplicationNotSupport.InvalidNodeNum | Group Replication is not supported, the number of nodes must be an odd number greater than or equal to 3. | 实例节点个数不是大于等于3的单数，不支持组复制。 |
| 403 | GroupReplicationNotSupport.InvalidXengine | Group Replication is not supported because the instance has xengine tables. | 实例存在xengine引擎表，不支持组复制。 |
| 403 | GroupReplicationNotSupport.MemoryTooSmall | Group Replication is not supported because the memory is too small. | 实例规格内存太小，不支持组复制。 |
| 403 | OperationDenied.DBType | The operation is not permitted due to type of the database. | 该类型数据库不支持此操作，请核实。 |
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 2023-11-23 | OpenAPI 错误码发生变更 | 看变更集 | ||||||||||
|
||||||||||||
| 2023-11-07 | OpenAPI 错误码发生变更 | 看变更集 | ||||||||||
|
||||||||||||
| 2023-10-20 | OpenAPI 错误码发生变更 | 看变更集 | ||||||||||
|
||||||||||||
| 2023-10-20 | OpenAPI 错误码发生变更 | 看变更集 | ||||||||||
|
||||||||||||
| 2023-09-08 | OpenAPI 错误码发生变更 | 看变更集 | ||||||||||
|
||||||||||||
| 2023-07-24 | OpenAPI 错误码发生变更 | 看变更集 | ||||||||||
|
||||||||||||
| 2023-06-27 | OpenAPI 错误码发生变更，OpenAPI 入参发生变更 | 看变更集 | ||||||||||
|
||||||||||||
| 2023-03-22 | OpenAPI 错误码发生变更，OpenAPI 返回结构发生变更 | 看变更集 | ||||||||||
|
内容没看懂？ 不太想学习？想快速解决？ 有偿解决： 联系专家
阿里云企业补贴进行中： 马上申请
腾讯云限时活动1折起，即将结束： 马上收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利:同意关联，立享优惠
转转请注明出处：https://www.yunxiaoer.com/154116.html