Skip to main content

@swamp/aws/elasticache

v2026.04.23.3

AWS ELASTICACHE infrastructure models

Repository

https://github.com/systeminit/swamp-extensions

Labels

awselasticachecloudinfrastructure

Contents

Quality score

Verified by Swamp

How well-documented and verifiable this extension is.

100%

Grade A

  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types1/1earned
  • Has description1/1earned
  • At least one platform tag (or universal)1/1earned
  • Two or more platform tags (or universal)1/1earned
  • License declared1/1earned
  • Verified public repository2/2earned

Install

$ swamp extension pull @swamp/aws/elasticache

parameter_group.tsv2026.04.23.2

Global Arguments

ArgumentTypeDescription
namestringInstance name for this resource (used as the unique identifier in the factory pattern)
DescriptionstringThe description for this cache parameter group.
Properties?recordA comma-delimited list of parameter name/value pairs. For more information see ModifyCacheParameterGroup in the Amazon ElastiCache API Reference Guide.
Tags?arrayTags are composed of a Key/Value pair. You can use tags to categorize and track each parameter group. The tag value null is permitted.
CacheParameterGroupFamilystringThe name of the cache parameter group family that this cache parameter group is compatible with.
createCreate a ElastiCache ParameterGroup
getGet a ElastiCache ParameterGroup
ArgumentTypeDescription
identifierstringThe primary identifier of the ElastiCache ParameterGroup
updateUpdate a ElastiCache ParameterGroup
deleteDelete a ElastiCache ParameterGroup
ArgumentTypeDescription
identifierstringThe primary identifier of the ElastiCache ParameterGroup
syncSync ElastiCache ParameterGroup state from AWS
replication_group.tsv2026.04.23.2

Global Arguments

ArgumentTypeDescription
ReplicationGroupId?stringThe replication group identifier. This parameter is stored as a lowercase string.
PreferredCacheClusterAZs?arrayA list of EC2 Availability Zones in which the replication group's clusters are created. The order of the Availability Zones in the list is the order in which clusters are allocated. The primary cluster is created in the first AZ in the list. This parameter is not used if there is more than one node group (shard). You should use NodeGroupConfiguration instead.
CacheSecurityGroupNames?arrayA list of cache security group names to associate with this replication group.
NodeGroupConfiguration?arrayNodeGroupConfiguration is a property of the AWS::ElastiCache::ReplicationGroup resource that configures an Amazon ElastiCache (ElastiCache) Redis cluster node group.
LogDeliveryConfigurations?arraySpecifies the destination, format and type of the logs.
SnapshotArns?arrayA list of Amazon Resource Names (ARN) that uniquely identify the Redis RDB snapshot files stored in Amazon S3.
UserGroupIds?arrayThe ID of user group to associate with the replication group.
NumNodeGroups?numberAn optional parameter that specifies the number of node groups (shards) for this Redis (cluster mode enabled) replication group. For Redis (cluster mode disabled) either omit this parameter or set it to 1.
NotificationTopicArn?stringThe Amazon Resource Name (ARN) of the Amazon Simple Notification Service (SNS) topic to which notifications are sent.
SnapshotName?stringThe name of a snapshot from which to restore data into the new replication group. The snapshot status changes to restoring while the new replication group is being created.
AutomaticFailoverEnabled?booleanSpecifies whether a read-only replica is automatically promoted to read/write primary if the existing primary fails. AutomaticFailoverEnabled must be enabled for Redis (cluster mode enabled) replication groups.
ReplicasPerNodeGroup?numberAn optional parameter that specifies the number of replica nodes in each node group (shard). Valid values are 0 to 5.
ReplicationGroupDescriptionstringA user-created description for the replication group.
MultiAZEnabled?booleanA flag indicating if you have Multi-AZ enabled to enhance fault tolerance. For more information, see Minimizing Downtime: Multi-AZ.
TransitEncryptionEnabled?booleanA flag that enables in-transit encryption when set to true.
Engine?stringThe name of the cache engine to be used for the clusters in this replication group.
Tags?arrayA list of cost allocation tags to be added to this resource. Tags are comma-separated key,value pairs (e.g. Key=myKey, Value=myKeyValue. You can include multiple tags as shown following: Key=myKey, Value=myKeyValue Key=mySecondKey, Value=mySecondKeyValue.
NumCacheClusters?numberThe number of clusters this replication group initially has.This parameter is not used if there is more than one node group (shard). You should use ReplicasPerNodeGroup instead.
EngineVersion?stringThe version number of the cache engine to be used for the clusters in this replication group. To view the supported cache engine versions, use the DescribeCacheEngineVersions operation.
KmsKeyId?stringThe ID of the KMS key used to encrypt the disk on the cluster.
CacheSubnetGroupName?stringThe name of the cache subnet group to be used for the replication group.
CacheParameterGroupName?stringThe name of the parameter group to associate with this replication group. If this argument is omitted, the default cache parameter group for the specified engine is used.
PreferredMaintenanceWindow?stringSpecifies the weekly time range during which maintenance on the cluster is performed. It is specified as a range in the format ddd:hh24:mi-ddd:hh24:mi (24H Clock UTC). The minimum maintenance window is a 60 minute period.
PrimaryClusterId?stringThe identifier of the cluster that serves as the primary for this replication group. This cluster must already exist and have a status of available.
AtRestEncryptionEnabled?booleanA flag that enables encryption at rest when set to true.AtRestEncryptionEnabled after the replication group is created. To enable encryption at rest on a replication group you must set AtRestEncryptionEnabled to true when you create the replication group.
AutoMinorVersionUpgrade?booleanThis parameter is currently disabled.
SecurityGroupIds?arrayOne or more Amazon VPC security groups associated with this replication group.
SnapshotWindow?stringThe daily time range (in UTC) during which ElastiCache begins taking a daily snapshot of your node group (shard).
CacheNodeType?stringThe compute and memory capacity of the nodes in the node group (shard).
SnapshotRetentionLimit?numberThe number of days for which ElastiCache retains automatic 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.
SnapshottingClusterId?stringThe cluster ID that is used as the daily snapshot source for the replication group. This parameter cannot be set for Redis (cluster mode enabled) replication groups.
AuthToken?stringReserved parameter. The password used to access a password protected server.AuthToken can be specified only on replication groups where TransitEncryptionEnabled is true. For more information.
IpDiscovery?stringThe network type you choose when creating a replication group, either ipv4 | ipv6. IPv6 is supported for workloads using Redis OSS engine version 6.2 onward or Memcached engine version 1.6.6 on all instances built on the Nitro system.
NetworkType?stringMust be either ipv4 | ipv6 | dual_stack. IPv6 is supported for workloads using Redis OSS engine version 6.2 onward or Memcached engine version 1.6.6 on all instances built on the Nitro system
GlobalReplicationGroupId?stringThe name of the Global datastore
DataTieringEnabled?booleanEnables 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.
TransitEncryptionMode?stringA setting that allows you to migrate your clients to use in-transit encryption, with no downtime. When setting TransitEncryptionEnabled to true, you can set your TransitEncryptionMode to preferred in the same request, to allow both encrypted and unencrypted connections at the same time. Once you migrate all your Redis OSS clients to use encrypted connections you can modify the value to required to allow encrypted connections only. Setting TransitEncryptionMode to required is a two-step process that requires you to first set the TransitEncryptionMode to preferred, after that you can set TransitEncryptionMode to required. This process will not trigger the replacement of the replication group.
ClusterMode?stringEnabled or Disabled. To modify cluster mode from Disabled to Enabled, you must first set the cluster mode to Compatible. Compatible mode allows your Redis OSS clients to connect using both cluster mode enabled and cluster mode disabled. After you migrate all Redis OSS clients to use cluster mode enabled, you can then complete cluster mode configuration and set the cluster mode to Enabled. For more information, see Modify cluster mode.
createCreate a ElastiCache ReplicationGroup
getGet a ElastiCache ReplicationGroup
ArgumentTypeDescription
identifierstringThe primary identifier of the ElastiCache ReplicationGroup
updateUpdate a ElastiCache ReplicationGroup
deleteDelete a ElastiCache ReplicationGroup
ArgumentTypeDescription
identifierstringThe primary identifier of the ElastiCache ReplicationGroup
syncSync ElastiCache ReplicationGroup state from AWS
subnet_group.tsv2026.04.23.2

Global Arguments

ArgumentTypeDescription
DescriptionstringThe description for the cache subnet group.
SubnetIdsarrayThe EC2 subnet IDs for the cache subnet group.
CacheSubnetGroupName?stringThe name for the cache subnet group. This value is stored as a lowercase string.
Tags?array
createCreate a ElastiCache SubnetGroup
getGet a ElastiCache SubnetGroup
ArgumentTypeDescription
identifierstringThe primary identifier of the ElastiCache SubnetGroup
updateUpdate a ElastiCache SubnetGroup
deleteDelete a ElastiCache SubnetGroup
ArgumentTypeDescription
identifierstringThe primary identifier of the ElastiCache SubnetGroup
syncSync ElastiCache SubnetGroup state from AWS
user_group.tsv2026.04.23.2

Global Arguments

ArgumentTypeDescription
UserGroupIdstringThe ID of the user group.
EngineenumThe target cache engine for the user group.
UserIdsarrayList of users associated to this user group.
Tags?arrayAn array of key-value pairs to apply to this user.
createCreate a ElastiCache UserGroup
getGet a ElastiCache UserGroup
ArgumentTypeDescription
identifierstringThe primary identifier of the ElastiCache UserGroup
updateUpdate a ElastiCache UserGroup
deleteDelete a ElastiCache UserGroup
ArgumentTypeDescription
identifierstringThe primary identifier of the ElastiCache UserGroup
syncSync ElastiCache UserGroup state from AWS
serverless_cache.tsv2026.04.23.2

Global Arguments

ArgumentTypeDescription
ServerlessCacheNamestringThe name of the Serverless Cache. This value must be unique.
Description?stringThe description of the Serverless Cache.
EnginestringThe engine name of the Serverless Cache.
MajorEngineVersion?stringThe major engine version of the Serverless Cache.
CacheUsageLimits?objectThe cached data capacity of the Serverless Cache.
KmsKeyId?stringThe ID of the KMS key used to encrypt the cluster.
SecurityGroupIds?arrayOne or more Amazon VPC security groups associated with this Serverless Cache.
SnapshotArnsToRestore?arrayThe ARN's of snapshot to restore Serverless Cache.
Tags?arrayAn array of key-value pairs to apply to this Serverless Cache.
UserGroupId?stringThe ID of the user group.
SubnetIds?arrayThe subnet id's of the Serverless Cache.
SnapshotRetentionLimit?numberThe snapshot retention limit of the Serverless Cache.
DailySnapshotTime?stringThe daily time range (in UTC) during which the service takes automatic snapshot of the Serverless Cache.
FinalSnapshotName?stringThe final snapshot name which is taken before Serverless Cache is deleted.
createCreate a ElastiCache ServerlessCache
getGet a ElastiCache ServerlessCache
ArgumentTypeDescription
identifierstringThe primary identifier of the ElastiCache ServerlessCache
updateUpdate a ElastiCache ServerlessCache
deleteDelete a ElastiCache ServerlessCache
ArgumentTypeDescription
identifierstringThe primary identifier of the ElastiCache ServerlessCache
syncSync ElastiCache ServerlessCache state from AWS
user.tsv2026.04.23.2

Global Arguments

ArgumentTypeDescription
UserIdstringThe ID of the user.
UserNamestringThe username of the user.
EngineenumThe target cache engine for the user.
AccessString?stringAccess permissions string used for this user account.
NoPasswordRequired?booleanIndicates a password is not required for this user account.
Passwords?arrayPasswords used for this user account. You can create up to two passwords for each user.
AuthenticationMode?objectAuthentication Type
Tags?arrayAn array of key-value pairs to apply to this user.
createCreate a ElastiCache User
getGet a ElastiCache User
ArgumentTypeDescription
identifierstringThe primary identifier of the ElastiCache User
updateUpdate a ElastiCache User
deleteDelete a ElastiCache User
ArgumentTypeDescription
identifierstringThe primary identifier of the ElastiCache User
syncSync ElastiCache User state from AWS
global_replication_group.tsv2026.04.23.2

Global Arguments

ArgumentTypeDescription
namestringInstance name for this resource (used as the unique identifier in the factory pattern)
GlobalReplicationGroupIdSuffix?stringThe suffix name of a Global Datastore. Amazon ElastiCache automatically applies a prefix to the Global Datastore ID when it is created. Each AWS Region has its own prefix.
AutomaticFailoverEnabled?booleanAutomaticFailoverEnabled
CacheNodeType?stringThe cache node type of the Global Datastore
EngineVersion?stringThe engine version of the Global Datastore.
Engine?stringThe engine of the Global Datastore.
CacheParameterGroupName?stringCache parameter group name to use for the new engine version. This parameter cannot be modified independently.
GlobalNodeGroupCount?numberIndicates the number of node groups in the Global Datastore.
GlobalReplicationGroupDescription?stringThe optional description of the Global Datastore
MembersarrayThe replication groups that comprise the Global Datastore.
RegionalConfigurations?arrayDescribes the replication group IDs, the AWS regions where they are stored and the shard configuration for each that comprise the Global Datastore
createCreate a ElastiCache GlobalReplicationGroup
getGet a ElastiCache GlobalReplicationGroup
ArgumentTypeDescription
identifierstringThe primary identifier of the ElastiCache GlobalReplicationGroup
updateUpdate a ElastiCache GlobalReplicationGroup
deleteDelete a ElastiCache GlobalReplicationGroup
ArgumentTypeDescription
identifierstringThe primary identifier of the ElastiCache GlobalReplicationGroup
syncSync ElastiCache GlobalReplicationGroup state from AWS