ReplicationGroup
¶
Source code in docs_src/capo_elasticache/types/replication_group.py
35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 | |
arn
instance-attribute
¶
arn: NotRequired[String]
The ARN (Amazon Resource Name) of the replication group.
at_rest_encryption_enabled
instance-attribute
¶
at_rest_encryption_enabled: NotRequired[BooleanOptional]
A flag that enables encryption at-rest on the cluster when set to true. In some cases, encryption at-rest may be enabled even when this value is false. Use StorageEncryptionType to view the effective encryption state of a cluster.
You cannot modify the value of AtRestEncryptionEnabled after the cluster is created.
Default: true when using Valkey, false when using Redis OSS
auth_token_enabled
instance-attribute
¶
auth_token_enabled: NotRequired[BooleanOptional]
A flag that enables using an AuthToken (password) when issuing Valkey or Redis OSS commands.
Default: false
auth_token_last_modified_date
instance-attribute
¶
auth_token_last_modified_date: NotRequired[TStamp]
The date the auth token was last modified
auto_minor_version_upgrade
instance-attribute
¶
auto_minor_version_upgrade: NotRequired[Boolean]
If you are running Valkey 7.2 and above, or Redis OSS engine version 6.0 and above, set this parameter to yes if you want to opt-in to the next auto minor version upgrade campaign. This parameter is disabled for previous versions.
automatic_failover
instance-attribute
¶
automatic_failover: NotRequired[AutomaticFailoverStatus]
Indicates the status of automatic failover for this Valkey or Redis OSS replication group.
cache_node_type
instance-attribute
¶
cache_node_type: NotRequired[String]
The name of the compute and memory capacity node type for each node in the replication group.
cluster_enabled
instance-attribute
¶
cluster_enabled: NotRequired[BooleanOptional]
A flag indicating whether or not this replication group is cluster enabled; i.e., whether its data can be partitioned across multiple shards (API/CLI: node groups).
Valid values: true | false
cluster_mode
instance-attribute
¶
cluster_mode: NotRequired[ClusterMode]
Enabled or Disabled. To modify cluster mode from Disabled to Enabled, you must first set the cluster mode to Compatible. Compatible mode allows your Valkey or Redis OSS clients to connect using both cluster mode enabled and cluster mode disabled. After you migrate all Valkey or Redis OSS clients to use cluster mode enabled, you can then complete cluster mode configuration and set the cluster mode to Enabled.
configuration_endpoint
instance-attribute
¶
configuration_endpoint: NotRequired[Endpoint]
The configuration endpoint for this replication group. Use the configuration endpoint to connect to this replication group.
data_tiering
instance-attribute
¶
data_tiering: NotRequired[DataTieringStatus]
Enables data tiering. Data tiering is only supported for replication groups using the r6gd node type. This parameter must be set to true when using r6gd nodes. For more information, see Data tiering.
description
instance-attribute
¶
description: NotRequired[String]
The user supplied description of the replication group.
durability
instance-attribute
¶
durability: NotRequired[Durability]
The durability setting of the replication group. For more information, see Durability.
effective_durability
instance-attribute
¶
effective_durability: NotRequired[EffectiveDurability]
The effective durability of the replication group. When Durability is set to default, the service resolves the actual durability based on the engine version, cluster mode, and other parameters. This field reflects the resolved value. For more information, see Configuring Durability.
engine
instance-attribute
¶
engine: NotRequired[String]
The engine used in a replication group. The options are valkey, memcached or redis.
global_replication_group_info
instance-attribute
¶
global_replication_group_info: NotRequired[GlobalReplicationGroupInfo]
The name of the Global datastore and role of this replication group in the Global datastore.
ip_discovery
instance-attribute
¶
ip_discovery: NotRequired[IpDiscovery]
The network type you choose when modifying a cluster, either ipv4 | ipv6. IPv6 is supported for workloads using Valkey 7.2 and above, Redis OSS engine version 6.2 to 7.1 or Memcached engine version 1.6.6 and above on all instances built on the Nitro system.
kms_key_id
instance-attribute
¶
kms_key_id: NotRequired[String]
The ID of the KMS key used to encrypt the disk in the cluster.
log_delivery_configurations
instance-attribute
¶
log_delivery_configurations: NotRequired[LogDeliveryConfigurationList]
Returns the destination, format and type of the logs.
member_clusters
instance-attribute
¶
member_clusters: NotRequired[ClusterIdList]
The names of all the cache clusters that are part of this replication group.
member_clusters_outpost_arns
instance-attribute
¶
member_clusters_outpost_arns: NotRequired[ReplicationGroupOutpostArnList]
The outpost ARNs of the replication group's member clusters.
multi_az
instance-attribute
¶
multi_az: NotRequired[MultiAZStatus]
A flag indicating if you have Multi-AZ enabled to enhance fault tolerance. For more information, see Minimizing Downtime: Multi-AZ
network_type
instance-attribute
¶
network_type: NotRequired[NetworkType]
Must be either ipv4 | ipv6 | dual_stack. IPv6 is supported for workloads using Valkey 7.2 and above, Redis OSS engine version 6.2 to 7.1 or Memcached engine version 1.6.6 and above on all instances built on the Nitro system.
node_groups
instance-attribute
¶
node_groups: NotRequired[NodeGroupList]
A list of node groups in this replication group. For Valkey or Redis OSS (cluster mode disabled) replication groups, this is a single-element list. For Valkey or Redis OSS (cluster mode enabled) replication groups, the list contains an entry for each node group (shard).
pending_modified_values
instance-attribute
¶
pending_modified_values: NotRequired[ReplicationGroupPendingModifiedValues]
A group of settings to be applied to the replication group, either immediately or during the next maintenance window.
replication_group_create_time
instance-attribute
¶
replication_group_create_time: NotRequired[TStamp]
The date and time when the cluster was created.
replication_group_id
instance-attribute
¶
replication_group_id: NotRequired[String]
The identifier for the replication group.
snapshot_retention_limit
instance-attribute
¶
snapshot_retention_limit: NotRequired[IntegerOptional]
The number of days for which ElastiCache retains automatic cluster snapshots before deleting them. For example, if you set SnapshotRetentionLimit to 5, a snapshot that was taken today is retained for 5 days before being deleted.
If the value of SnapshotRetentionLimit is set to zero (0), backups are turned off.
snapshot_window
instance-attribute
¶
snapshot_window: NotRequired[String]
The daily time range (in UTC) during which ElastiCache begins taking a daily snapshot of your node group (shard).
Example: 05:00-09:00
If you do not specify this parameter, ElastiCache automatically chooses an appropriate time range.
This parameter is only valid if the Engine parameter is redis.
snapshotting_cluster_id
instance-attribute
¶
snapshotting_cluster_id: NotRequired[String]
The cluster ID that is used as the daily snapshot source for the replication group.
status
instance-attribute
¶
status: NotRequired[String]
The current state of this replication group - creating, available, modifying, deleting, create-failed, snapshotting.
storage_encryption_type
instance-attribute
¶
storage_encryption_type: NotRequired[StorageEncryptionType]
Indicates the type of encryption for data stored at rest in the replication group. The value is none if at-rest encryption is not enabled, sse-elasticache if an ElastiCache service-managed key is used, or sse-kms if a customer-managed KMS key is used.
transit_encryption_enabled
instance-attribute
¶
transit_encryption_enabled: NotRequired[BooleanOptional]
A flag that enables in-transit encryption when set to true.
Required: Only available when creating a replication group in an Amazon VPC using Redis OSS version 3.2.6, 4.x or later.
Default: false
transit_encryption_mode
instance-attribute
¶
transit_encryption_mode: NotRequired[TransitEncryptionMode]
A setting that allows you to migrate your clients to use in-transit encryption, with no downtime.
user_group_ids
instance-attribute
¶
user_group_ids: NotRequired[UserGroupIdList]
The ID of the user group associated to the replication group.