AWS::ElastiCache::Snapshot

ElastiCache Snapshot

Represents a copy of an entire cluster or replication group as of the time when the snapshot was taken.

Properties

5 configurable properties. 1 required. Click a row to see details.

Filter:
PropertyTypeFlags
SnapshotName
string
RequiredCreate-only
CacheClusterId
string
Create-only
KmsKeyId
string
Create-only
ReplicationGroupId
string
Create-only
Tags
Array<Tag>

Return Values

Values returned after the resource is created. Access these with Fn::GetAtt.

AttributeTypeDescription
ArnstringThe ARN (Amazon Resource Name) of the snapshot.
AutomaticFailoverstringIndicates the status of automatic failover for the source replication group.
AutoMinorVersionUpgradebooleanIf true, opt-in to the next auto minor version upgrade campaign.
CacheClusterCreateTimestringThe date and time when the source cluster was created.
CacheNodeTypestringThe name of the compute and memory capacity node type for the source cluster.
CacheParameterGroupNamestringThe cache parameter group that is associated with the source cluster.
CacheSubnetGroupNamestringThe name of the cache subnet group associated with the source cluster.
DataTieringstringEnables data tiering. Data tiering is only supported for replication groups using the r6gd node type.
EnginestringThe name of the cache engine used by the source cluster.
EngineVersionstringThe version of the cache engine version used by the source cluster.
NodeSnapshotsArray<NodeSnapshot>A list of the cache nodes in the source cluster.
NumCacheNodesintegerThe number of cache nodes in the source cluster.
NumNodeGroupsintegerThe number of node groups (shards) in this snapshot.
PortintegerThe port number used by each cache nodes in the source cluster.
PreferredAvailabilityZonestringThe name of the Availability Zone in which the source cluster is located.
PreferredMaintenanceWindowstringSpecifies the weekly time range during which maintenance on the cluster is performed.
ReplicationGroupDescriptionstringA description of the source replication group.
SnapshotRetentionLimitintegerFor an automatic snapshot, the number of days for which ElastiCache retains the snapshot before deleting it.
SnapshotSourcestringIndicates whether the snapshot is from an automatic backup (automated) or was created manually (manual).
SnapshotStatusstringThe status of the snapshot. Valid values: creating | available | restoring | copying | deleting | failed | deleted.
SnapshotWindowstringThe daily time range during which ElastiCache takes daily snapshots of the source cluster.
TopicArnstringThe Amazon Resource Name (ARN) for the topic used by the source cluster for publishing notifications.
VpcIdstringThe Amazon Virtual Private Cloud identifier (VPC ID) of the cache subnet group for the source cluster.

Sample CloudFormation Template

A minimal template with required properties and common optional ones.

template.yaml
AWSTemplateFormatVersion: "2010-09-09"
Description: Sample template for AWS::ElastiCache::Snapshot

Resources:
  MyResource:
    Type: AWS::ElastiCache::Snapshot
    Properties:
      SnapshotName: "my-snapshotname"
      Tags:
        - Key: Environment
          Value: Production

Required IAM Permissions

Permissions CloudFormation needs in your IAM role to manage this resource.

create

elasticache:CreateSnapshotelasticache:DescribeSnapshotselasticache:AddTagsToResourceelasticache:ListTagsForResourcekms:CreateGrantkms:DescribeKey

read

elasticache:DescribeSnapshotselasticache:ListTagsForResource

update

elasticache:DescribeSnapshotselasticache:AddTagsToResourceelasticache:RemoveTagsFromResourceelasticache:ListTagsForResource

delete

elasticache:DeleteSnapshotelasticache:DescribeSnapshots

list

elasticache:DescribeSnapshots

Learn AWS the Practical Way

Our bi-weekly newsletter teaches hands-on AWS fundamentals. No certification fluff - just practical knowledge.

Subscribe to Newsletter

Quick Facts

ServiceElastiCache
Properties28
Required1
TaggingSupported
Primary IDArn

Supported Operations

CreateReadUpdateDeleteList

Immutable After Creation

These properties cannot be changed after the resource is created. Updating them triggers a replacement.

SnapshotNameCacheClusterIdReplicationGroupIdKmsKeyId

External Links