IncreaseReplicationFactor - Amazon DynamoDB


Adds one or more nodes to a DAX cluster.

Request Syntax

{ "AvailabilityZones": [ "string" ], "ClusterName": "string", "NewReplicationFactor": number }

Request Parameters

The request accepts the following data in JSON format.


In the following list, the required parameters are described first.


The name of the DAX cluster that will receive additional nodes.

Type: String

Required: Yes


The new number of nodes for the DAX cluster.

Type: Integer

Required: Yes


The Availability Zones (AZs) in which the cluster nodes will be created. All nodes belonging to the cluster are placed in these Availability Zones. Use this parameter if you want to distribute the nodes across multiple AZs.

Type: Array of strings

Required: No

Response Syntax

{ "Cluster": { "ActiveNodes": number, "ClusterArn": "string", "ClusterDiscoveryEndpoint": { "Address": "string", "Port": number, "URL": "string" }, "ClusterEndpointEncryptionType": "string", "ClusterName": "string", "Description": "string", "IamRoleArn": "string", "NodeIdsToRemove": [ "string" ], "Nodes": [ { "AvailabilityZone": "string", "Endpoint": { "Address": "string", "Port": number, "URL": "string" }, "NodeCreateTime": number, "NodeId": "string", "NodeStatus": "string", "ParameterGroupStatus": "string" } ], "NodeType": "string", "NotificationConfiguration": { "TopicArn": "string", "TopicStatus": "string" }, "ParameterGroup": { "NodeIdsToReboot": [ "string" ], "ParameterApplyStatus": "string", "ParameterGroupName": "string" }, "PreferredMaintenanceWindow": "string", "SecurityGroups": [ { "SecurityGroupIdentifier": "string", "Status": "string" } ], "SSEDescription": { "Status": "string" }, "Status": "string", "SubnetGroup": "string", "TotalNodes": number } }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.


A description of the DAX cluster, with its new replication factor.

Type: Cluster object


For information about the errors that are common to all actions, see Common Errors.


The requested cluster ID does not refer to an existing DAX cluster.

HTTP Status Code: 400


There are not enough system resources to create the cluster you requested (or to resize an already-existing cluster).

HTTP Status Code: 400


The requested DAX cluster is not in the available state.

HTTP Status Code: 400


Two or more incompatible parameters were specified.

HTTP Status Code: 400


The value for a parameter is invalid.

HTTP Status Code: 400


The VPC network is in an invalid state.

HTTP Status Code: 400


You have attempted to exceed the maximum number of nodes for a DAX cluster.

HTTP Status Code: 400


You have attempted to exceed the maximum number of nodes for your AWS account.

HTTP Status Code: 400


The specified service linked role (SLR) was not found.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: