ModifyGlobalReplicationGroup - Amazon ElastiCache


Modifies the settings for a Global Datastore.

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.


This parameter causes the modifications in this request and any pending modifications to be applied, asynchronously and as soon as possible. Modifications to Global Replication Groups cannot be requested to be applied in PreferredMaintenceWindow.

Type: Boolean

Required: Yes


The name of the Global Datastore

Type: String

Required: Yes


Determines whether a read replica is automatically promoted to read/write primary if the existing primary encounters a failure.

Type: Boolean

Required: No


A valid cache node type that you want to scale this Global Datastore to.

Type: String

Required: No


The upgraded version of the cache engine to be run on the clusters in the Global Datastore.

Type: String

Required: No


A description of the Global Datastore

Type: String

Required: No

Response Elements

The following element is returned by the service.


Consists of a primary cluster that accepts writes and an associated secondary cluster that resides in a different AWS region. The secondary cluster accepts only reads. The primary cluster automatically replicates updates to the secondary cluster.

  • The GlobalReplicationGroupIdSuffix represents the name of the Global Datastore, which is what you use to associate a secondary cluster.

Type: GlobalReplicationGroup object


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


The Global Datastore does not exist

HTTP Status Code: 404


The Global Datastore is not available or in primary-only state.

HTTP Status Code: 400


The value for a parameter is invalid.

HTTP Status Code: 400

See Also

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