调用 IncreaseDBInstanceNodeNumber 接口为目标 Redis 实例增加单分片节点数量。 ## 请求类型异步请求。 ## 注意事项 * 仅主备实例（即 `InstanceClass` 为 `PrimarySecondary` ）支持调用该接口，单节点实例（即 `InstanceClass` 取值为 `Standalone` ）固定包含 1 个节点，不支持变更节点数量。关于不同实例或架构类型支持的变配方案详情，请参见[变配方案](https://docs.volcengine.com/docs/6293/71564)。 * 开启数据闪回后，发起配置变更将自动关闭数据闪回功能。数据闪回功能关闭后，之前的闪回时间点不再保留。您需要在配置变更完成后再调用 [StartContinuousBackup](https://docs.volcengine.com/docs/6293/71803) 接口开启数据闪回功能。更多详情，请参见[设置数据闪回功能](https://docs.volcengine.com/docs/6293/70868)。 ## 调试 [去调试](https://api.volcengine.com/api-explorer/debug?action=IncreaseDBInstanceNodeNumber&serviceCode=Redis&version=2020-12-07&groupName=变更实例配置) ## 请求参数 |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |InstanceId |String |是 |redis\-cn0212gzmh2xs\*\*\*\* |实例 ID。

说明

您可以调用 DescribeDBInstances接口查询目标地域下所有 Redis 实例的基本信息，包括实例 ID。

说明

关于可维护时间段的更多信息，请参见设置可维护时间段。

说明

您可以调用 DescribeDBInstanceDetail 接口查询指定实例的详情信息，包括每个分片中当前节点数。

每个账号在每个地域下默认最多可创建 4 个 256MiB 规格的节点，若您需要调整 256MiB 规格节点的购买配额（上限为 10 个），请参见约束与使用限制。

说明

仅当选择了需要在变更前创建备份（即 CreateBackup 为 true ）时，该参数生效。

若不设置备份名称，默认使用备份 ID 作为名称。

| |ClientToken |String |否 |WbiAlPqJM6tMoSOYhT\*\*\*\* |用于保证请求的幂等性，防止重复提交请求。由客户端生成该参数值，要保证在不同请求间唯一，大小写敏感且不超过 127 个 ASCII 字符。 | ### ConfigureNode |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |AZ |String |否 |cn\-beijing\-a |设置新增节点所属的可用区。

实例的新增节点数（即 `NodesNumberToIncrease` 参数值）以及可用区部署方案（即 `MultiAZ` 参数值）都会影响当前参数的填写情况，其中：

* 当实例部署方案为多可用区部署（即 `MultiAZ` 取值为 `enabled`）时，**该参数必填**，且**传入的可用区数量必须等于需要增加的单分片节点数量**（即 `NodesNumberToIncrease` 参数值）。

例如，您需要为多可用区实例的每个分片中再增加 2 个节点，这两个节点分别在可用区 A 和 B，那么您可以参考如下设置：

```JavaScript```
```"NodesNumberToIncrease":2,```
```"ConfigureNewNodes": [```
``` {```
``` "AZ": "cn-beijing-a"```
``` },```
``` {```
``` "AZ": "cn-beijing-b"```
``` }```
```] ```

* 当实例部署方案为单可用区部署（即 `MultiAZ` 取值为 `disabled`）时，无需设置该参数。新增加的节点默认会加入实例当前所在的可用区。

说明

您可以调用 DescribeZones 接口查询目标地域下的可用区信息，包括可用区 ID。

您可以调用 DescribeDBInstanceDetail接口查询指定实例的详情信息，包括是否设置了多可用区部署方案。

| ## 返回参数 |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |OrderNO |String |Order716986589022527\*\*\*\* |订单编号。 | ## 示例 ## 请求示例 ```JSON POST https://redis.cn-beijing.volcengineapi.com/?Action=IncreaseDBInstanceNodeNumber&Version=2020-12-07 HTTP/1.1 Host: redis.cn-beijing.volcengineapi.com Content-Type: application/json; charset=utf-8 X-Date: 20201103T104027Z Authorization: HMAC-SHA256 Credential=AK****/20201103/cn-beijing/Redis/request,SignedHeaders=content-type;host;x-date,Signature=**** { "InstanceId": "redis-cn0212gzmh2xs****", "ApplyImmediately": true, "CreateBackup": true, "ConfigureNewNodes": [ { "AZ": "cn-beijing-b" }, { "AZ": "cn-beijing-a" } ], "NodesNumberToIncrease": 2 } ``` ## 返回示例 ```JSON { "ResponseMetadata": { "RequestId": "20230509153711EDF4F0D1DBEFA625xxxx", "Action": "IncreaseDBInstanceNodeNumber", "Version": "2020-12-07", "Service": "Redis", "Region": "cn-beijing" }, "Result": { "OrderNO": "Order723108288213844****" } } ``` ## 请求示例 ```JSON POST https://redis.cn-beijing.volcengineapi.com/?Action=IncreaseDBInstanceNodeNumber&Version=2020-12-07 HTTP/1.1 Host: redis.cn-beijing.volcengineapi.com Content-Type: application/json; charset=utf-8 X-Date: 20201103T104027Z Authorization: HMAC-SHA256 Credential=AK****/20201103/cn-beijing/Redis/request,SignedHeaders=content-type;host;x-date,Signature=**** { "InstanceId": "redis-cn0212gzmh2xs****", "ApplyImmediately": true, "CreateBackup": true, "NodesNumberToIncrease": 2 } ``` ## 返回示例 ```JSON { "ResponseMetadata": { "RequestId": "20230509153711EDF4F0D1DBEFA625xxxx", "Action": "IncreaseDBInstanceNodeNumber", "Version": "2020-12-07", "Service": "Redis", "Region": "cn-beijing" }, "Result": { "OrderNO": "Order723108288213844****" } } ``` ## 错误码更多详情，请参见[错误码](https://docs.volcengine.com/docs/6293/73664)。

缓存数据库 Redis 版