IncreaseReplicationFactor - Amazon DynamoDB

IncreaseReplicationFactor

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.

Note

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

ClusterName

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

Type: String

Required: Yes

NewReplicationFactor

The new number of nodes for the DAX cluster.

Type: Integer

Required: Yes

AvailabilityZones

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.

Cluster

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

Type: Cluster object

Errors

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

ClusterNotFoundFault

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

HTTP Status Code: 400

InsufficientClusterCapacityFault

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

HTTP Status Code: 400

InvalidClusterStateFault

The requested DAX cluster is not in the available state.

HTTP Status Code: 400

InvalidParameterCombinationException

Two or more incompatible parameters were specified.

HTTP Status Code: 400

InvalidParameterValueException

The value for a parameter is invalid.

HTTP Status Code: 400

InvalidVPCNetworkStateFault

The VPC network is in an invalid state.

HTTP Status Code: 400

NodeQuotaForClusterExceededFault

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

HTTP Status Code: 400

NodeQuotaForCustomerExceededFault

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

HTTP Status Code: 400

ServiceLinkedRoleNotFoundFault

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: