AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Represents a copy of an entire Redis cluster as of the time when the snapshot was taken.

Inheritance Hierarchy

System.Object
  Amazon.ElastiCache.Model.Snapshot

Namespace: Amazon.ElastiCache.Model
Assembly: AWSSDK.ElastiCache.dll
Version: 3.x.y.z

Syntax

C#
public class Snapshot

The Snapshot type exposes the following members

Constructors

NameDescription
Public Method Snapshot()

Properties

NameTypeDescription
Public Property ARN System.String

Gets and sets the property ARN.

The ARN (Amazon Resource Name) of the snapshot.

Public Property AutomaticFailover Amazon.ElastiCache.AutomaticFailoverStatus

Gets and sets the property AutomaticFailover.

Indicates the status of automatic failover for the source Redis replication group.

Public Property AutoMinorVersionUpgrade System.Boolean

Gets and sets the property AutoMinorVersionUpgrade.

 If you are running Redis engine version 6.0 or later, 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. 

Public Property CacheClusterCreateTime System.DateTime

Gets and sets the property CacheClusterCreateTime.

The date and time when the source cluster was created.

Public Property CacheClusterId System.String

Gets and sets the property CacheClusterId.

The user-supplied identifier of the source cluster.

Public Property CacheNodeType System.String

Gets and sets the property CacheNodeType.

The name of the compute and memory capacity node type for the source cluster.

The following node types are supported by ElastiCache. Generally speaking, the current generation types provide more memory and computational power at lower cost when compared to their equivalent previous generation counterparts.

  • General purpose:

    • Current generation:

      M7g node types: cache.m7g.large, cache.m7g.xlarge, cache.m7g.2xlarge, cache.m7g.4xlarge, cache.m7g.8xlarge, cache.m7g.12xlarge, cache.m7g.16xlarge

      For region availability, see Supported Node Types

      M6g node types (available only for Redis engine version 5.0.6 onward and for Memcached engine version 1.5.16 onward): cache.m6g.large, cache.m6g.xlarge, cache.m6g.2xlarge, cache.m6g.4xlarge, cache.m6g.8xlarge, cache.m6g.12xlarge, cache.m6g.16xlarge

      M5 node types:cache.m5.large, cache.m5.xlarge, cache.m5.2xlarge, cache.m5.4xlarge, cache.m5.12xlarge, cache.m5.24xlarge

      M4 node types:cache.m4.large, cache.m4.xlarge, cache.m4.2xlarge, cache.m4.4xlarge, cache.m4.10xlarge

      T4g node types (available only for Redis engine version 5.0.6 onward and Memcached engine version 1.5.16 onward): cache.t4g.micro, cache.t4g.small, cache.t4g.medium

      T3 node types:cache.t3.micro, cache.t3.small, cache.t3.medium

      T2 node types:cache.t2.micro, cache.t2.small, cache.t2.medium

    • Previous generation: (not recommended. Existing clusters are still supported but creation of new clusters is not supported for these types.)

      T1 node types:cache.t1.micro

      M1 node types:cache.m1.small, cache.m1.medium, cache.m1.large, cache.m1.xlarge

      M3 node types:cache.m3.medium, cache.m3.large, cache.m3.xlarge, cache.m3.2xlarge

  • Compute optimized:

    • Previous generation: (not recommended. Existing clusters are still supported but creation of new clusters is not supported for these types.)

      C1 node types:cache.c1.xlarge

  • Memory optimized:

    • Current generation:

      R7g node types: cache.r7g.large, cache.r7g.xlarge, cache.r7g.2xlarge, cache.r7g.4xlarge, cache.r7g.8xlarge, cache.r7g.12xlarge, cache.r7g.16xlarge

      For region availability, see Supported Node Types

      R6g node types (available only for Redis engine version 5.0.6 onward and for Memcached engine version 1.5.16 onward): cache.r6g.large, cache.r6g.xlarge, cache.r6g.2xlarge, cache.r6g.4xlarge, cache.r6g.8xlarge, cache.r6g.12xlarge, cache.r6g.16xlarge

      R5 node types:cache.r5.large, cache.r5.xlarge, cache.r5.2xlarge, cache.r5.4xlarge, cache.r5.12xlarge, cache.r5.24xlarge

      R4 node types:cache.r4.large, cache.r4.xlarge, cache.r4.2xlarge, cache.r4.4xlarge, cache.r4.8xlarge, cache.r4.16xlarge

    • Previous generation: (not recommended. Existing clusters are still supported but creation of new clusters is not supported for these types.)

      M2 node types:cache.m2.xlarge, cache.m2.2xlarge, cache.m2.4xlarge

      R3 node types:cache.r3.large, cache.r3.xlarge, cache.r3.2xlarge, cache.r3.4xlarge, cache.r3.8xlarge

Additional node type info

  • All current generation instance types are created in Amazon VPC by default.

  • Redis append-only files (AOF) are not supported for T1 or T2 instances.

  • Redis Multi-AZ with automatic failover is not supported on T1 instances.

  • Redis configuration variables appendonly and appendfsync are not supported on Redis version 2.8.22 and later.

Public Property CacheParameterGroupName System.String

Gets and sets the property CacheParameterGroupName.

The cache parameter group that is associated with the source cluster.

Public Property CacheSubnetGroupName System.String

Gets and sets the property CacheSubnetGroupName.

The name of the cache subnet group associated with the source cluster.

Public Property DataTiering Amazon.ElastiCache.DataTieringStatus

Gets and sets the property DataTiering.

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.

Public Property Engine System.String

Gets and sets the property Engine.

The name of the cache engine (memcached or redis) used by the source cluster.

Public Property EngineVersion System.String

Gets and sets the property EngineVersion.

The version of the cache engine version that is used by the source cluster.

Public Property KmsKeyId System.String

Gets and sets the property KmsKeyId.

The ID of the KMS key used to encrypt the snapshot.

Public Property NodeSnapshots System.Collections.Generic.List<Amazon.ElastiCache.Model.NodeSnapshot>

Gets and sets the property NodeSnapshots.

A list of the cache nodes in the source cluster.

Public Property NumCacheNodes System.Int32

Gets and sets the property NumCacheNodes.

The number of cache nodes in the source cluster.

For clusters running Redis, this value must be 1. For clusters running Memcached, this value must be between 1 and 40.

Public Property NumNodeGroups System.Int32

Gets and sets the property NumNodeGroups.

The number of node groups (shards) in this snapshot. When restoring from a snapshot, the number of node groups (shards) in the snapshot and in the restored replication group must be the same.

Public Property Port System.Int32

Gets and sets the property Port.

The port number used by each cache nodes in the source cluster.

Public Property PreferredAvailabilityZone System.String

Gets and sets the property PreferredAvailabilityZone.

The name of the Availability Zone in which the source cluster is located.

Public Property PreferredMaintenanceWindow System.String

Gets and sets the property PreferredMaintenanceWindow.

Specifies 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.

Valid values for ddd are:

  • sun

  • mon

  • tue

  • wed

  • thu

  • fri

  • sat

Example: sun:23:00-mon:01:30

Public Property PreferredOutpostArn System.String

Gets and sets the property PreferredOutpostArn.

The ARN (Amazon Resource Name) of the preferred outpost.

Public Property ReplicationGroupDescription System.String

Gets and sets the property ReplicationGroupDescription.

A description of the source replication group.

Public Property ReplicationGroupId System.String

Gets and sets the property ReplicationGroupId.

The unique identifier of the source replication group.

Public Property SnapshotName System.String

Gets and sets the property SnapshotName.

The name of a snapshot. For an automatic snapshot, the name is system-generated. For a manual snapshot, this is the user-provided name.

Public Property SnapshotRetentionLimit System.Int32

Gets and sets the property SnapshotRetentionLimit.

For an automatic snapshot, the number of days for which ElastiCache retains the snapshot before deleting it.

For manual snapshots, this field reflects the SnapshotRetentionLimit for the source cluster when the snapshot was created. This field is otherwise ignored: Manual snapshots do not expire, and can only be deleted using the DeleteSnapshot operation.

Important If the value of SnapshotRetentionLimit is set to zero (0), backups are turned off.

Public Property SnapshotSource System.String

Gets and sets the property SnapshotSource.

Indicates whether the snapshot is from an automatic backup (automated) or was created manually (manual).

Public Property SnapshotStatus System.String

Gets and sets the property SnapshotStatus.

The status of the snapshot. Valid values: creating | available | restoring | copying | deleting.

Public Property SnapshotWindow System.String

Gets and sets the property SnapshotWindow.

The daily time range during which ElastiCache takes daily snapshots of the source cluster.

Public Property TopicArn System.String

Gets and sets the property TopicArn.

The Amazon Resource Name (ARN) for the topic used by the source cluster for publishing notifications.

Public Property VpcId System.String

Gets and sets the property VpcId.

The Amazon Virtual Private Cloud identifier (VPC ID) of the cache subnet group for the source cluster.

Version Information

.NET Core App:
Supported in: 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.5, 4.0, 3.5