ModifyGlobalReplicationGroup - Amazon ElastiCache

ModifyGlobalReplicationGroup

Modifies the settings for a Global datastore.

Request Parameters

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

ApplyImmediately

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

GlobalReplicationGroupId

The name of the Global datastore

Type: String

Required: Yes

AutomaticFailoverEnabled

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

Type: Boolean

Required: No

CacheNodeType

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

Type: String

Required: No

CacheParameterGroupName

The name of the cache parameter group to use with the Global datastore. It must be compatible with the major engine version used by the Global datastore.

Type: String

Required: No

Engine

Modifies the engine listed in a global replication group message. The options are redis, memcached or valkey.

Type: String

Required: No

EngineVersion

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

Type: String

Required: No

GlobalReplicationGroupDescription

A description of the Global datastore

Type: String

Required: No

Response Elements

The following element is returned by the service.

GlobalReplicationGroup

Consists of a primary cluster that accepts writes and an associated secondary cluster that resides in a different Amazon 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

Errors

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

GlobalReplicationGroupNotFoundFault

The Global datastore does not exist

HTTP Status Code: 404

InvalidGlobalReplicationGroupState

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

HTTP Status Code: 400

InvalidParameterValue

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: