Class CreateCacheClusterRequest
- java.lang.Object
-
- com.amazonaws.AmazonWebServiceRequest
-
- com.amazonaws.services.elasticache.model.CreateCacheClusterRequest
-
- All Implemented Interfaces:
ReadLimitInfo,Serializable,Cloneable
public class CreateCacheClusterRequest extends AmazonWebServiceRequest implements Serializable, Cloneable
Represents the input of a CreateCacheCluster action.
- See Also:
- Serialized Form
-
-
Field Summary
-
Fields inherited from class com.amazonaws.AmazonWebServiceRequest
NOOP
-
-
Constructor Summary
Constructors Constructor Description CreateCacheClusterRequest()Default constructor for CreateCacheClusterRequest object.CreateCacheClusterRequest(String cacheClusterId, Integer numCacheNodes, String cacheNodeType, String engine, List<String> cacheSecurityGroupNames)Constructs a new CreateCacheClusterRequest object.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description CreateCacheClusterRequestclone()Creates a shallow clone of this request.booleanequals(Object obj)BooleangetAutoMinorVersionUpgrade()This parameter is currently disabled.StringgetAZMode()Specifies whether the nodes in this Memcached node group are created in a single Availability Zone or created across multiple Availability Zones in the cluster's region.StringgetCacheClusterId()The node group identifier.StringgetCacheNodeType()The compute and memory capacity of the nodes in the node group.StringgetCacheParameterGroupName()The name of the parameter group to associate with this cache cluster.List<String>getCacheSecurityGroupNames()A list of security group names to associate with this cache cluster.StringgetCacheSubnetGroupName()The name of the subnet group to be used for the cache cluster.StringgetEngine()The name of the cache engine to be used for this cache cluster.StringgetEngineVersion()The version number of the cache engine to be used for this cache cluster.StringgetNotificationTopicArn()The Amazon Resource Name (ARN) of the Amazon Simple Notification Service (SNS) topic to which notifications will be sent.IntegergetNumCacheNodes()The initial number of cache nodes that the cache cluster will have.IntegergetPort()The port number on which each of the cache nodes will accept connections.StringgetPreferredAvailabilityZone()The EC2 Availability Zone in which the cache cluster will be created.List<String>getPreferredAvailabilityZones()A list of the Availability Zones in which cache nodes will be created.StringgetPreferredMaintenanceWindow()Specifies the weekly time range during which maintenance on the cache cluster is performed.StringgetReplicationGroupId()The ID of the replication group to which this cache cluster should belong.List<String>getSecurityGroupIds()One or more VPC security groups associated with the cache cluster.List<String>getSnapshotArns()A single-element string list containing an Amazon Resource Name (ARN) that uniquely identifies a Redis RDB snapshot file stored in Amazon S3.StringgetSnapshotName()The name of a snapshot from which to restore data into the new node group.IntegergetSnapshotRetentionLimit()The number of days for which ElastiCache will retain automatic snapshots before deleting them.StringgetSnapshotWindow()The daily time range (in UTC) during which ElastiCache will begin taking a daily snapshot of your node group.List<Tag>getTags()A list of cost allocation tags to be added to this resource.inthashCode()BooleanisAutoMinorVersionUpgrade()This parameter is currently disabled.voidsetAutoMinorVersionUpgrade(Boolean autoMinorVersionUpgrade)This parameter is currently disabled.voidsetAZMode(AZMode aZMode)Specifies whether the nodes in this Memcached node group are created in a single Availability Zone or created across multiple Availability Zones in the cluster's region.voidsetAZMode(String aZMode)Specifies whether the nodes in this Memcached node group are created in a single Availability Zone or created across multiple Availability Zones in the cluster's region.voidsetCacheClusterId(String cacheClusterId)The node group identifier.voidsetCacheNodeType(String cacheNodeType)The compute and memory capacity of the nodes in the node group.voidsetCacheParameterGroupName(String cacheParameterGroupName)The name of the parameter group to associate with this cache cluster.voidsetCacheSecurityGroupNames(Collection<String> cacheSecurityGroupNames)A list of security group names to associate with this cache cluster.voidsetCacheSubnetGroupName(String cacheSubnetGroupName)The name of the subnet group to be used for the cache cluster.voidsetEngine(String engine)The name of the cache engine to be used for this cache cluster.voidsetEngineVersion(String engineVersion)The version number of the cache engine to be used for this cache cluster.voidsetNotificationTopicArn(String notificationTopicArn)The Amazon Resource Name (ARN) of the Amazon Simple Notification Service (SNS) topic to which notifications will be sent.voidsetNumCacheNodes(Integer numCacheNodes)The initial number of cache nodes that the cache cluster will have.voidsetPort(Integer port)The port number on which each of the cache nodes will accept connections.voidsetPreferredAvailabilityZone(String preferredAvailabilityZone)The EC2 Availability Zone in which the cache cluster will be created.voidsetPreferredAvailabilityZones(Collection<String> preferredAvailabilityZones)A list of the Availability Zones in which cache nodes will be created.voidsetPreferredMaintenanceWindow(String preferredMaintenanceWindow)Specifies the weekly time range during which maintenance on the cache cluster is performed.voidsetReplicationGroupId(String replicationGroupId)The ID of the replication group to which this cache cluster should belong.voidsetSecurityGroupIds(Collection<String> securityGroupIds)One or more VPC security groups associated with the cache cluster.voidsetSnapshotArns(Collection<String> snapshotArns)A single-element string list containing an Amazon Resource Name (ARN) that uniquely identifies a Redis RDB snapshot file stored in Amazon S3.voidsetSnapshotName(String snapshotName)The name of a snapshot from which to restore data into the new node group.voidsetSnapshotRetentionLimit(Integer snapshotRetentionLimit)The number of days for which ElastiCache will retain automatic snapshots before deleting them.voidsetSnapshotWindow(String snapshotWindow)The daily time range (in UTC) during which ElastiCache will begin taking a daily snapshot of your node group.voidsetTags(Collection<Tag> tags)A list of cost allocation tags to be added to this resource.StringtoString()Returns a string representation of this object; useful for testing and debugging.CreateCacheClusterRequestwithAutoMinorVersionUpgrade(Boolean autoMinorVersionUpgrade)This parameter is currently disabled.CreateCacheClusterRequestwithAZMode(AZMode aZMode)Specifies whether the nodes in this Memcached node group are created in a single Availability Zone or created across multiple Availability Zones in the cluster's region.CreateCacheClusterRequestwithAZMode(String aZMode)Specifies whether the nodes in this Memcached node group are created in a single Availability Zone or created across multiple Availability Zones in the cluster's region.CreateCacheClusterRequestwithCacheClusterId(String cacheClusterId)The node group identifier.CreateCacheClusterRequestwithCacheNodeType(String cacheNodeType)The compute and memory capacity of the nodes in the node group.CreateCacheClusterRequestwithCacheParameterGroupName(String cacheParameterGroupName)The name of the parameter group to associate with this cache cluster.CreateCacheClusterRequestwithCacheSecurityGroupNames(String... cacheSecurityGroupNames)A list of security group names to associate with this cache cluster.CreateCacheClusterRequestwithCacheSecurityGroupNames(Collection<String> cacheSecurityGroupNames)A list of security group names to associate with this cache cluster.CreateCacheClusterRequestwithCacheSubnetGroupName(String cacheSubnetGroupName)The name of the subnet group to be used for the cache cluster.CreateCacheClusterRequestwithEngine(String engine)The name of the cache engine to be used for this cache cluster.CreateCacheClusterRequestwithEngineVersion(String engineVersion)The version number of the cache engine to be used for this cache cluster.CreateCacheClusterRequestwithNotificationTopicArn(String notificationTopicArn)The Amazon Resource Name (ARN) of the Amazon Simple Notification Service (SNS) topic to which notifications will be sent.CreateCacheClusterRequestwithNumCacheNodes(Integer numCacheNodes)The initial number of cache nodes that the cache cluster will have.CreateCacheClusterRequestwithPort(Integer port)The port number on which each of the cache nodes will accept connections.CreateCacheClusterRequestwithPreferredAvailabilityZone(String preferredAvailabilityZone)The EC2 Availability Zone in which the cache cluster will be created.CreateCacheClusterRequestwithPreferredAvailabilityZones(String... preferredAvailabilityZones)A list of the Availability Zones in which cache nodes will be created.CreateCacheClusterRequestwithPreferredAvailabilityZones(Collection<String> preferredAvailabilityZones)A list of the Availability Zones in which cache nodes will be created.CreateCacheClusterRequestwithPreferredMaintenanceWindow(String preferredMaintenanceWindow)Specifies the weekly time range during which maintenance on the cache cluster is performed.CreateCacheClusterRequestwithReplicationGroupId(String replicationGroupId)The ID of the replication group to which this cache cluster should belong.CreateCacheClusterRequestwithSecurityGroupIds(String... securityGroupIds)One or more VPC security groups associated with the cache cluster.CreateCacheClusterRequestwithSecurityGroupIds(Collection<String> securityGroupIds)One or more VPC security groups associated with the cache cluster.CreateCacheClusterRequestwithSnapshotArns(String... snapshotArns)A single-element string list containing an Amazon Resource Name (ARN) that uniquely identifies a Redis RDB snapshot file stored in Amazon S3.CreateCacheClusterRequestwithSnapshotArns(Collection<String> snapshotArns)A single-element string list containing an Amazon Resource Name (ARN) that uniquely identifies a Redis RDB snapshot file stored in Amazon S3.CreateCacheClusterRequestwithSnapshotName(String snapshotName)The name of a snapshot from which to restore data into the new node group.CreateCacheClusterRequestwithSnapshotRetentionLimit(Integer snapshotRetentionLimit)The number of days for which ElastiCache will retain automatic snapshots before deleting them.CreateCacheClusterRequestwithSnapshotWindow(String snapshotWindow)The daily time range (in UTC) during which ElastiCache will begin taking a daily snapshot of your node group.CreateCacheClusterRequestwithTags(Tag... tags)A list of cost allocation tags to be added to this resource.CreateCacheClusterRequestwithTags(Collection<Tag> tags)A list of cost allocation tags to be added to this resource.-
Methods inherited from class com.amazonaws.AmazonWebServiceRequest
copyBaseTo, getCloneRoot, getCloneSource, getCustomQueryParameters, getCustomRequestHeaders, getGeneralProgressListener, getReadLimit, getRequestClientOptions, getRequestCredentials, getRequestCredentialsProvider, getRequestMetricCollector, getSdkClientExecutionTimeout, getSdkRequestTimeout, putCustomQueryParameter, putCustomRequestHeader, setGeneralProgressListener, setRequestCredentials, setRequestCredentialsProvider, setRequestMetricCollector, setSdkClientExecutionTimeout, setSdkRequestTimeout, withGeneralProgressListener, withRequestMetricCollector, withSdkClientExecutionTimeout, withSdkRequestTimeout
-
-
-
-
Constructor Detail
-
CreateCacheClusterRequest
public CreateCacheClusterRequest()
Default constructor for CreateCacheClusterRequest object. Callers should use the setter or fluent setter (with...) methods to initialize the object after creating it.
-
CreateCacheClusterRequest
public CreateCacheClusterRequest(String cacheClusterId, Integer numCacheNodes, String cacheNodeType, String engine, List<String> cacheSecurityGroupNames)
Constructs a new CreateCacheClusterRequest object. Callers should use the setter or fluent setter (with...) methods to initialize any additional object members.- Parameters:
cacheClusterId- The node group identifier. This parameter is stored as a lowercase string.Constraints:
- A name must contain from 1 to 20 alphanumeric characters or hyphens.
- The first character must be a letter.
- A name cannot end with a hyphen or contain two consecutive hyphens.
numCacheNodes- The initial number of cache nodes that the cache cluster will have.For clusters running Redis, this value must be 1. For clusters running Memcached, this value must be between 1 and 20.
If you need more than 20 nodes for your Memcached cluster, please fill out the ElastiCache Limit Increase Request form at http://aws.amazon.com/contact-us/elasticache-node-limit-request/< /a>.
cacheNodeType- The compute and memory capacity of the nodes in the node group.Valid node types are as follows:
- General purpose:
- Current generation:
cache.t2.micro,cache.t2.small,cache.t2.medium,cache.m3.medium,cache.m3.large,cache.m3.xlarge,cache.m3.2xlarge - Previous generation:
cache.t1.micro,cache.m1.small,cache.m1.medium,cache.m1.large,cache.m1.xlarge
- Current generation:
- Compute optimized:
cache.c1.xlarge - Memory optimized
- Current generation:
cache.r3.large,cache.r3.xlarge,cache.r3.2xlarge,cache.r3.4xlarge,cache.r3.8xlarge - Previous generation:
cache.m2.xlarge,cache.m2.2xlarge,cache.m2.4xlarge
- Current generation:
Notes:
- All t2 instances are created in an Amazon Virtual Private Cloud (VPC).
- Redis backup/restore is not supported for t2 instances.
- Redis Append-only files (AOF) functionality is not supported for t1 or t2 instances.
For a complete listing of cache node types and specifications, see Amazon ElastiCache Product Features and Details and Cache Node Type-Specific Parameters for Memcached or Cache Node Type-Specific Parameters for Redis.
- General purpose:
engine- The name of the cache engine to be used for this cache cluster.Valid values for this parameter are:
memcached|rediscacheSecurityGroupNames- A list of security group names to associate with this cache cluster.Use this parameter only when you are creating a cache cluster outside of an Amazon Virtual Private Cloud (VPC).
-
-
Method Detail
-
setCacheClusterId
public void setCacheClusterId(String cacheClusterId)
The node group identifier. This parameter is stored as a lowercase string.
Constraints:
- A name must contain from 1 to 20 alphanumeric characters or hyphens.
- The first character must be a letter.
- A name cannot end with a hyphen or contain two consecutive hyphens.
- Parameters:
cacheClusterId- The node group identifier. This parameter is stored as a lowercase string.Constraints:
- A name must contain from 1 to 20 alphanumeric characters or hyphens.
- The first character must be a letter.
- A name cannot end with a hyphen or contain two consecutive hyphens.
-
getCacheClusterId
public String getCacheClusterId()
The node group identifier. This parameter is stored as a lowercase string.
Constraints:
- A name must contain from 1 to 20 alphanumeric characters or hyphens.
- The first character must be a letter.
- A name cannot end with a hyphen or contain two consecutive hyphens.
- Returns:
- The node group identifier. This parameter is stored as a
lowercase string.
Constraints:
- A name must contain from 1 to 20 alphanumeric characters or hyphens.
- The first character must be a letter.
- A name cannot end with a hyphen or contain two consecutive hyphens.
-
withCacheClusterId
public CreateCacheClusterRequest withCacheClusterId(String cacheClusterId)
The node group identifier. This parameter is stored as a lowercase string.
Constraints:
- A name must contain from 1 to 20 alphanumeric characters or hyphens.
- The first character must be a letter.
- A name cannot end with a hyphen or contain two consecutive hyphens.
- Parameters:
cacheClusterId- The node group identifier. This parameter is stored as a lowercase string.Constraints:
- A name must contain from 1 to 20 alphanumeric characters or hyphens.
- The first character must be a letter.
- A name cannot end with a hyphen or contain two consecutive hyphens.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
setReplicationGroupId
public void setReplicationGroupId(String replicationGroupId)
The ID of the replication group to which this cache cluster should belong. If this parameter is specified, the cache cluster will be added to the specified replication group as a read replica; otherwise, the cache cluster will be a standalone primary that is not part of any replication group.
If the specified replication group is Multi-AZ enabled and the availability zone is not specified, the cache cluster will be created in availability zones that provide the best spread of read replicas across availability zones.
Note: This parameter is only valid if the
Engineparameter isredis.- Parameters:
replicationGroupId- The ID of the replication group to which this cache cluster should belong. If this parameter is specified, the cache cluster will be added to the specified replication group as a read replica; otherwise, the cache cluster will be a standalone primary that is not part of any replication group.If the specified replication group is Multi-AZ enabled and the availability zone is not specified, the cache cluster will be created in availability zones that provide the best spread of read replicas across availability zones.
Note: This parameter is only valid if the
Engineparameter isredis.
-
getReplicationGroupId
public String getReplicationGroupId()
The ID of the replication group to which this cache cluster should belong. If this parameter is specified, the cache cluster will be added to the specified replication group as a read replica; otherwise, the cache cluster will be a standalone primary that is not part of any replication group.
If the specified replication group is Multi-AZ enabled and the availability zone is not specified, the cache cluster will be created in availability zones that provide the best spread of read replicas across availability zones.
Note: This parameter is only valid if the
Engineparameter isredis.- Returns:
- The ID of the replication group to which this cache cluster
should belong. If this parameter is specified, the cache cluster
will be added to the specified replication group as a read
replica; otherwise, the cache cluster will be a standalone
primary that is not part of any replication group.
If the specified replication group is Multi-AZ enabled and the availability zone is not specified, the cache cluster will be created in availability zones that provide the best spread of read replicas across availability zones.
Note: This parameter is only valid if the
Engineparameter isredis.
-
withReplicationGroupId
public CreateCacheClusterRequest withReplicationGroupId(String replicationGroupId)
The ID of the replication group to which this cache cluster should belong. If this parameter is specified, the cache cluster will be added to the specified replication group as a read replica; otherwise, the cache cluster will be a standalone primary that is not part of any replication group.
If the specified replication group is Multi-AZ enabled and the availability zone is not specified, the cache cluster will be created in availability zones that provide the best spread of read replicas across availability zones.
Note: This parameter is only valid if the
Engineparameter isredis.- Parameters:
replicationGroupId- The ID of the replication group to which this cache cluster should belong. If this parameter is specified, the cache cluster will be added to the specified replication group as a read replica; otherwise, the cache cluster will be a standalone primary that is not part of any replication group.If the specified replication group is Multi-AZ enabled and the availability zone is not specified, the cache cluster will be created in availability zones that provide the best spread of read replicas across availability zones.
Note: This parameter is only valid if the
Engineparameter isredis.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
setAZMode
public void setAZMode(String aZMode)
Specifies whether the nodes in this Memcached node group are created in a single Availability Zone or created across multiple Availability Zones in the cluster's region.
This parameter is only supported for Memcached cache clusters.
If the
AZModeandPreferredAvailabilityZonesare not specified, ElastiCache assumessingle-azmode.- Parameters:
aZMode- Specifies whether the nodes in this Memcached node group are created in a single Availability Zone or created across multiple Availability Zones in the cluster's region.This parameter is only supported for Memcached cache clusters.
If the
AZModeandPreferredAvailabilityZonesare not specified, ElastiCache assumessingle-azmode.- See Also:
AZMode
-
getAZMode
public String getAZMode()
Specifies whether the nodes in this Memcached node group are created in a single Availability Zone or created across multiple Availability Zones in the cluster's region.
This parameter is only supported for Memcached cache clusters.
If the
AZModeandPreferredAvailabilityZonesare not specified, ElastiCache assumessingle-azmode.- Returns:
- Specifies whether the nodes in this Memcached node group are
created in a single Availability Zone or created across multiple
Availability Zones in the cluster's region.
This parameter is only supported for Memcached cache clusters.
If the
AZModeandPreferredAvailabilityZonesare not specified, ElastiCache assumessingle-azmode. - See Also:
AZMode
-
withAZMode
public CreateCacheClusterRequest withAZMode(String aZMode)
Specifies whether the nodes in this Memcached node group are created in a single Availability Zone or created across multiple Availability Zones in the cluster's region.
This parameter is only supported for Memcached cache clusters.
If the
AZModeandPreferredAvailabilityZonesare not specified, ElastiCache assumessingle-azmode.- Parameters:
aZMode- Specifies whether the nodes in this Memcached node group are created in a single Availability Zone or created across multiple Availability Zones in the cluster's region.This parameter is only supported for Memcached cache clusters.
If the
AZModeandPreferredAvailabilityZonesare not specified, ElastiCache assumessingle-azmode.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
AZMode
-
setAZMode
public void setAZMode(AZMode aZMode)
Specifies whether the nodes in this Memcached node group are created in a single Availability Zone or created across multiple Availability Zones in the cluster's region.
This parameter is only supported for Memcached cache clusters.
If the
AZModeandPreferredAvailabilityZonesare not specified, ElastiCache assumessingle-azmode.- Parameters:
aZMode- Specifies whether the nodes in this Memcached node group are created in a single Availability Zone or created across multiple Availability Zones in the cluster's region.This parameter is only supported for Memcached cache clusters.
If the
AZModeandPreferredAvailabilityZonesare not specified, ElastiCache assumessingle-azmode.- See Also:
AZMode
-
withAZMode
public CreateCacheClusterRequest withAZMode(AZMode aZMode)
Specifies whether the nodes in this Memcached node group are created in a single Availability Zone or created across multiple Availability Zones in the cluster's region.
This parameter is only supported for Memcached cache clusters.
If the
AZModeandPreferredAvailabilityZonesare not specified, ElastiCache assumessingle-azmode.- Parameters:
aZMode- Specifies whether the nodes in this Memcached node group are created in a single Availability Zone or created across multiple Availability Zones in the cluster's region.This parameter is only supported for Memcached cache clusters.
If the
AZModeandPreferredAvailabilityZonesare not specified, ElastiCache assumessingle-azmode.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
AZMode
-
setPreferredAvailabilityZone
public void setPreferredAvailabilityZone(String preferredAvailabilityZone)
The EC2 Availability Zone in which the cache cluster will be created.
All nodes belonging to this Memcached cache cluster are placed in the preferred Availability Zone. If you want to create your nodes across multiple Availability Zones, use
PreferredAvailabilityZones.Default: System chosen Availability Zone.
- Parameters:
preferredAvailabilityZone- The EC2 Availability Zone in which the cache cluster will be created.All nodes belonging to this Memcached cache cluster are placed in the preferred Availability Zone. If you want to create your nodes across multiple Availability Zones, use
PreferredAvailabilityZones.Default: System chosen Availability Zone.
-
getPreferredAvailabilityZone
public String getPreferredAvailabilityZone()
The EC2 Availability Zone in which the cache cluster will be created.
All nodes belonging to this Memcached cache cluster are placed in the preferred Availability Zone. If you want to create your nodes across multiple Availability Zones, use
PreferredAvailabilityZones.Default: System chosen Availability Zone.
- Returns:
- The EC2 Availability Zone in which the cache cluster will be
created.
All nodes belonging to this Memcached cache cluster are placed in the preferred Availability Zone. If you want to create your nodes across multiple Availability Zones, use
PreferredAvailabilityZones.Default: System chosen Availability Zone.
-
withPreferredAvailabilityZone
public CreateCacheClusterRequest withPreferredAvailabilityZone(String preferredAvailabilityZone)
The EC2 Availability Zone in which the cache cluster will be created.
All nodes belonging to this Memcached cache cluster are placed in the preferred Availability Zone. If you want to create your nodes across multiple Availability Zones, use
PreferredAvailabilityZones.Default: System chosen Availability Zone.
- Parameters:
preferredAvailabilityZone- The EC2 Availability Zone in which the cache cluster will be created.All nodes belonging to this Memcached cache cluster are placed in the preferred Availability Zone. If you want to create your nodes across multiple Availability Zones, use
PreferredAvailabilityZones.Default: System chosen Availability Zone.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
getPreferredAvailabilityZones
public List<String> getPreferredAvailabilityZones()
A list of the Availability Zones in which cache nodes will be created. The order of the zones in the list is not important.
This option is only supported on Memcached.
If you are creating your cache cluster in an Amazon VPC (recommended) you can only locate nodes in Availability Zones that are associated with the subnets in the selected subnet group.
The number of Availability Zones listed must equal the value of
NumCacheNodes.If you want all the nodes in the same Availability Zone, use
PreferredAvailabilityZoneinstead, or repeat the Availability Zone multiple times in the list.Default: System chosen Availability Zones.
Example: One Memcached node in each of three different Availability Zones:
Example: All three Memcached nodes in one Availability Zone:
- Returns:
- A list of the Availability Zones in which cache nodes will be
created. The order of the zones in the list is not important.
This option is only supported on Memcached.
If you are creating your cache cluster in an Amazon VPC (recommended) you can only locate nodes in Availability Zones that are associated with the subnets in the selected subnet group.
The number of Availability Zones listed must equal the value of
NumCacheNodes.If you want all the nodes in the same Availability Zone, use
PreferredAvailabilityZoneinstead, or repeat the Availability Zone multiple times in the list.Default: System chosen Availability Zones.
Example: One Memcached node in each of three different Availability Zones:
Example: All three Memcached nodes in one Availability Zone:
-
setPreferredAvailabilityZones
public void setPreferredAvailabilityZones(Collection<String> preferredAvailabilityZones)
A list of the Availability Zones in which cache nodes will be created. The order of the zones in the list is not important.
This option is only supported on Memcached.
If you are creating your cache cluster in an Amazon VPC (recommended) you can only locate nodes in Availability Zones that are associated with the subnets in the selected subnet group.
The number of Availability Zones listed must equal the value of
NumCacheNodes.If you want all the nodes in the same Availability Zone, use
PreferredAvailabilityZoneinstead, or repeat the Availability Zone multiple times in the list.Default: System chosen Availability Zones.
Example: One Memcached node in each of three different Availability Zones:
Example: All three Memcached nodes in one Availability Zone:
- Parameters:
preferredAvailabilityZones- A list of the Availability Zones in which cache nodes will be created. The order of the zones in the list is not important.This option is only supported on Memcached.
If you are creating your cache cluster in an Amazon VPC (recommended) you can only locate nodes in Availability Zones that are associated with the subnets in the selected subnet group.
The number of Availability Zones listed must equal the value of
NumCacheNodes.If you want all the nodes in the same Availability Zone, use
PreferredAvailabilityZoneinstead, or repeat the Availability Zone multiple times in the list.Default: System chosen Availability Zones.
Example: One Memcached node in each of three different Availability Zones:
Example: All three Memcached nodes in one Availability Zone:
-
withPreferredAvailabilityZones
public CreateCacheClusterRequest withPreferredAvailabilityZones(String... preferredAvailabilityZones)
A list of the Availability Zones in which cache nodes will be created. The order of the zones in the list is not important.
This option is only supported on Memcached.
If you are creating your cache cluster in an Amazon VPC (recommended) you can only locate nodes in Availability Zones that are associated with the subnets in the selected subnet group.
The number of Availability Zones listed must equal the value of
NumCacheNodes.If you want all the nodes in the same Availability Zone, use
PreferredAvailabilityZoneinstead, or repeat the Availability Zone multiple times in the list.Default: System chosen Availability Zones.
Example: One Memcached node in each of three different Availability Zones:
Example: All three Memcached nodes in one Availability Zone:
NOTE: This method appends the values to the existing list (if any). Use
setPreferredAvailabilityZones(java.util.Collection)orwithPreferredAvailabilityZones(java.util.Collection)if you want to override the existing values.- Parameters:
preferredAvailabilityZones- A list of the Availability Zones in which cache nodes will be created. The order of the zones in the list is not important.This option is only supported on Memcached.
If you are creating your cache cluster in an Amazon VPC (recommended) you can only locate nodes in Availability Zones that are associated with the subnets in the selected subnet group.
The number of Availability Zones listed must equal the value of
NumCacheNodes.If you want all the nodes in the same Availability Zone, use
PreferredAvailabilityZoneinstead, or repeat the Availability Zone multiple times in the list.Default: System chosen Availability Zones.
Example: One Memcached node in each of three different Availability Zones:
Example: All three Memcached nodes in one Availability Zone:
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
withPreferredAvailabilityZones
public CreateCacheClusterRequest withPreferredAvailabilityZones(Collection<String> preferredAvailabilityZones)
A list of the Availability Zones in which cache nodes will be created. The order of the zones in the list is not important.
This option is only supported on Memcached.
If you are creating your cache cluster in an Amazon VPC (recommended) you can only locate nodes in Availability Zones that are associated with the subnets in the selected subnet group.
The number of Availability Zones listed must equal the value of
NumCacheNodes.If you want all the nodes in the same Availability Zone, use
PreferredAvailabilityZoneinstead, or repeat the Availability Zone multiple times in the list.Default: System chosen Availability Zones.
Example: One Memcached node in each of three different Availability Zones:
Example: All three Memcached nodes in one Availability Zone:
- Parameters:
preferredAvailabilityZones- A list of the Availability Zones in which cache nodes will be created. The order of the zones in the list is not important.This option is only supported on Memcached.
If you are creating your cache cluster in an Amazon VPC (recommended) you can only locate nodes in Availability Zones that are associated with the subnets in the selected subnet group.
The number of Availability Zones listed must equal the value of
NumCacheNodes.If you want all the nodes in the same Availability Zone, use
PreferredAvailabilityZoneinstead, or repeat the Availability Zone multiple times in the list.Default: System chosen Availability Zones.
Example: One Memcached node in each of three different Availability Zones:
Example: All three Memcached nodes in one Availability Zone:
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
setNumCacheNodes
public void setNumCacheNodes(Integer numCacheNodes)
The initial number of cache nodes that the cache cluster will have.
For clusters running Redis, this value must be 1. For clusters running Memcached, this value must be between 1 and 20.
If you need more than 20 nodes for your Memcached cluster, please fill out the ElastiCache Limit Increase Request form at http://aws.amazon.com/contact-us/elasticache-node-limit-request/.
- Parameters:
numCacheNodes- The initial number of cache nodes that the cache cluster will have.For clusters running Redis, this value must be 1. For clusters running Memcached, this value must be between 1 and 20.
If you need more than 20 nodes for your Memcached cluster, please fill out the ElastiCache Limit Increase Request form at http://aws.amazon.com/contact-us/elasticache-node-limit-request/< /a>.
-
getNumCacheNodes
public Integer getNumCacheNodes()
The initial number of cache nodes that the cache cluster will have.
For clusters running Redis, this value must be 1. For clusters running Memcached, this value must be between 1 and 20.
If you need more than 20 nodes for your Memcached cluster, please fill out the ElastiCache Limit Increase Request form at http://aws.amazon.com/contact-us/elasticache-node-limit-request/.
- Returns:
- The initial number of cache nodes that the cache cluster will
have.
For clusters running Redis, this value must be 1. For clusters running Memcached, this value must be between 1 and 20.
If you need more than 20 nodes for your Memcached cluster, please fill out the ElastiCache Limit Increase Request form at http://aws.amazon.com/contact-us/elasticache-node-limit-request/ .
-
withNumCacheNodes
public CreateCacheClusterRequest withNumCacheNodes(Integer numCacheNodes)
The initial number of cache nodes that the cache cluster will have.
For clusters running Redis, this value must be 1. For clusters running Memcached, this value must be between 1 and 20.
If you need more than 20 nodes for your Memcached cluster, please fill out the ElastiCache Limit Increase Request form at http://aws.amazon.com/contact-us/elasticache-node-limit-request/.
- Parameters:
numCacheNodes- The initial number of cache nodes that the cache cluster will have.For clusters running Redis, this value must be 1. For clusters running Memcached, this value must be between 1 and 20.
If you need more than 20 nodes for your Memcached cluster, please fill out the ElastiCache Limit Increase Request form at http://aws.amazon.com/contact-us/elasticache-node-limit-request/< /a>.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
setCacheNodeType
public void setCacheNodeType(String cacheNodeType)
The compute and memory capacity of the nodes in the node group.
Valid node types are as follows:
- General purpose:
- Current generation:
cache.t2.micro,cache.t2.small,cache.t2.medium,cache.m3.medium,cache.m3.large,cache.m3.xlarge,cache.m3.2xlarge - Previous generation:
cache.t1.micro,cache.m1.small,cache.m1.medium,cache.m1.large,cache.m1.xlarge
- Current generation:
- Compute optimized:
cache.c1.xlarge - Memory optimized
- Current generation:
cache.r3.large,cache.r3.xlarge,cache.r3.2xlarge,cache.r3.4xlarge,cache.r3.8xlarge - Previous generation:
cache.m2.xlarge,cache.m2.2xlarge,cache.m2.4xlarge
- Current generation:
Notes:
- All t2 instances are created in an Amazon Virtual Private Cloud (VPC).
- Redis backup/restore is not supported for t2 instances.
- Redis Append-only files (AOF) functionality is not supported for t1 or t2 instances.
For a complete listing of cache node types and specifications, see Amazon ElastiCache Product Features and Details and Cache Node Type-Specific Parameters for Memcached or Cache Node Type-Specific Parameters for Redis.
- Parameters:
cacheNodeType- The compute and memory capacity of the nodes in the node group.Valid node types are as follows:
- General purpose:
- Current generation:
cache.t2.micro,cache.t2.small,cache.t2.medium,cache.m3.medium,cache.m3.large,cache.m3.xlarge,cache.m3.2xlarge - Previous generation:
cache.t1.micro,cache.m1.small,cache.m1.medium,cache.m1.large,cache.m1.xlarge
- Current generation:
- Compute optimized:
cache.c1.xlarge - Memory optimized
- Current generation:
cache.r3.large,cache.r3.xlarge,cache.r3.2xlarge,cache.r3.4xlarge,cache.r3.8xlarge - Previous generation:
cache.m2.xlarge,cache.m2.2xlarge,cache.m2.4xlarge
- Current generation:
Notes:
- All t2 instances are created in an Amazon Virtual Private Cloud (VPC).
- Redis backup/restore is not supported for t2 instances.
- Redis Append-only files (AOF) functionality is not supported for t1 or t2 instances.
For a complete listing of cache node types and specifications, see Amazon ElastiCache Product Features and Details and Cache Node Type-Specific Parameters for Memcached or Cache Node Type-Specific Parameters for Redis.
- General purpose:
- General purpose:
-
getCacheNodeType
public String getCacheNodeType()
The compute and memory capacity of the nodes in the node group.
Valid node types are as follows:
- General purpose:
- Current generation:
cache.t2.micro,cache.t2.small,cache.t2.medium,cache.m3.medium,cache.m3.large,cache.m3.xlarge,cache.m3.2xlarge - Previous generation:
cache.t1.micro,cache.m1.small,cache.m1.medium,cache.m1.large,cache.m1.xlarge
- Current generation:
- Compute optimized:
cache.c1.xlarge - Memory optimized
- Current generation:
cache.r3.large,cache.r3.xlarge,cache.r3.2xlarge,cache.r3.4xlarge,cache.r3.8xlarge - Previous generation:
cache.m2.xlarge,cache.m2.2xlarge,cache.m2.4xlarge
- Current generation:
Notes:
- All t2 instances are created in an Amazon Virtual Private Cloud (VPC).
- Redis backup/restore is not supported for t2 instances.
- Redis Append-only files (AOF) functionality is not supported for t1 or t2 instances.
For a complete listing of cache node types and specifications, see Amazon ElastiCache Product Features and Details and Cache Node Type-Specific Parameters for Memcached or Cache Node Type-Specific Parameters for Redis.
- Returns:
- The compute and memory capacity of the nodes in the node
group.
Valid node types are as follows:
- General purpose:
- Current generation:
cache.t2.micro,cache.t2.small,cache.t2.medium,cache.m3.medium,cache.m3.large,cache.m3.xlarge,cache.m3.2xlarge - Previous generation:
cache.t1.micro,cache.m1.small,cache.m1.medium,cache.m1.large,cache.m1.xlarge
- Current generation:
- Compute optimized:
cache.c1.xlarge - Memory optimized
- Current generation:
cache.r3.large,cache.r3.xlarge,cache.r3.2xlarge,cache.r3.4xlarge,cache.r3.8xlarge - Previous generation:
cache.m2.xlarge,cache.m2.2xlarge,cache.m2.4xlarge
- Current generation:
Notes:
- All t2 instances are created in an Amazon Virtual Private Cloud (VPC).
- Redis backup/restore is not supported for t2 instances.
- Redis Append-only files (AOF) functionality is not supported for t1 or t2 instances.
For a complete listing of cache node types and specifications, see Amazon ElastiCache Product Features and Details and Cache Node Type-Specific Parameters for Memcached or Cache Node Type-Specific Parameters for Redis.
- General purpose:
- General purpose:
-
withCacheNodeType
public CreateCacheClusterRequest withCacheNodeType(String cacheNodeType)
The compute and memory capacity of the nodes in the node group.
Valid node types are as follows:
- General purpose:
- Current generation:
cache.t2.micro,cache.t2.small,cache.t2.medium,cache.m3.medium,cache.m3.large,cache.m3.xlarge,cache.m3.2xlarge - Previous generation:
cache.t1.micro,cache.m1.small,cache.m1.medium,cache.m1.large,cache.m1.xlarge
- Current generation:
- Compute optimized:
cache.c1.xlarge - Memory optimized
- Current generation:
cache.r3.large,cache.r3.xlarge,cache.r3.2xlarge,cache.r3.4xlarge,cache.r3.8xlarge - Previous generation:
cache.m2.xlarge,cache.m2.2xlarge,cache.m2.4xlarge
- Current generation:
Notes:
- All t2 instances are created in an Amazon Virtual Private Cloud (VPC).
- Redis backup/restore is not supported for t2 instances.
- Redis Append-only files (AOF) functionality is not supported for t1 or t2 instances.
For a complete listing of cache node types and specifications, see Amazon ElastiCache Product Features and Details and Cache Node Type-Specific Parameters for Memcached or Cache Node Type-Specific Parameters for Redis.
- Parameters:
cacheNodeType- The compute and memory capacity of the nodes in the node group.Valid node types are as follows:
- General purpose:
- Current generation:
cache.t2.micro,cache.t2.small,cache.t2.medium,cache.m3.medium,cache.m3.large,cache.m3.xlarge,cache.m3.2xlarge - Previous generation:
cache.t1.micro,cache.m1.small,cache.m1.medium,cache.m1.large,cache.m1.xlarge
- Current generation:
- Compute optimized:
cache.c1.xlarge - Memory optimized
- Current generation:
cache.r3.large,cache.r3.xlarge,cache.r3.2xlarge,cache.r3.4xlarge,cache.r3.8xlarge - Previous generation:
cache.m2.xlarge,cache.m2.2xlarge,cache.m2.4xlarge
- Current generation:
Notes:
- All t2 instances are created in an Amazon Virtual Private Cloud (VPC).
- Redis backup/restore is not supported for t2 instances.
- Redis Append-only files (AOF) functionality is not supported for t1 or t2 instances.
For a complete listing of cache node types and specifications, see Amazon ElastiCache Product Features and Details and Cache Node Type-Specific Parameters for Memcached or Cache Node Type-Specific Parameters for Redis.
- General purpose:
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- General purpose:
-
setEngine
public void setEngine(String engine)
The name of the cache engine to be used for this cache cluster.
Valid values for this parameter are:
memcached|redis- Parameters:
engine- The name of the cache engine to be used for this cache cluster.Valid values for this parameter are:
memcached|redis
-
getEngine
public String getEngine()
The name of the cache engine to be used for this cache cluster.
Valid values for this parameter are:
memcached|redis- Returns:
- The name of the cache engine to be used for this cache
cluster.
Valid values for this parameter are:
memcached|redis
-
withEngine
public CreateCacheClusterRequest withEngine(String engine)
The name of the cache engine to be used for this cache cluster.
Valid values for this parameter are:
memcached|redis- Parameters:
engine- The name of the cache engine to be used for this cache cluster.Valid values for this parameter are:
memcached|redis- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
setEngineVersion
public void setEngineVersion(String engineVersion)
The version number of the cache engine to be used for this cache cluster. To view the supported cache engine versions, use the DescribeCacheEngineVersions action.
Important: You can upgrade to a newer engine version (see Selecting a Cache Engine and Version), but you cannot downgrade to an earlier engine version. If you want to use an earlier engine version, you must delete the existing cache cluster or replication group and create it anew with the earlier engine version.
- Parameters:
engineVersion- The version number of the cache engine to be used for this cache cluster. To view the supported cache engine versions, use the DescribeCacheEngineVersions action.Important: You can upgrade to a newer engine version (see Selecting a Cache Engine and Version), but you cannot downgrade to an earlier engine version. If you want to use an earlier engine version, you must delete the existing cache cluster or replication group and create it anew with the earlier engine version.
-
getEngineVersion
public String getEngineVersion()
The version number of the cache engine to be used for this cache cluster. To view the supported cache engine versions, use the DescribeCacheEngineVersions action.
Important: You can upgrade to a newer engine version (see Selecting a Cache Engine and Version), but you cannot downgrade to an earlier engine version. If you want to use an earlier engine version, you must delete the existing cache cluster or replication group and create it anew with the earlier engine version.
- Returns:
- The version number of the cache engine to be used for this cache
cluster. To view the supported cache engine versions, use the
DescribeCacheEngineVersions action.
Important: You can upgrade to a newer engine version (see Selecting a Cache Engine and Version), but you cannot downgrade to an earlier engine version. If you want to use an earlier engine version, you must delete the existing cache cluster or replication group and create it anew with the earlier engine version.
-
withEngineVersion
public CreateCacheClusterRequest withEngineVersion(String engineVersion)
The version number of the cache engine to be used for this cache cluster. To view the supported cache engine versions, use the DescribeCacheEngineVersions action.
Important: You can upgrade to a newer engine version (see Selecting a Cache Engine and Version), but you cannot downgrade to an earlier engine version. If you want to use an earlier engine version, you must delete the existing cache cluster or replication group and create it anew with the earlier engine version.
- Parameters:
engineVersion- The version number of the cache engine to be used for this cache cluster. To view the supported cache engine versions, use the DescribeCacheEngineVersions action.Important: You can upgrade to a newer engine version (see Selecting a Cache Engine and Version), but you cannot downgrade to an earlier engine version. If you want to use an earlier engine version, you must delete the existing cache cluster or replication group and create it anew with the earlier engine version.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
setCacheParameterGroupName
public void setCacheParameterGroupName(String cacheParameterGroupName)
The name of the parameter group to associate with this cache cluster. If this argument is omitted, the default parameter group for the specified engine is used.
- Parameters:
cacheParameterGroupName- The name of the parameter group to associate with this cache cluster. If this argument is omitted, the default parameter group for the specified engine is used.
-
getCacheParameterGroupName
public String getCacheParameterGroupName()
The name of the parameter group to associate with this cache cluster. If this argument is omitted, the default parameter group for the specified engine is used.
- Returns:
- The name of the parameter group to associate with this cache cluster. If this argument is omitted, the default parameter group for the specified engine is used.
-
withCacheParameterGroupName
public CreateCacheClusterRequest withCacheParameterGroupName(String cacheParameterGroupName)
The name of the parameter group to associate with this cache cluster. If this argument is omitted, the default parameter group for the specified engine is used.
- Parameters:
cacheParameterGroupName- The name of the parameter group to associate with this cache cluster. If this argument is omitted, the default parameter group for the specified engine is used.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
setCacheSubnetGroupName
public void setCacheSubnetGroupName(String cacheSubnetGroupName)
The name of the subnet group to be used for the cache cluster.
Use this parameter only when you are creating a cache cluster in an Amazon Virtual Private Cloud (VPC).
- Parameters:
cacheSubnetGroupName- The name of the subnet group to be used for the cache cluster.Use this parameter only when you are creating a cache cluster in an Amazon Virtual Private Cloud (VPC).
-
getCacheSubnetGroupName
public String getCacheSubnetGroupName()
The name of the subnet group to be used for the cache cluster.
Use this parameter only when you are creating a cache cluster in an Amazon Virtual Private Cloud (VPC).
- Returns:
- The name of the subnet group to be used for the cache
cluster.
Use this parameter only when you are creating a cache cluster in an Amazon Virtual Private Cloud (VPC).
-
withCacheSubnetGroupName
public CreateCacheClusterRequest withCacheSubnetGroupName(String cacheSubnetGroupName)
The name of the subnet group to be used for the cache cluster.
Use this parameter only when you are creating a cache cluster in an Amazon Virtual Private Cloud (VPC).
- Parameters:
cacheSubnetGroupName- The name of the subnet group to be used for the cache cluster.Use this parameter only when you are creating a cache cluster in an Amazon Virtual Private Cloud (VPC).
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
getCacheSecurityGroupNames
public List<String> getCacheSecurityGroupNames()
A list of security group names to associate with this cache cluster.
Use this parameter only when you are creating a cache cluster outside of an Amazon Virtual Private Cloud (VPC).
- Returns:
- A list of security group names to associate with this cache
cluster.
Use this parameter only when you are creating a cache cluster outside of an Amazon Virtual Private Cloud (VPC).
-
setCacheSecurityGroupNames
public void setCacheSecurityGroupNames(Collection<String> cacheSecurityGroupNames)
A list of security group names to associate with this cache cluster.
Use this parameter only when you are creating a cache cluster outside of an Amazon Virtual Private Cloud (VPC).
- Parameters:
cacheSecurityGroupNames- A list of security group names to associate with this cache cluster.Use this parameter only when you are creating a cache cluster outside of an Amazon Virtual Private Cloud (VPC).
-
withCacheSecurityGroupNames
public CreateCacheClusterRequest withCacheSecurityGroupNames(String... cacheSecurityGroupNames)
A list of security group names to associate with this cache cluster.
Use this parameter only when you are creating a cache cluster outside of an Amazon Virtual Private Cloud (VPC).
NOTE: This method appends the values to the existing list (if any). Use
setCacheSecurityGroupNames(java.util.Collection)orwithCacheSecurityGroupNames(java.util.Collection)if you want to override the existing values.- Parameters:
cacheSecurityGroupNames- A list of security group names to associate with this cache cluster.Use this parameter only when you are creating a cache cluster outside of an Amazon Virtual Private Cloud (VPC).
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
withCacheSecurityGroupNames
public CreateCacheClusterRequest withCacheSecurityGroupNames(Collection<String> cacheSecurityGroupNames)
A list of security group names to associate with this cache cluster.
Use this parameter only when you are creating a cache cluster outside of an Amazon Virtual Private Cloud (VPC).
- Parameters:
cacheSecurityGroupNames- A list of security group names to associate with this cache cluster.Use this parameter only when you are creating a cache cluster outside of an Amazon Virtual Private Cloud (VPC).
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
getSecurityGroupIds
public List<String> getSecurityGroupIds()
One or more VPC security groups associated with the cache cluster.
Use this parameter only when you are creating a cache cluster in an Amazon Virtual Private Cloud (VPC).
- Returns:
- One or more VPC security groups associated with the cache
cluster.
Use this parameter only when you are creating a cache cluster in an Amazon Virtual Private Cloud (VPC).
-
setSecurityGroupIds
public void setSecurityGroupIds(Collection<String> securityGroupIds)
One or more VPC security groups associated with the cache cluster.
Use this parameter only when you are creating a cache cluster in an Amazon Virtual Private Cloud (VPC).
- Parameters:
securityGroupIds- One or more VPC security groups associated with the cache cluster.Use this parameter only when you are creating a cache cluster in an Amazon Virtual Private Cloud (VPC).
-
withSecurityGroupIds
public CreateCacheClusterRequest withSecurityGroupIds(String... securityGroupIds)
One or more VPC security groups associated with the cache cluster.
Use this parameter only when you are creating a cache cluster in an Amazon Virtual Private Cloud (VPC).
NOTE: This method appends the values to the existing list (if any). Use
setSecurityGroupIds(java.util.Collection)orwithSecurityGroupIds(java.util.Collection)if you want to override the existing values.- Parameters:
securityGroupIds- One or more VPC security groups associated with the cache cluster.Use this parameter only when you are creating a cache cluster in an Amazon Virtual Private Cloud (VPC).
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
withSecurityGroupIds
public CreateCacheClusterRequest withSecurityGroupIds(Collection<String> securityGroupIds)
One or more VPC security groups associated with the cache cluster.
Use this parameter only when you are creating a cache cluster in an Amazon Virtual Private Cloud (VPC).
- Parameters:
securityGroupIds- One or more VPC security groups associated with the cache cluster.Use this parameter only when you are creating a cache cluster in an Amazon Virtual Private Cloud (VPC).
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
getTags
public List<Tag> getTags()
A list of cost allocation tags to be added to this resource. A tag is a key-value pair. A tag key must be accompanied by a tag value.
- Returns:
- A list of cost allocation tags to be added to this resource. A tag is a key-value pair. A tag key must be accompanied by a tag value.
-
setTags
public void setTags(Collection<Tag> tags)
A list of cost allocation tags to be added to this resource. A tag is a key-value pair. A tag key must be accompanied by a tag value.
- Parameters:
tags- A list of cost allocation tags to be added to this resource. A tag is a key-value pair. A tag key must be accompanied by a tag value.
-
withTags
public CreateCacheClusterRequest withTags(Tag... tags)
A list of cost allocation tags to be added to this resource. A tag is a key-value pair. A tag key must be accompanied by a tag value.
NOTE: This method appends the values to the existing list (if any). Use
setTags(java.util.Collection)orwithTags(java.util.Collection)if you want to override the existing values.- Parameters:
tags- A list of cost allocation tags to be added to this resource. A tag is a key-value pair. A tag key must be accompanied by a tag value.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
withTags
public CreateCacheClusterRequest withTags(Collection<Tag> tags)
A list of cost allocation tags to be added to this resource. A tag is a key-value pair. A tag key must be accompanied by a tag value.
- Parameters:
tags- A list of cost allocation tags to be added to this resource. A tag is a key-value pair. A tag key must be accompanied by a tag value.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
getSnapshotArns
public List<String> getSnapshotArns()
A single-element string list containing an Amazon Resource Name (ARN) that uniquely identifies a Redis RDB snapshot file stored in Amazon S3. The snapshot file will be used to populate the node group. The Amazon S3 object name in the ARN cannot contain any commas.
Note: This parameter is only valid if the
Engineparameter isredis.Example of an Amazon S3 ARN:
arn:aws:s3:::my_bucket/snapshot1.rdb- Returns:
- A single-element string list containing an Amazon Resource Name
(ARN) that uniquely identifies a Redis RDB snapshot file stored
in Amazon S3. The snapshot file will be used to populate the node
group. The Amazon S3 object name in the ARN cannot contain any
commas.
Note: This parameter is only valid if the
Engineparameter isredis.Example of an Amazon S3 ARN:
arn:aws:s3:::my_bucket/snapshot1.rdb
-
setSnapshotArns
public void setSnapshotArns(Collection<String> snapshotArns)
A single-element string list containing an Amazon Resource Name (ARN) that uniquely identifies a Redis RDB snapshot file stored in Amazon S3. The snapshot file will be used to populate the node group. The Amazon S3 object name in the ARN cannot contain any commas.
Note: This parameter is only valid if the
Engineparameter isredis.Example of an Amazon S3 ARN:
arn:aws:s3:::my_bucket/snapshot1.rdb- Parameters:
snapshotArns- A single-element string list containing an Amazon Resource Name (ARN) that uniquely identifies a Redis RDB snapshot file stored in Amazon S3. The snapshot file will be used to populate the node group. The Amazon S3 object name in the ARN cannot contain any commas.Note: This parameter is only valid if the
Engineparameter isredis.Example of an Amazon S3 ARN:
arn:aws:s3:::my_bucket/snapshot1.rdb
-
withSnapshotArns
public CreateCacheClusterRequest withSnapshotArns(String... snapshotArns)
A single-element string list containing an Amazon Resource Name (ARN) that uniquely identifies a Redis RDB snapshot file stored in Amazon S3. The snapshot file will be used to populate the node group. The Amazon S3 object name in the ARN cannot contain any commas.
Note: This parameter is only valid if the
Engineparameter isredis.Example of an Amazon S3 ARN:
arn:aws:s3:::my_bucket/snapshot1.rdbNOTE: This method appends the values to the existing list (if any). Use
setSnapshotArns(java.util.Collection)orwithSnapshotArns(java.util.Collection)if you want to override the existing values.- Parameters:
snapshotArns- A single-element string list containing an Amazon Resource Name (ARN) that uniquely identifies a Redis RDB snapshot file stored in Amazon S3. The snapshot file will be used to populate the node group. The Amazon S3 object name in the ARN cannot contain any commas.Note: This parameter is only valid if the
Engineparameter isredis.Example of an Amazon S3 ARN:
arn:aws:s3:::my_bucket/snapshot1.rdb- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
withSnapshotArns
public CreateCacheClusterRequest withSnapshotArns(Collection<String> snapshotArns)
A single-element string list containing an Amazon Resource Name (ARN) that uniquely identifies a Redis RDB snapshot file stored in Amazon S3. The snapshot file will be used to populate the node group. The Amazon S3 object name in the ARN cannot contain any commas.
Note: This parameter is only valid if the
Engineparameter isredis.Example of an Amazon S3 ARN:
arn:aws:s3:::my_bucket/snapshot1.rdb- Parameters:
snapshotArns- A single-element string list containing an Amazon Resource Name (ARN) that uniquely identifies a Redis RDB snapshot file stored in Amazon S3. The snapshot file will be used to populate the node group. The Amazon S3 object name in the ARN cannot contain any commas.Note: This parameter is only valid if the
Engineparameter isredis.Example of an Amazon S3 ARN:
arn:aws:s3:::my_bucket/snapshot1.rdb- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
setSnapshotName
public void setSnapshotName(String snapshotName)
The name of a snapshot from which to restore data into the new node group. The snapshot status changes to
restoringwhile the new node group is being created.Note: This parameter is only valid if the
Engineparameter isredis.- Parameters:
snapshotName- The name of a snapshot from which to restore data into the new node group. The snapshot status changes torestoringwhile the new node group is being created.Note: This parameter is only valid if the
Engineparameter isredis.
-
getSnapshotName
public String getSnapshotName()
The name of a snapshot from which to restore data into the new node group. The snapshot status changes to
restoringwhile the new node group is being created.Note: This parameter is only valid if the
Engineparameter isredis.- Returns:
- The name of a snapshot from which to restore data into the new
node group. The snapshot status changes to
restoringwhile the new node group is being created.Note: This parameter is only valid if the
Engineparameter isredis.
-
withSnapshotName
public CreateCacheClusterRequest withSnapshotName(String snapshotName)
The name of a snapshot from which to restore data into the new node group. The snapshot status changes to
restoringwhile the new node group is being created.Note: This parameter is only valid if the
Engineparameter isredis.- Parameters:
snapshotName- The name of a snapshot from which to restore data into the new node group. The snapshot status changes torestoringwhile the new node group is being created.Note: This parameter is only valid if the
Engineparameter isredis.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
setPreferredMaintenanceWindow
public void setPreferredMaintenanceWindow(String preferredMaintenanceWindow)
Specifies the weekly time range during which maintenance on the cache 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
dddare:sunmontuewedthufrisat
Example:
sun:05:00-sun:09:00- Parameters:
preferredMaintenanceWindow- Specifies the weekly time range during which maintenance on the cache 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 fordddare:sunmontuewedthufrisat
Example:
sun:05:00-sun:09:00
-
getPreferredMaintenanceWindow
public String getPreferredMaintenanceWindow()
Specifies the weekly time range during which maintenance on the cache 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
dddare:sunmontuewedthufrisat
Example:
sun:05:00-sun:09:00- Returns:
- Specifies the weekly time range during which maintenance on the
cache 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
dddare:sunmontuewedthufrisat
Example:
sun:05:00-sun:09:00
-
withPreferredMaintenanceWindow
public CreateCacheClusterRequest withPreferredMaintenanceWindow(String preferredMaintenanceWindow)
Specifies the weekly time range during which maintenance on the cache 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
dddare:sunmontuewedthufrisat
Example:
sun:05:00-sun:09:00- Parameters:
preferredMaintenanceWindow- Specifies the weekly time range during which maintenance on the cache 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 fordddare:sunmontuewedthufrisat
Example:
sun:05:00-sun:09:00- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
setPort
public void setPort(Integer port)
The port number on which each of the cache nodes will accept connections.
- Parameters:
port- The port number on which each of the cache nodes will accept connections.
-
getPort
public Integer getPort()
The port number on which each of the cache nodes will accept connections.
- Returns:
- The port number on which each of the cache nodes will accept connections.
-
withPort
public CreateCacheClusterRequest withPort(Integer port)
The port number on which each of the cache nodes will accept connections.
- Parameters:
port- The port number on which each of the cache nodes will accept connections.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
setNotificationTopicArn
public void setNotificationTopicArn(String notificationTopicArn)
The Amazon Resource Name (ARN) of the Amazon Simple Notification Service (SNS) topic to which notifications will be sent.
The Amazon SNS topic owner must be the same as the cache cluster owner. - Parameters:
notificationTopicArn- The Amazon Resource Name (ARN) of the Amazon Simple Notification Service (SNS) topic to which notifications will be sent.The Amazon SNS topic owner must be the same as the cache cluster owner.
-
getNotificationTopicArn
public String getNotificationTopicArn()
The Amazon Resource Name (ARN) of the Amazon Simple Notification Service (SNS) topic to which notifications will be sent.
The Amazon SNS topic owner must be the same as the cache cluster owner. - Returns:
- The Amazon Resource Name (ARN) of the Amazon Simple Notification
Service (SNS) topic to which notifications will be sent.
The Amazon SNS topic owner must be the same as the cache cluster owner.
-
withNotificationTopicArn
public CreateCacheClusterRequest withNotificationTopicArn(String notificationTopicArn)
The Amazon Resource Name (ARN) of the Amazon Simple Notification Service (SNS) topic to which notifications will be sent.
The Amazon SNS topic owner must be the same as the cache cluster owner. - Parameters:
notificationTopicArn- The Amazon Resource Name (ARN) of the Amazon Simple Notification Service (SNS) topic to which notifications will be sent.The Amazon SNS topic owner must be the same as the cache cluster owner. - Returns:
- Returns a reference to this object so that method calls can be chained together.
-
setAutoMinorVersionUpgrade
public void setAutoMinorVersionUpgrade(Boolean autoMinorVersionUpgrade)
This parameter is currently disabled.
- Parameters:
autoMinorVersionUpgrade- This parameter is currently disabled.
-
getAutoMinorVersionUpgrade
public Boolean getAutoMinorVersionUpgrade()
This parameter is currently disabled.
- Returns:
- This parameter is currently disabled.
-
withAutoMinorVersionUpgrade
public CreateCacheClusterRequest withAutoMinorVersionUpgrade(Boolean autoMinorVersionUpgrade)
This parameter is currently disabled.
- Parameters:
autoMinorVersionUpgrade- This parameter is currently disabled.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
isAutoMinorVersionUpgrade
public Boolean isAutoMinorVersionUpgrade()
This parameter is currently disabled.
- Returns:
- This parameter is currently disabled.
-
setSnapshotRetentionLimit
public void setSnapshotRetentionLimit(Integer snapshotRetentionLimit)
The number of days for which ElastiCache will retain automatic snapshots before deleting them. For example, if you set
SnapshotRetentionLimitto 5, then a snapshot that was taken today will be retained for 5 days before being deleted.Note: This parameter is only valid if the
Engineparameter isredis.Default: 0 (i.e., automatic backups are disabled for this cache cluster).
- Parameters:
snapshotRetentionLimit- The number of days for which ElastiCache will retain automatic snapshots before deleting them. For example, if you setSnapshotRetentionLimitto 5, then a snapshot that was taken today will be retained for 5 days before being deleted.Note: This parameter is only valid if the
Engineparameter isredis.Default: 0 (i.e., automatic backups are disabled for this cache cluster).
-
getSnapshotRetentionLimit
public Integer getSnapshotRetentionLimit()
The number of days for which ElastiCache will retain automatic snapshots before deleting them. For example, if you set
SnapshotRetentionLimitto 5, then a snapshot that was taken today will be retained for 5 days before being deleted.Note: This parameter is only valid if the
Engineparameter isredis.Default: 0 (i.e., automatic backups are disabled for this cache cluster).
- Returns:
- The number of days for which ElastiCache will retain automatic
snapshots before deleting them. For example, if you set
SnapshotRetentionLimitto 5, then a snapshot that was taken today will be retained for 5 days before being deleted.Note: This parameter is only valid if the
Engineparameter isredis.Default: 0 (i.e., automatic backups are disabled for this cache cluster).
-
withSnapshotRetentionLimit
public CreateCacheClusterRequest withSnapshotRetentionLimit(Integer snapshotRetentionLimit)
The number of days for which ElastiCache will retain automatic snapshots before deleting them. For example, if you set
SnapshotRetentionLimitto 5, then a snapshot that was taken today will be retained for 5 days before being deleted.Note: This parameter is only valid if the
Engineparameter isredis.Default: 0 (i.e., automatic backups are disabled for this cache cluster).
- Parameters:
snapshotRetentionLimit- The number of days for which ElastiCache will retain automatic snapshots before deleting them. For example, if you setSnapshotRetentionLimitto 5, then a snapshot that was taken today will be retained for 5 days before being deleted.Note: This parameter is only valid if the
Engineparameter isredis.Default: 0 (i.e., automatic backups are disabled for this cache cluster).
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
setSnapshotWindow
public void setSnapshotWindow(String snapshotWindow)
The daily time range (in UTC) during which ElastiCache will begin taking a daily snapshot of your node group.
Example:
05:00-09:00If you do not specify this parameter, then ElastiCache will automatically choose an appropriate time range.
Note: This parameter is only valid if the
Engineparameter isredis.- Parameters:
snapshotWindow- The daily time range (in UTC) during which ElastiCache will begin taking a daily snapshot of your node group.Example:
05:00-09:00If you do not specify this parameter, then ElastiCache will automatically choose an appropriate time range.
Note: This parameter is only valid if the
Engineparameter isredis.
-
getSnapshotWindow
public String getSnapshotWindow()
The daily time range (in UTC) during which ElastiCache will begin taking a daily snapshot of your node group.
Example:
05:00-09:00If you do not specify this parameter, then ElastiCache will automatically choose an appropriate time range.
Note: This parameter is only valid if the
Engineparameter isredis.- Returns:
- The daily time range (in UTC) during which ElastiCache will begin
taking a daily snapshot of your node group.
Example:
05:00-09:00If you do not specify this parameter, then ElastiCache will automatically choose an appropriate time range.
Note: This parameter is only valid if the
Engineparameter isredis.
-
withSnapshotWindow
public CreateCacheClusterRequest withSnapshotWindow(String snapshotWindow)
The daily time range (in UTC) during which ElastiCache will begin taking a daily snapshot of your node group.
Example:
05:00-09:00If you do not specify this parameter, then ElastiCache will automatically choose an appropriate time range.
Note: This parameter is only valid if the
Engineparameter isredis.- Parameters:
snapshotWindow- The daily time range (in UTC) during which ElastiCache will begin taking a daily snapshot of your node group.Example:
05:00-09:00If you do not specify this parameter, then ElastiCache will automatically choose an appropriate time range.
Note: This parameter is only valid if the
Engineparameter isredis.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
toString
public String toString()
Returns a string representation of this object; useful for testing and debugging.- Overrides:
toStringin classObject- Returns:
- A string representation of this object.
- See Also:
Object.toString()
-
clone
public CreateCacheClusterRequest clone()
Description copied from class:AmazonWebServiceRequestCreates a shallow clone of this request. Explicitly does not clone the deep structure of the request object.- Overrides:
clonein classAmazonWebServiceRequest- See Also:
Object.clone()
-
-