/*
* Copyright 2012-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
* the License. A copy of the License is located at
*
* http://aws.amazon.com/apache2.0
*
* or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
* CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions
* and limitations under the License.
*/
package com.amazonaws.services.elasticache.model;
import java.io.Serializable;
import javax.annotation.Generated;
import com.amazonaws.AmazonWebServiceRequest;
/**
* <p>
* Represents the input of a <code>ModifyCacheCluster</code> operation.
* </p>
*
* @see <a href="http://docs.aws.amazon.com/goto/WebAPI/elasticache-2015-02-02/ModifyCacheCluster" target="_top">AWS API
* Documentation</a>
*/
@Generated("com.amazonaws:aws-java-sdk-code-generator")
public class ModifyCacheClusterRequest extends com.amazonaws.AmazonWebServiceRequest implements Serializable, Cloneable {
/**
* <p>
* The cache cluster identifier. This value is stored as a lowercase string.
* </p>
*/
private String cacheClusterId;
/**
* <p>
* The number of cache nodes that the cache cluster should have. If the value for <code>NumCacheNodes</code> is
* greater than the sum of the number of current cache nodes and the number of cache nodes pending creation (which
* may be zero), more nodes are added. If the value is less than the number of existing cache nodes, nodes are
* removed. If the value is equal to the number of current cache nodes, any pending add or remove requests are
* canceled.
* </p>
* <p>
* If you are removing cache nodes, you must use the <code>CacheNodeIdsToRemove</code> parameter to provide the IDs
* of the specific cache nodes to remove.
* </p>
* <p>
* For clusters running Redis, this value must be 1. For clusters running Memcached, this value must be between 1
* and 20.
* </p>
* <note>
* <p>
* Adding or removing Memcached cache nodes can be applied immediately or as a pending operation (see
* <code>ApplyImmediately</code>).
* </p>
* <p>
* A pending operation to modify the number of cache nodes in a cluster during its maintenance window, whether by
* adding or removing nodes in accordance with the scale out architecture, is not queued. The customer's latest
* request to add or remove nodes to the cluster overrides any previous pending operations to modify the number of
* cache nodes in the cluster. For example, a request to remove 2 nodes would override a previous pending operation
* to remove 3 nodes. Similarly, a request to add 2 nodes would override a previous pending operation to remove 3
* nodes and vice versa. As Memcached cache nodes may now be provisioned in different Availability Zones with
* flexible cache node placement, a request to add nodes does not automatically override a previous pending
* operation to add nodes. The customer can modify the previous pending operation to add more nodes or explicitly
* cancel the pending request and retry the new request. To cancel pending operations to modify the number of cache
* nodes in a cluster, use the <code>ModifyCacheCluster</code> request and set <code>NumCacheNodes</code> equal to
* the number of cache nodes currently in the cache cluster.
* </p>
* </note>
*/
private Integer numCacheNodes;
/**
* <p>
* A list of cache node IDs to be removed. A node ID is a numeric identifier (0001, 0002, etc.). This parameter is
* only valid when <code>NumCacheNodes</code> is less than the existing number of cache nodes. The number of cache
* node IDs supplied in this parameter must match the difference between the existing number of cache nodes in the
* cluster or pending cache nodes, whichever is greater, and the value of <code>NumCacheNodes</code> in the request.
* </p>
* <p>
* For example: If you have 3 active cache nodes, 7 pending cache nodes, and the number of cache nodes in this
* <code>ModifyCacheCluser</code> call is 5, you must list 2 (7 - 5) cache node IDs to remove.
* </p>
*/
private com.amazonaws.internal.SdkInternalList<String> cacheNodeIdsToRemove;
/**
* <p>
* Specifies whether the new nodes in this Memcached cache cluster are all created in a single Availability Zone or
* created across multiple Availability Zones.
* </p>
* <p>
* Valid values: <code>single-az</code> | <code>cross-az</code>.
* </p>
* <p>
* This option is only supported for Memcached cache clusters.
* </p>
* <note>
* <p>
* You cannot specify <code>single-az</code> if the Memcached cache cluster already has cache nodes in different
* Availability Zones. If <code>cross-az</code> is specified, existing Memcached nodes remain in their current
* Availability Zone.
* </p>
* <p>
* Only newly created nodes are located in different Availability Zones. For instructions on how to move existing
* Memcached nodes to different Availability Zones, see the <b>Availability Zone Considerations</b> section of <a
* href="http://docs.aws.amazon.com/AmazonElastiCache/latest/UserGuide/CacheNode.Memcached.html">Cache Node
* Considerations for Memcached</a>.
* </p>
* </note>
*/
private String aZMode;
/**
* <p>
* The list of Availability Zones where the new Memcached cache nodes are created.
* </p>
* <p>
* This parameter is only valid when <code>NumCacheNodes</code> in the request is greater than the sum of the number
* of active cache nodes and the number of cache nodes pending creation (which may be zero). The number of
* Availability Zones supplied in this list must match the cache nodes being added in this request.
* </p>
* <p>
* This option is only supported on Memcached clusters.
* </p>
* <p>
* Scenarios:
* </p>
* <ul>
* <li>
* <p>
* <b>Scenario 1:</b> You have 3 active nodes and wish to add 2 nodes. Specify <code>NumCacheNodes=5</code> (3 + 2)
* and optionally specify two Availability Zones for the two new nodes.
* </p>
* </li>
* <li>
* <p>
* <b>Scenario 2:</b> You have 3 active nodes and 2 nodes pending creation (from the scenario 1 call) and want to
* add 1 more node. Specify <code>NumCacheNodes=6</code> ((3 + 2) + 1) and optionally specify an Availability Zone
* for the new node.
* </p>
* </li>
* <li>
* <p>
* <b>Scenario 3:</b> You want to cancel all pending operations. Specify <code>NumCacheNodes=3</code> to cancel all
* pending operations.
* </p>
* </li>
* </ul>
* <p>
* The Availability Zone placement of nodes pending creation cannot be modified. If you wish to cancel any nodes
* pending creation, add 0 nodes by setting <code>NumCacheNodes</code> to the number of current nodes.
* </p>
* <p>
* If <code>cross-az</code> is specified, existing Memcached nodes remain in their current Availability Zone. Only
* newly created nodes can be located in different Availability Zones. For guidance on how to move existing
* Memcached nodes to different Availability Zones, see the <b>Availability Zone Considerations</b> section of <a
* href="http://docs.aws.amazon.com/AmazonElastiCache/latest/UserGuide/CacheNode.Memcached.html">Cache Node
* Considerations for Memcached</a>.
* </p>
* <p>
* <b>Impact of new add/remove requests upon pending requests</b>
* </p>
* <ul>
* <li>
* <p>
* Scenario-1
* </p>
* <ul>
* <li>
* <p>
* Pending Action: Delete
* </p>
* </li>
* <li>
* <p>
* New Request: Delete
* </p>
* </li>
* <li>
* <p>
* Result: The new delete, pending or immediate, replaces the pending delete.
* </p>
* </li>
* </ul>
* </li>
* <li>
* <p>
* Scenario-2
* </p>
* <ul>
* <li>
* <p>
* Pending Action: Delete
* </p>
* </li>
* <li>
* <p>
* New Request: Create
* </p>
* </li>
* <li>
* <p>
* Result: The new create, pending or immediate, replaces the pending delete.
* </p>
* </li>
* </ul>
* </li>
* <li>
* <p>
* Scenario-3
* </p>
* <ul>
* <li>
* <p>
* Pending Action: Create
* </p>
* </li>
* <li>
* <p>
* New Request: Delete
* </p>
* </li>
* <li>
* <p>
* Result: The new delete, pending or immediate, replaces the pending create.
* </p>
* </li>
* </ul>
* </li>
* <li>
* <p>
* Scenario-4
* </p>
* <ul>
* <li>
* <p>
* Pending Action: Create
* </p>
* </li>
* <li>
* <p>
* New Request: Create
* </p>
* </li>
* <li>
* <p>
* Result: The new create is added to the pending create.
* </p>
* <important>
* <p>
* <b>Important:</b> If the new create request is <b>Apply Immediately - Yes</b>, all creates are performed
* immediately. If the new create request is <b>Apply Immediately - No</b>, all creates are pending.
* </p>
* </important></li>
* </ul>
* </li>
* </ul>
*/
private com.amazonaws.internal.SdkInternalList<String> newAvailabilityZones;
/**
* <p>
* A list of cache security group names to authorize on this cache cluster. This change is asynchronously applied as
* soon as possible.
* </p>
* <p>
* You can use this parameter only with clusters that are created outside of an Amazon Virtual Private Cloud (Amazon
* VPC).
* </p>
* <p>
* Constraints: Must contain no more than 255 alphanumeric characters. Must not be "Default".
* </p>
*/
private com.amazonaws.internal.SdkInternalList<String> cacheSecurityGroupNames;
/**
* <p>
* Specifies the VPC Security Groups associated with the cache cluster.
* </p>
* <p>
* This parameter can be used only with clusters that are created in an Amazon Virtual Private Cloud (Amazon VPC).
* </p>
*/
private com.amazonaws.internal.SdkInternalList<String> securityGroupIds;
/**
* <p>
* 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.
* </p>
* <p>
* Valid values for <code>ddd</code> are:
* </p>
* <ul>
* <li>
* <p>
* <code>sun</code>
* </p>
* </li>
* <li>
* <p>
* <code>mon</code>
* </p>
* </li>
* <li>
* <p>
* <code>tue</code>
* </p>
* </li>
* <li>
* <p>
* <code>wed</code>
* </p>
* </li>
* <li>
* <p>
* <code>thu</code>
* </p>
* </li>
* <li>
* <p>
* <code>fri</code>
* </p>
* </li>
* <li>
* <p>
* <code>sat</code>
* </p>
* </li>
* </ul>
* <p>
* Example: <code>sun:23:00-mon:01:30</code>
* </p>
*/
private String preferredMaintenanceWindow;
/**
* <p>
* The Amazon Resource Name (ARN) of the Amazon SNS topic to which notifications are sent.
* </p>
* <note>
* <p>
* The Amazon SNS topic owner must be same as the cache cluster owner.
* </p>
* </note>
*/
private String notificationTopicArn;
/**
* <p>
* The name of the cache parameter group to apply to this cache cluster. This change is asynchronously applied as
* soon as possible for parameters when the <code>ApplyImmediately</code> parameter is specified as
* <code>true</code> for this request.
* </p>
*/
private String cacheParameterGroupName;
/**
* <p>
* The status of the Amazon SNS notification topic. Notifications are sent only if the status is <code>active</code>
* .
* </p>
* <p>
* Valid values: <code>active</code> | <code>inactive</code>
* </p>
*/
private String notificationTopicStatus;
/**
* <p>
* If <code>true</code>, this parameter causes the modifications in this request and any pending modifications to be
* applied, asynchronously and as soon as possible, regardless of the <code>PreferredMaintenanceWindow</code>
* setting for the cache cluster.
* </p>
* <p>
* If <code>false</code>, changes to the cache cluster are applied on the next maintenance reboot, or the next
* failure reboot, whichever occurs first.
* </p>
* <important>
* <p>
* If you perform a <code>ModifyCacheCluster</code> before a pending modification is applied, the pending
* modification is replaced by the newer modification.
* </p>
* </important>
* <p>
* Valid values: <code>true</code> | <code>false</code>
* </p>
* <p>
* Default: <code>false</code>
* </p>
*/
private Boolean applyImmediately;
/**
* <p>
* The upgraded version of the cache engine to be run on the cache nodes.
* </p>
* <p>
* <b>Important:</b> You can upgrade to a newer engine version (see <a
* href="http://docs.aws.amazon.com/AmazonElastiCache/latest/UserGuide/SelectEngine.html#VersionManagement"
* >Selecting a Cache Engine and Version</a>), 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 and create it anew with the earlier
* engine version.
* </p>
*/
private String engineVersion;
/**
* <p>
* This parameter is currently disabled.
* </p>
*/
private Boolean autoMinorVersionUpgrade;
/**
* <p>
* The number of days for which ElastiCache retains automatic cache cluster snapshots before deleting them. For
* example, if you set <code>SnapshotRetentionLimit</code> to 5, a snapshot that was taken today is retained for 5
* days before being deleted.
* </p>
* <note>
* <p>
* If the value of <code>SnapshotRetentionLimit</code> is set to zero (0), backups are turned off.
* </p>
* </note>
*/
private Integer snapshotRetentionLimit;
/**
* <p>
* The daily time range (in UTC) during which ElastiCache begins taking a daily snapshot of your cache cluster.
* </p>
*/
private String snapshotWindow;
/**
* <p>
* A valid cache node type that you want to scale this cache cluster up to.
* </p>
*/
private String cacheNodeType;
/**
* Default constructor for ModifyCacheClusterRequest object. Callers should use the setter or fluent setter
* (with...) methods to initialize the object after creating it.
*/
public ModifyCacheClusterRequest() {
}
/**
* Constructs a new ModifyCacheClusterRequest object. Callers should use the setter or fluent setter (with...)
* methods to initialize any additional object members.
*
* @param cacheClusterId
* The cache cluster identifier. This value is stored as a lowercase string.
*/
public ModifyCacheClusterRequest(String cacheClusterId) {
setCacheClusterId(cacheClusterId);
}
/**
* <p>
* The cache cluster identifier. This value is stored as a lowercase string.
* </p>
*
* @param cacheClusterId
* The cache cluster identifier. This value is stored as a lowercase string.
*/
public void setCacheClusterId(String cacheClusterId) {
this.cacheClusterId = cacheClusterId;
}
/**
* <p>
* The cache cluster identifier. This value is stored as a lowercase string.
* </p>
*
* @return The cache cluster identifier. This value is stored as a lowercase string.
*/
public String getCacheClusterId() {
return this.cacheClusterId;
}
/**
* <p>
* The cache cluster identifier. This value is stored as a lowercase string.
* </p>
*
* @param cacheClusterId
* The cache cluster identifier. This value is stored as a lowercase string.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public ModifyCacheClusterRequest withCacheClusterId(String cacheClusterId) {
setCacheClusterId(cacheClusterId);
return this;
}
/**
* <p>
* The number of cache nodes that the cache cluster should have. If the value for <code>NumCacheNodes</code> is
* greater than the sum of the number of current cache nodes and the number of cache nodes pending creation (which
* may be zero), more nodes are added. If the value is less than the number of existing cache nodes, nodes are
* removed. If the value is equal to the number of current cache nodes, any pending add or remove requests are
* canceled.
* </p>
* <p>
* If you are removing cache nodes, you must use the <code>CacheNodeIdsToRemove</code> parameter to provide the IDs
* of the specific cache nodes to remove.
* </p>
* <p>
* For clusters running Redis, this value must be 1. For clusters running Memcached, this value must be between 1
* and 20.
* </p>
* <note>
* <p>
* Adding or removing Memcached cache nodes can be applied immediately or as a pending operation (see
* <code>ApplyImmediately</code>).
* </p>
* <p>
* A pending operation to modify the number of cache nodes in a cluster during its maintenance window, whether by
* adding or removing nodes in accordance with the scale out architecture, is not queued. The customer's latest
* request to add or remove nodes to the cluster overrides any previous pending operations to modify the number of
* cache nodes in the cluster. For example, a request to remove 2 nodes would override a previous pending operation
* to remove 3 nodes. Similarly, a request to add 2 nodes would override a previous pending operation to remove 3
* nodes and vice versa. As Memcached cache nodes may now be provisioned in different Availability Zones with
* flexible cache node placement, a request to add nodes does not automatically override a previous pending
* operation to add nodes. The customer can modify the previous pending operation to add more nodes or explicitly
* cancel the pending request and retry the new request. To cancel pending operations to modify the number of cache
* nodes in a cluster, use the <code>ModifyCacheCluster</code> request and set <code>NumCacheNodes</code> equal to
* the number of cache nodes currently in the cache cluster.
* </p>
* </note>
*
* @param numCacheNodes
* The number of cache nodes that the cache cluster should have. If the value for <code>NumCacheNodes</code>
* is greater than the sum of the number of current cache nodes and the number of cache nodes pending
* creation (which may be zero), more nodes are added. If the value is less than the number of existing cache
* nodes, nodes are removed. If the value is equal to the number of current cache nodes, any pending add or
* remove requests are canceled.</p>
* <p>
* If you are removing cache nodes, you must use the <code>CacheNodeIdsToRemove</code> parameter to provide
* the IDs of the specific cache nodes to remove.
* </p>
* <p>
* For clusters running Redis, this value must be 1. For clusters running Memcached, this value must be
* between 1 and 20.
* </p>
* <note>
* <p>
* Adding or removing Memcached cache nodes can be applied immediately or as a pending operation (see
* <code>ApplyImmediately</code>).
* </p>
* <p>
* A pending operation to modify the number of cache nodes in a cluster during its maintenance window,
* whether by adding or removing nodes in accordance with the scale out architecture, is not queued. The
* customer's latest request to add or remove nodes to the cluster overrides any previous pending operations
* to modify the number of cache nodes in the cluster. For example, a request to remove 2 nodes would
* override a previous pending operation to remove 3 nodes. Similarly, a request to add 2 nodes would
* override a previous pending operation to remove 3 nodes and vice versa. As Memcached cache nodes may now
* be provisioned in different Availability Zones with flexible cache node placement, a request to add nodes
* does not automatically override a previous pending operation to add nodes. The customer can modify the
* previous pending operation to add more nodes or explicitly cancel the pending request and retry the new
* request. To cancel pending operations to modify the number of cache nodes in a cluster, use the
* <code>ModifyCacheCluster</code> request and set <code>NumCacheNodes</code> equal to the number of cache
* nodes currently in the cache cluster.
* </p>
*/
public void setNumCacheNodes(Integer numCacheNodes) {
this.numCacheNodes = numCacheNodes;
}
/**
* <p>
* The number of cache nodes that the cache cluster should have. If the value for <code>NumCacheNodes</code> is
* greater than the sum of the number of current cache nodes and the number of cache nodes pending creation (which
* may be zero), more nodes are added. If the value is less than the number of existing cache nodes, nodes are
* removed. If the value is equal to the number of current cache nodes, any pending add or remove requests are
* canceled.
* </p>
* <p>
* If you are removing cache nodes, you must use the <code>CacheNodeIdsToRemove</code> parameter to provide the IDs
* of the specific cache nodes to remove.
* </p>
* <p>
* For clusters running Redis, this value must be 1. For clusters running Memcached, this value must be between 1
* and 20.
* </p>
* <note>
* <p>
* Adding or removing Memcached cache nodes can be applied immediately or as a pending operation (see
* <code>ApplyImmediately</code>).
* </p>
* <p>
* A pending operation to modify the number of cache nodes in a cluster during its maintenance window, whether by
* adding or removing nodes in accordance with the scale out architecture, is not queued. The customer's latest
* request to add or remove nodes to the cluster overrides any previous pending operations to modify the number of
* cache nodes in the cluster. For example, a request to remove 2 nodes would override a previous pending operation
* to remove 3 nodes. Similarly, a request to add 2 nodes would override a previous pending operation to remove 3
* nodes and vice versa. As Memcached cache nodes may now be provisioned in different Availability Zones with
* flexible cache node placement, a request to add nodes does not automatically override a previous pending
* operation to add nodes. The customer can modify the previous pending operation to add more nodes or explicitly
* cancel the pending request and retry the new request. To cancel pending operations to modify the number of cache
* nodes in a cluster, use the <code>ModifyCacheCluster</code> request and set <code>NumCacheNodes</code> equal to
* the number of cache nodes currently in the cache cluster.
* </p>
* </note>
*
* @return The number of cache nodes that the cache cluster should have. If the value for <code>NumCacheNodes</code>
* is greater than the sum of the number of current cache nodes and the number of cache nodes pending
* creation (which may be zero), more nodes are added. If the value is less than the number of existing
* cache nodes, nodes are removed. If the value is equal to the number of current cache nodes, any pending
* add or remove requests are canceled.</p>
* <p>
* If you are removing cache nodes, you must use the <code>CacheNodeIdsToRemove</code> parameter to provide
* the IDs of the specific cache nodes to remove.
* </p>
* <p>
* For clusters running Redis, this value must be 1. For clusters running Memcached, this value must be
* between 1 and 20.
* </p>
* <note>
* <p>
* Adding or removing Memcached cache nodes can be applied immediately or as a pending operation (see
* <code>ApplyImmediately</code>).
* </p>
* <p>
* A pending operation to modify the number of cache nodes in a cluster during its maintenance window,
* whether by adding or removing nodes in accordance with the scale out architecture, is not queued. The
* customer's latest request to add or remove nodes to the cluster overrides any previous pending operations
* to modify the number of cache nodes in the cluster. For example, a request to remove 2 nodes would
* override a previous pending operation to remove 3 nodes. Similarly, a request to add 2 nodes would
* override a previous pending operation to remove 3 nodes and vice versa. As Memcached cache nodes may now
* be provisioned in different Availability Zones with flexible cache node placement, a request to add nodes
* does not automatically override a previous pending operation to add nodes. The customer can modify the
* previous pending operation to add more nodes or explicitly cancel the pending request and retry the new
* request. To cancel pending operations to modify the number of cache nodes in a cluster, use the
* <code>ModifyCacheCluster</code> request and set <code>NumCacheNodes</code> equal to the number of cache
* nodes currently in the cache cluster.
* </p>
*/
public Integer getNumCacheNodes() {
return this.numCacheNodes;
}
/**
* <p>
* The number of cache nodes that the cache cluster should have. If the value for <code>NumCacheNodes</code> is
* greater than the sum of the number of current cache nodes and the number of cache nodes pending creation (which
* may be zero), more nodes are added. If the value is less than the number of existing cache nodes, nodes are
* removed. If the value is equal to the number of current cache nodes, any pending add or remove requests are
* canceled.
* </p>
* <p>
* If you are removing cache nodes, you must use the <code>CacheNodeIdsToRemove</code> parameter to provide the IDs
* of the specific cache nodes to remove.
* </p>
* <p>
* For clusters running Redis, this value must be 1. For clusters running Memcached, this value must be between 1
* and 20.
* </p>
* <note>
* <p>
* Adding or removing Memcached cache nodes can be applied immediately or as a pending operation (see
* <code>ApplyImmediately</code>).
* </p>
* <p>
* A pending operation to modify the number of cache nodes in a cluster during its maintenance window, whether by
* adding or removing nodes in accordance with the scale out architecture, is not queued. The customer's latest
* request to add or remove nodes to the cluster overrides any previous pending operations to modify the number of
* cache nodes in the cluster. For example, a request to remove 2 nodes would override a previous pending operation
* to remove 3 nodes. Similarly, a request to add 2 nodes would override a previous pending operation to remove 3
* nodes and vice versa. As Memcached cache nodes may now be provisioned in different Availability Zones with
* flexible cache node placement, a request to add nodes does not automatically override a previous pending
* operation to add nodes. The customer can modify the previous pending operation to add more nodes or explicitly
* cancel the pending request and retry the new request. To cancel pending operations to modify the number of cache
* nodes in a cluster, use the <code>ModifyCacheCluster</code> request and set <code>NumCacheNodes</code> equal to
* the number of cache nodes currently in the cache cluster.
* </p>
* </note>
*
* @param numCacheNodes
* The number of cache nodes that the cache cluster should have. If the value for <code>NumCacheNodes</code>
* is greater than the sum of the number of current cache nodes and the number of cache nodes pending
* creation (which may be zero), more nodes are added. If the value is less than the number of existing cache
* nodes, nodes are removed. If the value is equal to the number of current cache nodes, any pending add or
* remove requests are canceled.</p>
* <p>
* If you are removing cache nodes, you must use the <code>CacheNodeIdsToRemove</code> parameter to provide
* the IDs of the specific cache nodes to remove.
* </p>
* <p>
* For clusters running Redis, this value must be 1. For clusters running Memcached, this value must be
* between 1 and 20.
* </p>
* <note>
* <p>
* Adding or removing Memcached cache nodes can be applied immediately or as a pending operation (see
* <code>ApplyImmediately</code>).
* </p>
* <p>
* A pending operation to modify the number of cache nodes in a cluster during its maintenance window,
* whether by adding or removing nodes in accordance with the scale out architecture, is not queued. The
* customer's latest request to add or remove nodes to the cluster overrides any previous pending operations
* to modify the number of cache nodes in the cluster. For example, a request to remove 2 nodes would
* override a previous pending operation to remove 3 nodes. Similarly, a request to add 2 nodes would
* override a previous pending operation to remove 3 nodes and vice versa. As Memcached cache nodes may now
* be provisioned in different Availability Zones with flexible cache node placement, a request to add nodes
* does not automatically override a previous pending operation to add nodes. The customer can modify the
* previous pending operation to add more nodes or explicitly cancel the pending request and retry the new
* request. To cancel pending operations to modify the number of cache nodes in a cluster, use the
* <code>ModifyCacheCluster</code> request and set <code>NumCacheNodes</code> equal to the number of cache
* nodes currently in the cache cluster.
* </p>
* @return Returns a reference to this object so that method calls can be chained together.
*/
public ModifyCacheClusterRequest withNumCacheNodes(Integer numCacheNodes) {
setNumCacheNodes(numCacheNodes);
return this;
}
/**
* <p>
* A list of cache node IDs to be removed. A node ID is a numeric identifier (0001, 0002, etc.). This parameter is
* only valid when <code>NumCacheNodes</code> is less than the existing number of cache nodes. The number of cache
* node IDs supplied in this parameter must match the difference between the existing number of cache nodes in the
* cluster or pending cache nodes, whichever is greater, and the value of <code>NumCacheNodes</code> in the request.
* </p>
* <p>
* For example: If you have 3 active cache nodes, 7 pending cache nodes, and the number of cache nodes in this
* <code>ModifyCacheCluser</code> call is 5, you must list 2 (7 - 5) cache node IDs to remove.
* </p>
*
* @return A list of cache node IDs to be removed. A node ID is a numeric identifier (0001, 0002, etc.). This
* parameter is only valid when <code>NumCacheNodes</code> is less than the existing number of cache nodes.
* The number of cache node IDs supplied in this parameter must match the difference between the existing
* number of cache nodes in the cluster or pending cache nodes, whichever is greater, and the value of
* <code>NumCacheNodes</code> in the request.</p>
* <p>
* For example: If you have 3 active cache nodes, 7 pending cache nodes, and the number of cache nodes in
* this <code>ModifyCacheCluser</code> call is 5, you must list 2 (7 - 5) cache node IDs to remove.
*/
public java.util.List<String> getCacheNodeIdsToRemove() {
if (cacheNodeIdsToRemove == null) {
cacheNodeIdsToRemove = new com.amazonaws.internal.SdkInternalList<String>();
}
return cacheNodeIdsToRemove;
}
/**
* <p>
* A list of cache node IDs to be removed. A node ID is a numeric identifier (0001, 0002, etc.). This parameter is
* only valid when <code>NumCacheNodes</code> is less than the existing number of cache nodes. The number of cache
* node IDs supplied in this parameter must match the difference between the existing number of cache nodes in the
* cluster or pending cache nodes, whichever is greater, and the value of <code>NumCacheNodes</code> in the request.
* </p>
* <p>
* For example: If you have 3 active cache nodes, 7 pending cache nodes, and the number of cache nodes in this
* <code>ModifyCacheCluser</code> call is 5, you must list 2 (7 - 5) cache node IDs to remove.
* </p>
*
* @param cacheNodeIdsToRemove
* A list of cache node IDs to be removed. A node ID is a numeric identifier (0001, 0002, etc.). This
* parameter is only valid when <code>NumCacheNodes</code> is less than the existing number of cache nodes.
* The number of cache node IDs supplied in this parameter must match the difference between the existing
* number of cache nodes in the cluster or pending cache nodes, whichever is greater, and the value of
* <code>NumCacheNodes</code> in the request.</p>
* <p>
* For example: If you have 3 active cache nodes, 7 pending cache nodes, and the number of cache nodes in
* this <code>ModifyCacheCluser</code> call is 5, you must list 2 (7 - 5) cache node IDs to remove.
*/
public void setCacheNodeIdsToRemove(java.util.Collection<String> cacheNodeIdsToRemove) {
if (cacheNodeIdsToRemove == null) {
this.cacheNodeIdsToRemove = null;
return;
}
this.cacheNodeIdsToRemove = new com.amazonaws.internal.SdkInternalList<String>(cacheNodeIdsToRemove);
}
/**
* <p>
* A list of cache node IDs to be removed. A node ID is a numeric identifier (0001, 0002, etc.). This parameter is
* only valid when <code>NumCacheNodes</code> is less than the existing number of cache nodes. The number of cache
* node IDs supplied in this parameter must match the difference between the existing number of cache nodes in the
* cluster or pending cache nodes, whichever is greater, and the value of <code>NumCacheNodes</code> in the request.
* </p>
* <p>
* For example: If you have 3 active cache nodes, 7 pending cache nodes, and the number of cache nodes in this
* <code>ModifyCacheCluser</code> call is 5, you must list 2 (7 - 5) cache node IDs to remove.
* </p>
* <p>
* <b>NOTE:</b> This method appends the values to the existing list (if any). Use
* {@link #setCacheNodeIdsToRemove(java.util.Collection)} or {@link #withCacheNodeIdsToRemove(java.util.Collection)}
* if you want to override the existing values.
* </p>
*
* @param cacheNodeIdsToRemove
* A list of cache node IDs to be removed. A node ID is a numeric identifier (0001, 0002, etc.). This
* parameter is only valid when <code>NumCacheNodes</code> is less than the existing number of cache nodes.
* The number of cache node IDs supplied in this parameter must match the difference between the existing
* number of cache nodes in the cluster or pending cache nodes, whichever is greater, and the value of
* <code>NumCacheNodes</code> in the request.</p>
* <p>
* For example: If you have 3 active cache nodes, 7 pending cache nodes, and the number of cache nodes in
* this <code>ModifyCacheCluser</code> call is 5, you must list 2 (7 - 5) cache node IDs to remove.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public ModifyCacheClusterRequest withCacheNodeIdsToRemove(String... cacheNodeIdsToRemove) {
if (this.cacheNodeIdsToRemove == null) {
setCacheNodeIdsToRemove(new com.amazonaws.internal.SdkInternalList<String>(cacheNodeIdsToRemove.length));
}
for (String ele : cacheNodeIdsToRemove) {
this.cacheNodeIdsToRemove.add(ele);
}
return this;
}
/**
* <p>
* A list of cache node IDs to be removed. A node ID is a numeric identifier (0001, 0002, etc.). This parameter is
* only valid when <code>NumCacheNodes</code> is less than the existing number of cache nodes. The number of cache
* node IDs supplied in this parameter must match the difference between the existing number of cache nodes in the
* cluster or pending cache nodes, whichever is greater, and the value of <code>NumCacheNodes</code> in the request.
* </p>
* <p>
* For example: If you have 3 active cache nodes, 7 pending cache nodes, and the number of cache nodes in this
* <code>ModifyCacheCluser</code> call is 5, you must list 2 (7 - 5) cache node IDs to remove.
* </p>
*
* @param cacheNodeIdsToRemove
* A list of cache node IDs to be removed. A node ID is a numeric identifier (0001, 0002, etc.). This
* parameter is only valid when <code>NumCacheNodes</code> is less than the existing number of cache nodes.
* The number of cache node IDs supplied in this parameter must match the difference between the existing
* number of cache nodes in the cluster or pending cache nodes, whichever is greater, and the value of
* <code>NumCacheNodes</code> in the request.</p>
* <p>
* For example: If you have 3 active cache nodes, 7 pending cache nodes, and the number of cache nodes in
* this <code>ModifyCacheCluser</code> call is 5, you must list 2 (7 - 5) cache node IDs to remove.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public ModifyCacheClusterRequest withCacheNodeIdsToRemove(java.util.Collection<String> cacheNodeIdsToRemove) {
setCacheNodeIdsToRemove(cacheNodeIdsToRemove);
return this;
}
/**
* <p>
* Specifies whether the new nodes in this Memcached cache cluster are all created in a single Availability Zone or
* created across multiple Availability Zones.
* </p>
* <p>
* Valid values: <code>single-az</code> | <code>cross-az</code>.
* </p>
* <p>
* This option is only supported for Memcached cache clusters.
* </p>
* <note>
* <p>
* You cannot specify <code>single-az</code> if the Memcached cache cluster already has cache nodes in different
* Availability Zones. If <code>cross-az</code> is specified, existing Memcached nodes remain in their current
* Availability Zone.
* </p>
* <p>
* Only newly created nodes are located in different Availability Zones. For instructions on how to move existing
* Memcached nodes to different Availability Zones, see the <b>Availability Zone Considerations</b> section of <a
* href="http://docs.aws.amazon.com/AmazonElastiCache/latest/UserGuide/CacheNode.Memcached.html">Cache Node
* Considerations for Memcached</a>.
* </p>
* </note>
*
* @param aZMode
* Specifies whether the new nodes in this Memcached cache cluster are all created in a single Availability
* Zone or created across multiple Availability Zones.</p>
* <p>
* Valid values: <code>single-az</code> | <code>cross-az</code>.
* </p>
* <p>
* This option is only supported for Memcached cache clusters.
* </p>
* <note>
* <p>
* You cannot specify <code>single-az</code> if the Memcached cache cluster already has cache nodes in
* different Availability Zones. If <code>cross-az</code> is specified, existing Memcached nodes remain in
* their current Availability Zone.
* </p>
* <p>
* Only newly created nodes are located in different Availability Zones. For instructions on how to move
* existing Memcached nodes to different Availability Zones, see the <b>Availability Zone Considerations</b>
* section of <a
* href="http://docs.aws.amazon.com/AmazonElastiCache/latest/UserGuide/CacheNode.Memcached.html">Cache Node
* Considerations for Memcached</a>.
* </p>
* @see AZMode
*/
public void setAZMode(String aZMode) {
this.aZMode = aZMode;
}
/**
* <p>
* Specifies whether the new nodes in this Memcached cache cluster are all created in a single Availability Zone or
* created across multiple Availability Zones.
* </p>
* <p>
* Valid values: <code>single-az</code> | <code>cross-az</code>.
* </p>
* <p>
* This option is only supported for Memcached cache clusters.
* </p>
* <note>
* <p>
* You cannot specify <code>single-az</code> if the Memcached cache cluster already has cache nodes in different
* Availability Zones. If <code>cross-az</code> is specified, existing Memcached nodes remain in their current
* Availability Zone.
* </p>
* <p>
* Only newly created nodes are located in different Availability Zones. For instructions on how to move existing
* Memcached nodes to different Availability Zones, see the <b>Availability Zone Considerations</b> section of <a
* href="http://docs.aws.amazon.com/AmazonElastiCache/latest/UserGuide/CacheNode.Memcached.html">Cache Node
* Considerations for Memcached</a>.
* </p>
* </note>
*
* @return Specifies whether the new nodes in this Memcached cache cluster are all created in a single Availability
* Zone or created across multiple Availability Zones.</p>
* <p>
* Valid values: <code>single-az</code> | <code>cross-az</code>.
* </p>
* <p>
* This option is only supported for Memcached cache clusters.
* </p>
* <note>
* <p>
* You cannot specify <code>single-az</code> if the Memcached cache cluster already has cache nodes in
* different Availability Zones. If <code>cross-az</code> is specified, existing Memcached nodes remain in
* their current Availability Zone.
* </p>
* <p>
* Only newly created nodes are located in different Availability Zones. For instructions on how to move
* existing Memcached nodes to different Availability Zones, see the <b>Availability Zone Considerations</b>
* section of <a
* href="http://docs.aws.amazon.com/AmazonElastiCache/latest/UserGuide/CacheNode.Memcached.html">Cache Node
* Considerations for Memcached</a>.
* </p>
* @see AZMode
*/
public String getAZMode() {
return this.aZMode;
}
/**
* <p>
* Specifies whether the new nodes in this Memcached cache cluster are all created in a single Availability Zone or
* created across multiple Availability Zones.
* </p>
* <p>
* Valid values: <code>single-az</code> | <code>cross-az</code>.
* </p>
* <p>
* This option is only supported for Memcached cache clusters.
* </p>
* <note>
* <p>
* You cannot specify <code>single-az</code> if the Memcached cache cluster already has cache nodes in different
* Availability Zones. If <code>cross-az</code> is specified, existing Memcached nodes remain in their current
* Availability Zone.
* </p>
* <p>
* Only newly created nodes are located in different Availability Zones. For instructions on how to move existing
* Memcached nodes to different Availability Zones, see the <b>Availability Zone Considerations</b> section of <a
* href="http://docs.aws.amazon.com/AmazonElastiCache/latest/UserGuide/CacheNode.Memcached.html">Cache Node
* Considerations for Memcached</a>.
* </p>
* </note>
*
* @param aZMode
* Specifies whether the new nodes in this Memcached cache cluster are all created in a single Availability
* Zone or created across multiple Availability Zones.</p>
* <p>
* Valid values: <code>single-az</code> | <code>cross-az</code>.
* </p>
* <p>
* This option is only supported for Memcached cache clusters.
* </p>
* <note>
* <p>
* You cannot specify <code>single-az</code> if the Memcached cache cluster already has cache nodes in
* different Availability Zones. If <code>cross-az</code> is specified, existing Memcached nodes remain in
* their current Availability Zone.
* </p>
* <p>
* Only newly created nodes are located in different Availability Zones. For instructions on how to move
* existing Memcached nodes to different Availability Zones, see the <b>Availability Zone Considerations</b>
* section of <a
* href="http://docs.aws.amazon.com/AmazonElastiCache/latest/UserGuide/CacheNode.Memcached.html">Cache Node
* Considerations for Memcached</a>.
* </p>
* @return Returns a reference to this object so that method calls can be chained together.
* @see AZMode
*/
public ModifyCacheClusterRequest withAZMode(String aZMode) {
setAZMode(aZMode);
return this;
}
/**
* <p>
* Specifies whether the new nodes in this Memcached cache cluster are all created in a single Availability Zone or
* created across multiple Availability Zones.
* </p>
* <p>
* Valid values: <code>single-az</code> | <code>cross-az</code>.
* </p>
* <p>
* This option is only supported for Memcached cache clusters.
* </p>
* <note>
* <p>
* You cannot specify <code>single-az</code> if the Memcached cache cluster already has cache nodes in different
* Availability Zones. If <code>cross-az</code> is specified, existing Memcached nodes remain in their current
* Availability Zone.
* </p>
* <p>
* Only newly created nodes are located in different Availability Zones. For instructions on how to move existing
* Memcached nodes to different Availability Zones, see the <b>Availability Zone Considerations</b> section of <a
* href="http://docs.aws.amazon.com/AmazonElastiCache/latest/UserGuide/CacheNode.Memcached.html">Cache Node
* Considerations for Memcached</a>.
* </p>
* </note>
*
* @param aZMode
* Specifies whether the new nodes in this Memcached cache cluster are all created in a single Availability
* Zone or created across multiple Availability Zones.</p>
* <p>
* Valid values: <code>single-az</code> | <code>cross-az</code>.
* </p>
* <p>
* This option is only supported for Memcached cache clusters.
* </p>
* <note>
* <p>
* You cannot specify <code>single-az</code> if the Memcached cache cluster already has cache nodes in
* different Availability Zones. If <code>cross-az</code> is specified, existing Memcached nodes remain in
* their current Availability Zone.
* </p>
* <p>
* Only newly created nodes are located in different Availability Zones. For instructions on how to move
* existing Memcached nodes to different Availability Zones, see the <b>Availability Zone Considerations</b>
* section of <a
* href="http://docs.aws.amazon.com/AmazonElastiCache/latest/UserGuide/CacheNode.Memcached.html">Cache Node
* Considerations for Memcached</a>.
* </p>
* @see AZMode
*/
public void setAZMode(AZMode aZMode) {
this.aZMode = aZMode.toString();
}
/**
* <p>
* Specifies whether the new nodes in this Memcached cache cluster are all created in a single Availability Zone or
* created across multiple Availability Zones.
* </p>
* <p>
* Valid values: <code>single-az</code> | <code>cross-az</code>.
* </p>
* <p>
* This option is only supported for Memcached cache clusters.
* </p>
* <note>
* <p>
* You cannot specify <code>single-az</code> if the Memcached cache cluster already has cache nodes in different
* Availability Zones. If <code>cross-az</code> is specified, existing Memcached nodes remain in their current
* Availability Zone.
* </p>
* <p>
* Only newly created nodes are located in different Availability Zones. For instructions on how to move existing
* Memcached nodes to different Availability Zones, see the <b>Availability Zone Considerations</b> section of <a
* href="http://docs.aws.amazon.com/AmazonElastiCache/latest/UserGuide/CacheNode.Memcached.html">Cache Node
* Considerations for Memcached</a>.
* </p>
* </note>
*
* @param aZMode
* Specifies whether the new nodes in this Memcached cache cluster are all created in a single Availability
* Zone or created across multiple Availability Zones.</p>
* <p>
* Valid values: <code>single-az</code> | <code>cross-az</code>.
* </p>
* <p>
* This option is only supported for Memcached cache clusters.
* </p>
* <note>
* <p>
* You cannot specify <code>single-az</code> if the Memcached cache cluster already has cache nodes in
* different Availability Zones. If <code>cross-az</code> is specified, existing Memcached nodes remain in
* their current Availability Zone.
* </p>
* <p>
* Only newly created nodes are located in different Availability Zones. For instructions on how to move
* existing Memcached nodes to different Availability Zones, see the <b>Availability Zone Considerations</b>
* section of <a
* href="http://docs.aws.amazon.com/AmazonElastiCache/latest/UserGuide/CacheNode.Memcached.html">Cache Node
* Considerations for Memcached</a>.
* </p>
* @return Returns a reference to this object so that method calls can be chained together.
* @see AZMode
*/
public ModifyCacheClusterRequest withAZMode(AZMode aZMode) {
setAZMode(aZMode);
return this;
}
/**
* <p>
* The list of Availability Zones where the new Memcached cache nodes are created.
* </p>
* <p>
* This parameter is only valid when <code>NumCacheNodes</code> in the request is greater than the sum of the number
* of active cache nodes and the number of cache nodes pending creation (which may be zero). The number of
* Availability Zones supplied in this list must match the cache nodes being added in this request.
* </p>
* <p>
* This option is only supported on Memcached clusters.
* </p>
* <p>
* Scenarios:
* </p>
* <ul>
* <li>
* <p>
* <b>Scenario 1:</b> You have 3 active nodes and wish to add 2 nodes. Specify <code>NumCacheNodes=5</code> (3 + 2)
* and optionally specify two Availability Zones for the two new nodes.
* </p>
* </li>
* <li>
* <p>
* <b>Scenario 2:</b> You have 3 active nodes and 2 nodes pending creation (from the scenario 1 call) and want to
* add 1 more node. Specify <code>NumCacheNodes=6</code> ((3 + 2) + 1) and optionally specify an Availability Zone
* for the new node.
* </p>
* </li>
* <li>
* <p>
* <b>Scenario 3:</b> You want to cancel all pending operations. Specify <code>NumCacheNodes=3</code> to cancel all
* pending operations.
* </p>
* </li>
* </ul>
* <p>
* The Availability Zone placement of nodes pending creation cannot be modified. If you wish to cancel any nodes
* pending creation, add 0 nodes by setting <code>NumCacheNodes</code> to the number of current nodes.
* </p>
* <p>
* If <code>cross-az</code> is specified, existing Memcached nodes remain in their current Availability Zone. Only
* newly created nodes can be located in different Availability Zones. For guidance on how to move existing
* Memcached nodes to different Availability Zones, see the <b>Availability Zone Considerations</b> section of <a
* href="http://docs.aws.amazon.com/AmazonElastiCache/latest/UserGuide/CacheNode.Memcached.html">Cache Node
* Considerations for Memcached</a>.
* </p>
* <p>
* <b>Impact of new add/remove requests upon pending requests</b>
* </p>
* <ul>
* <li>
* <p>
* Scenario-1
* </p>
* <ul>
* <li>
* <p>
* Pending Action: Delete
* </p>
* </li>
* <li>
* <p>
* New Request: Delete
* </p>
* </li>
* <li>
* <p>
* Result: The new delete, pending or immediate, replaces the pending delete.
* </p>
* </li>
* </ul>
* </li>
* <li>
* <p>
* Scenario-2
* </p>
* <ul>
* <li>
* <p>
* Pending Action: Delete
* </p>
* </li>
* <li>
* <p>
* New Request: Create
* </p>
* </li>
* <li>
* <p>
* Result: The new create, pending or immediate, replaces the pending delete.
* </p>
* </li>
* </ul>
* </li>
* <li>
* <p>
* Scenario-3
* </p>
* <ul>
* <li>
* <p>
* Pending Action: Create
* </p>
* </li>
* <li>
* <p>
* New Request: Delete
* </p>
* </li>
* <li>
* <p>
* Result: The new delete, pending or immediate, replaces the pending create.
* </p>
* </li>
* </ul>
* </li>
* <li>
* <p>
* Scenario-4
* </p>
* <ul>
* <li>
* <p>
* Pending Action: Create
* </p>
* </li>
* <li>
* <p>
* New Request: Create
* </p>
* </li>
* <li>
* <p>
* Result: The new create is added to the pending create.
* </p>
* <important>
* <p>
* <b>Important:</b> If the new create request is <b>Apply Immediately - Yes</b>, all creates are performed
* immediately. If the new create request is <b>Apply Immediately - No</b>, all creates are pending.
* </p>
* </important></li>
* </ul>
* </li>
* </ul>
*
* @return The list of Availability Zones where the new Memcached cache nodes are created.</p>
* <p>
* This parameter is only valid when <code>NumCacheNodes</code> in the request is greater than the sum of
* the number of active cache nodes and the number of cache nodes pending creation (which may be zero). The
* number of Availability Zones supplied in this list must match the cache nodes being added in this
* request.
* </p>
* <p>
* This option is only supported on Memcached clusters.
* </p>
* <p>
* Scenarios:
* </p>
* <ul>
* <li>
* <p>
* <b>Scenario 1:</b> You have 3 active nodes and wish to add 2 nodes. Specify <code>NumCacheNodes=5</code>
* (3 + 2) and optionally specify two Availability Zones for the two new nodes.
* </p>
* </li>
* <li>
* <p>
* <b>Scenario 2:</b> You have 3 active nodes and 2 nodes pending creation (from the scenario 1 call) and
* want to add 1 more node. Specify <code>NumCacheNodes=6</code> ((3 + 2) + 1) and optionally specify an
* Availability Zone for the new node.
* </p>
* </li>
* <li>
* <p>
* <b>Scenario 3:</b> You want to cancel all pending operations. Specify <code>NumCacheNodes=3</code> to
* cancel all pending operations.
* </p>
* </li>
* </ul>
* <p>
* The Availability Zone placement of nodes pending creation cannot be modified. If you wish to cancel any
* nodes pending creation, add 0 nodes by setting <code>NumCacheNodes</code> to the number of current nodes.
* </p>
* <p>
* If <code>cross-az</code> is specified, existing Memcached nodes remain in their current Availability
* Zone. Only newly created nodes can be located in different Availability Zones. For guidance on how to
* move existing Memcached nodes to different Availability Zones, see the <b>Availability Zone
* Considerations</b> section of <a
* href="http://docs.aws.amazon.com/AmazonElastiCache/latest/UserGuide/CacheNode.Memcached.html">Cache Node
* Considerations for Memcached</a>.
* </p>
* <p>
* <b>Impact of new add/remove requests upon pending requests</b>
* </p>
* <ul>
* <li>
* <p>
* Scenario-1
* </p>
* <ul>
* <li>
* <p>
* Pending Action: Delete
* </p>
* </li>
* <li>
* <p>
* New Request: Delete
* </p>
* </li>
* <li>
* <p>
* Result: The new delete, pending or immediate, replaces the pending delete.
* </p>
* </li>
* </ul>
* </li>
* <li>
* <p>
* Scenario-2
* </p>
* <ul>
* <li>
* <p>
* Pending Action: Delete
* </p>
* </li>
* <li>
* <p>
* New Request: Create
* </p>
* </li>
* <li>
* <p>
* Result: The new create, pending or immediate, replaces the pending delete.
* </p>
* </li>
* </ul>
* </li>
* <li>
* <p>
* Scenario-3
* </p>
* <ul>
* <li>
* <p>
* Pending Action: Create
* </p>
* </li>
* <li>
* <p>
* New Request: Delete
* </p>
* </li>
* <li>
* <p>
* Result: The new delete, pending or immediate, replaces the pending create.
* </p>
* </li>
* </ul>
* </li>
* <li>
* <p>
* Scenario-4
* </p>
* <ul>
* <li>
* <p>
* Pending Action: Create
* </p>
* </li>
* <li>
* <p>
* New Request: Create
* </p>
* </li>
* <li>
* <p>
* Result: The new create is added to the pending create.
* </p>
* <important>
* <p>
* <b>Important:</b> If the new create request is <b>Apply Immediately - Yes</b>, all creates are performed
* immediately. If the new create request is <b>Apply Immediately - No</b>, all creates are pending.
* </p>
* </important></li>
* </ul>
* </li>
*/
public java.util.List<String> getNewAvailabilityZones() {
if (newAvailabilityZones == null) {
newAvailabilityZones = new com.amazonaws.internal.SdkInternalList<String>();
}
return newAvailabilityZones;
}
/**
* <p>
* The list of Availability Zones where the new Memcached cache nodes are created.
* </p>
* <p>
* This parameter is only valid when <code>NumCacheNodes</code> in the request is greater than the sum of the number
* of active cache nodes and the number of cache nodes pending creation (which may be zero). The number of
* Availability Zones supplied in this list must match the cache nodes being added in this request.
* </p>
* <p>
* This option is only supported on Memcached clusters.
* </p>
* <p>
* Scenarios:
* </p>
* <ul>
* <li>
* <p>
* <b>Scenario 1:</b> You have 3 active nodes and wish to add 2 nodes. Specify <code>NumCacheNodes=5</code> (3 + 2)
* and optionally specify two Availability Zones for the two new nodes.
* </p>
* </li>
* <li>
* <p>
* <b>Scenario 2:</b> You have 3 active nodes and 2 nodes pending creation (from the scenario 1 call) and want to
* add 1 more node. Specify <code>NumCacheNodes=6</code> ((3 + 2) + 1) and optionally specify an Availability Zone
* for the new node.
* </p>
* </li>
* <li>
* <p>
* <b>Scenario 3:</b> You want to cancel all pending operations. Specify <code>NumCacheNodes=3</code> to cancel all
* pending operations.
* </p>
* </li>
* </ul>
* <p>
* The Availability Zone placement of nodes pending creation cannot be modified. If you wish to cancel any nodes
* pending creation, add 0 nodes by setting <code>NumCacheNodes</code> to the number of current nodes.
* </p>
* <p>
* If <code>cross-az</code> is specified, existing Memcached nodes remain in their current Availability Zone. Only
* newly created nodes can be located in different Availability Zones. For guidance on how to move existing
* Memcached nodes to different Availability Zones, see the <b>Availability Zone Considerations</b> section of <a
* href="http://docs.aws.amazon.com/AmazonElastiCache/latest/UserGuide/CacheNode.Memcached.html">Cache Node
* Considerations for Memcached</a>.
* </p>
* <p>
* <b>Impact of new add/remove requests upon pending requests</b>
* </p>
* <ul>
* <li>
* <p>
* Scenario-1
* </p>
* <ul>
* <li>
* <p>
* Pending Action: Delete
* </p>
* </li>
* <li>
* <p>
* New Request: Delete
* </p>
* </li>
* <li>
* <p>
* Result: The new delete, pending or immediate, replaces the pending delete.
* </p>
* </li>
* </ul>
* </li>
* <li>
* <p>
* Scenario-2
* </p>
* <ul>
* <li>
* <p>
* Pending Action: Delete
* </p>
* </li>
* <li>
* <p>
* New Request: Create
* </p>
* </li>
* <li>
* <p>
* Result: The new create, pending or immediate, replaces the pending delete.
* </p>
* </li>
* </ul>
* </li>
* <li>
* <p>
* Scenario-3
* </p>
* <ul>
* <li>
* <p>
* Pending Action: Create
* </p>
* </li>
* <li>
* <p>
* New Request: Delete
* </p>
* </li>
* <li>
* <p>
* Result: The new delete, pending or immediate, replaces the pending create.
* </p>
* </li>
* </ul>
* </li>
* <li>
* <p>
* Scenario-4
* </p>
* <ul>
* <li>
* <p>
* Pending Action: Create
* </p>
* </li>
* <li>
* <p>
* New Request: Create
* </p>
* </li>
* <li>
* <p>
* Result: The new create is added to the pending create.
* </p>
* <important>
* <p>
* <b>Important:</b> If the new create request is <b>Apply Immediately - Yes</b>, all creates are performed
* immediately. If the new create request is <b>Apply Immediately - No</b>, all creates are pending.
* </p>
* </important></li>
* </ul>
* </li>
* </ul>
*
* @param newAvailabilityZones
* The list of Availability Zones where the new Memcached cache nodes are created.</p>
* <p>
* This parameter is only valid when <code>NumCacheNodes</code> in the request is greater than the sum of the
* number of active cache nodes and the number of cache nodes pending creation (which may be zero). The
* number of Availability Zones supplied in this list must match the cache nodes being added in this request.
* </p>
* <p>
* This option is only supported on Memcached clusters.
* </p>
* <p>
* Scenarios:
* </p>
* <ul>
* <li>
* <p>
* <b>Scenario 1:</b> You have 3 active nodes and wish to add 2 nodes. Specify <code>NumCacheNodes=5</code>
* (3 + 2) and optionally specify two Availability Zones for the two new nodes.
* </p>
* </li>
* <li>
* <p>
* <b>Scenario 2:</b> You have 3 active nodes and 2 nodes pending creation (from the scenario 1 call) and
* want to add 1 more node. Specify <code>NumCacheNodes=6</code> ((3 + 2) + 1) and optionally specify an
* Availability Zone for the new node.
* </p>
* </li>
* <li>
* <p>
* <b>Scenario 3:</b> You want to cancel all pending operations. Specify <code>NumCacheNodes=3</code> to
* cancel all pending operations.
* </p>
* </li>
* </ul>
* <p>
* The Availability Zone placement of nodes pending creation cannot be modified. If you wish to cancel any
* nodes pending creation, add 0 nodes by setting <code>NumCacheNodes</code> to the number of current nodes.
* </p>
* <p>
* If <code>cross-az</code> is specified, existing Memcached nodes remain in their current Availability Zone.
* Only newly created nodes can be located in different Availability Zones. For guidance on how to move
* existing Memcached nodes to different Availability Zones, see the <b>Availability Zone Considerations</b>
* section of <a
* href="http://docs.aws.amazon.com/AmazonElastiCache/latest/UserGuide/CacheNode.Memcached.html">Cache Node
* Considerations for Memcached</a>.
* </p>
* <p>
* <b>Impact of new add/remove requests upon pending requests</b>
* </p>
* <ul>
* <li>
* <p>
* Scenario-1
* </p>
* <ul>
* <li>
* <p>
* Pending Action: Delete
* </p>
* </li>
* <li>
* <p>
* New Request: Delete
* </p>
* </li>
* <li>
* <p>
* Result: The new delete, pending or immediate, replaces the pending delete.
* </p>
* </li>
* </ul>
* </li>
* <li>
* <p>
* Scenario-2
* </p>
* <ul>
* <li>
* <p>
* Pending Action: Delete
* </p>
* </li>
* <li>
* <p>
* New Request: Create
* </p>
* </li>
* <li>
* <p>
* Result: The new create, pending or immediate, replaces the pending delete.
* </p>
* </li>
* </ul>
* </li>
* <li>
* <p>
* Scenario-3
* </p>
* <ul>
* <li>
* <p>
* Pending Action: Create
* </p>
* </li>
* <li>
* <p>
* New Request: Delete
* </p>
* </li>
* <li>
* <p>
* Result: The new delete, pending or immediate, replaces the pending create.
* </p>
* </li>
* </ul>
* </li>
* <li>
* <p>
* Scenario-4
* </p>
* <ul>
* <li>
* <p>
* Pending Action: Create
* </p>
* </li>
* <li>
* <p>
* New Request: Create
* </p>
* </li>
* <li>
* <p>
* Result: The new create is added to the pending create.
* </p>
* <important>
* <p>
* <b>Important:</b> If the new create request is <b>Apply Immediately - Yes</b>, all creates are performed
* immediately. If the new create request is <b>Apply Immediately - No</b>, all creates are pending.
* </p>
* </important></li>
* </ul>
* </li>
*/
public void setNewAvailabilityZones(java.util.Collection<String> newAvailabilityZones) {
if (newAvailabilityZones == null) {
this.newAvailabilityZones = null;
return;
}
this.newAvailabilityZones = new com.amazonaws.internal.SdkInternalList<String>(newAvailabilityZones);
}
/**
* <p>
* The list of Availability Zones where the new Memcached cache nodes are created.
* </p>
* <p>
* This parameter is only valid when <code>NumCacheNodes</code> in the request is greater than the sum of the number
* of active cache nodes and the number of cache nodes pending creation (which may be zero). The number of
* Availability Zones supplied in this list must match the cache nodes being added in this request.
* </p>
* <p>
* This option is only supported on Memcached clusters.
* </p>
* <p>
* Scenarios:
* </p>
* <ul>
* <li>
* <p>
* <b>Scenario 1:</b> You have 3 active nodes and wish to add 2 nodes. Specify <code>NumCacheNodes=5</code> (3 + 2)
* and optionally specify two Availability Zones for the two new nodes.
* </p>
* </li>
* <li>
* <p>
* <b>Scenario 2:</b> You have 3 active nodes and 2 nodes pending creation (from the scenario 1 call) and want to
* add 1 more node. Specify <code>NumCacheNodes=6</code> ((3 + 2) + 1) and optionally specify an Availability Zone
* for the new node.
* </p>
* </li>
* <li>
* <p>
* <b>Scenario 3:</b> You want to cancel all pending operations. Specify <code>NumCacheNodes=3</code> to cancel all
* pending operations.
* </p>
* </li>
* </ul>
* <p>
* The Availability Zone placement of nodes pending creation cannot be modified. If you wish to cancel any nodes
* pending creation, add 0 nodes by setting <code>NumCacheNodes</code> to the number of current nodes.
* </p>
* <p>
* If <code>cross-az</code> is specified, existing Memcached nodes remain in their current Availability Zone. Only
* newly created nodes can be located in different Availability Zones. For guidance on how to move existing
* Memcached nodes to different Availability Zones, see the <b>Availability Zone Considerations</b> section of <a
* href="http://docs.aws.amazon.com/AmazonElastiCache/latest/UserGuide/CacheNode.Memcached.html">Cache Node
* Considerations for Memcached</a>.
* </p>
* <p>
* <b>Impact of new add/remove requests upon pending requests</b>
* </p>
* <ul>
* <li>
* <p>
* Scenario-1
* </p>
* <ul>
* <li>
* <p>
* Pending Action: Delete
* </p>
* </li>
* <li>
* <p>
* New Request: Delete
* </p>
* </li>
* <li>
* <p>
* Result: The new delete, pending or immediate, replaces the pending delete.
* </p>
* </li>
* </ul>
* </li>
* <li>
* <p>
* Scenario-2
* </p>
* <ul>
* <li>
* <p>
* Pending Action: Delete
* </p>
* </li>
* <li>
* <p>
* New Request: Create
* </p>
* </li>
* <li>
* <p>
* Result: The new create, pending or immediate, replaces the pending delete.
* </p>
* </li>
* </ul>
* </li>
* <li>
* <p>
* Scenario-3
* </p>
* <ul>
* <li>
* <p>
* Pending Action: Create
* </p>
* </li>
* <li>
* <p>
* New Request: Delete
* </p>
* </li>
* <li>
* <p>
* Result: The new delete, pending or immediate, replaces the pending create.
* </p>
* </li>
* </ul>
* </li>
* <li>
* <p>
* Scenario-4
* </p>
* <ul>
* <li>
* <p>
* Pending Action: Create
* </p>
* </li>
* <li>
* <p>
* New Request: Create
* </p>
* </li>
* <li>
* <p>
* Result: The new create is added to the pending create.
* </p>
* <important>
* <p>
* <b>Important:</b> If the new create request is <b>Apply Immediately - Yes</b>, all creates are performed
* immediately. If the new create request is <b>Apply Immediately - No</b>, all creates are pending.
* </p>
* </important></li>
* </ul>
* </li>
* </ul>
* <p>
* <b>NOTE:</b> This method appends the values to the existing list (if any). Use
* {@link #setNewAvailabilityZones(java.util.Collection)} or {@link #withNewAvailabilityZones(java.util.Collection)}
* if you want to override the existing values.
* </p>
*
* @param newAvailabilityZones
* The list of Availability Zones where the new Memcached cache nodes are created.</p>
* <p>
* This parameter is only valid when <code>NumCacheNodes</code> in the request is greater than the sum of the
* number of active cache nodes and the number of cache nodes pending creation (which may be zero). The
* number of Availability Zones supplied in this list must match the cache nodes being added in this request.
* </p>
* <p>
* This option is only supported on Memcached clusters.
* </p>
* <p>
* Scenarios:
* </p>
* <ul>
* <li>
* <p>
* <b>Scenario 1:</b> You have 3 active nodes and wish to add 2 nodes. Specify <code>NumCacheNodes=5</code>
* (3 + 2) and optionally specify two Availability Zones for the two new nodes.
* </p>
* </li>
* <li>
* <p>
* <b>Scenario 2:</b> You have 3 active nodes and 2 nodes pending creation (from the scenario 1 call) and
* want to add 1 more node. Specify <code>NumCacheNodes=6</code> ((3 + 2) + 1) and optionally specify an
* Availability Zone for the new node.
* </p>
* </li>
* <li>
* <p>
* <b>Scenario 3:</b> You want to cancel all pending operations. Specify <code>NumCacheNodes=3</code> to
* cancel all pending operations.
* </p>
* </li>
* </ul>
* <p>
* The Availability Zone placement of nodes pending creation cannot be modified. If you wish to cancel any
* nodes pending creation, add 0 nodes by setting <code>NumCacheNodes</code> to the number of current nodes.
* </p>
* <p>
* If <code>cross-az</code> is specified, existing Memcached nodes remain in their current Availability Zone.
* Only newly created nodes can be located in different Availability Zones. For guidance on how to move
* existing Memcached nodes to different Availability Zones, see the <b>Availability Zone Considerations</b>
* section of <a
* href="http://docs.aws.amazon.com/AmazonElastiCache/latest/UserGuide/CacheNode.Memcached.html">Cache Node
* Considerations for Memcached</a>.
* </p>
* <p>
* <b>Impact of new add/remove requests upon pending requests</b>
* </p>
* <ul>
* <li>
* <p>
* Scenario-1
* </p>
* <ul>
* <li>
* <p>
* Pending Action: Delete
* </p>
* </li>
* <li>
* <p>
* New Request: Delete
* </p>
* </li>
* <li>
* <p>
* Result: The new delete, pending or immediate, replaces the pending delete.
* </p>
* </li>
* </ul>
* </li>
* <li>
* <p>
* Scenario-2
* </p>
* <ul>
* <li>
* <p>
* Pending Action: Delete
* </p>
* </li>
* <li>
* <p>
* New Request: Create
* </p>
* </li>
* <li>
* <p>
* Result: The new create, pending or immediate, replaces the pending delete.
* </p>
* </li>
* </ul>
* </li>
* <li>
* <p>
* Scenario-3
* </p>
* <ul>
* <li>
* <p>
* Pending Action: Create
* </p>
* </li>
* <li>
* <p>
* New Request: Delete
* </p>
* </li>
* <li>
* <p>
* Result: The new delete, pending or immediate, replaces the pending create.
* </p>
* </li>
* </ul>
* </li>
* <li>
* <p>
* Scenario-4
* </p>
* <ul>
* <li>
* <p>
* Pending Action: Create
* </p>
* </li>
* <li>
* <p>
* New Request: Create
* </p>
* </li>
* <li>
* <p>
* Result: The new create is added to the pending create.
* </p>
* <important>
* <p>
* <b>Important:</b> If the new create request is <b>Apply Immediately - Yes</b>, all creates are performed
* immediately. If the new create request is <b>Apply Immediately - No</b>, all creates are pending.
* </p>
* </important></li>
* </ul>
* </li>
* @return Returns a reference to this object so that method calls can be chained together.
*/
public ModifyCacheClusterRequest withNewAvailabilityZones(String... newAvailabilityZones) {
if (this.newAvailabilityZones == null) {
setNewAvailabilityZones(new com.amazonaws.internal.SdkInternalList<String>(newAvailabilityZones.length));
}
for (String ele : newAvailabilityZones) {
this.newAvailabilityZones.add(ele);
}
return this;
}
/**
* <p>
* The list of Availability Zones where the new Memcached cache nodes are created.
* </p>
* <p>
* This parameter is only valid when <code>NumCacheNodes</code> in the request is greater than the sum of the number
* of active cache nodes and the number of cache nodes pending creation (which may be zero). The number of
* Availability Zones supplied in this list must match the cache nodes being added in this request.
* </p>
* <p>
* This option is only supported on Memcached clusters.
* </p>
* <p>
* Scenarios:
* </p>
* <ul>
* <li>
* <p>
* <b>Scenario 1:</b> You have 3 active nodes and wish to add 2 nodes. Specify <code>NumCacheNodes=5</code> (3 + 2)
* and optionally specify two Availability Zones for the two new nodes.
* </p>
* </li>
* <li>
* <p>
* <b>Scenario 2:</b> You have 3 active nodes and 2 nodes pending creation (from the scenario 1 call) and want to
* add 1 more node. Specify <code>NumCacheNodes=6</code> ((3 + 2) + 1) and optionally specify an Availability Zone
* for the new node.
* </p>
* </li>
* <li>
* <p>
* <b>Scenario 3:</b> You want to cancel all pending operations. Specify <code>NumCacheNodes=3</code> to cancel all
* pending operations.
* </p>
* </li>
* </ul>
* <p>
* The Availability Zone placement of nodes pending creation cannot be modified. If you wish to cancel any nodes
* pending creation, add 0 nodes by setting <code>NumCacheNodes</code> to the number of current nodes.
* </p>
* <p>
* If <code>cross-az</code> is specified, existing Memcached nodes remain in their current Availability Zone. Only
* newly created nodes can be located in different Availability Zones. For guidance on how to move existing
* Memcached nodes to different Availability Zones, see the <b>Availability Zone Considerations</b> section of <a
* href="http://docs.aws.amazon.com/AmazonElastiCache/latest/UserGuide/CacheNode.Memcached.html">Cache Node
* Considerations for Memcached</a>.
* </p>
* <p>
* <b>Impact of new add/remove requests upon pending requests</b>
* </p>
* <ul>
* <li>
* <p>
* Scenario-1
* </p>
* <ul>
* <li>
* <p>
* Pending Action: Delete
* </p>
* </li>
* <li>
* <p>
* New Request: Delete
* </p>
* </li>
* <li>
* <p>
* Result: The new delete, pending or immediate, replaces the pending delete.
* </p>
* </li>
* </ul>
* </li>
* <li>
* <p>
* Scenario-2
* </p>
* <ul>
* <li>
* <p>
* Pending Action: Delete
* </p>
* </li>
* <li>
* <p>
* New Request: Create
* </p>
* </li>
* <li>
* <p>
* Result: The new create, pending or immediate, replaces the pending delete.
* </p>
* </li>
* </ul>
* </li>
* <li>
* <p>
* Scenario-3
* </p>
* <ul>
* <li>
* <p>
* Pending Action: Create
* </p>
* </li>
* <li>
* <p>
* New Request: Delete
* </p>
* </li>
* <li>
* <p>
* Result: The new delete, pending or immediate, replaces the pending create.
* </p>
* </li>
* </ul>
* </li>
* <li>
* <p>
* Scenario-4
* </p>
* <ul>
* <li>
* <p>
* Pending Action: Create
* </p>
* </li>
* <li>
* <p>
* New Request: Create
* </p>
* </li>
* <li>
* <p>
* Result: The new create is added to the pending create.
* </p>
* <important>
* <p>
* <b>Important:</b> If the new create request is <b>Apply Immediately - Yes</b>, all creates are performed
* immediately. If the new create request is <b>Apply Immediately - No</b>, all creates are pending.
* </p>
* </important></li>
* </ul>
* </li>
* </ul>
*
* @param newAvailabilityZones
* The list of Availability Zones where the new Memcached cache nodes are created.</p>
* <p>
* This parameter is only valid when <code>NumCacheNodes</code> in the request is greater than the sum of the
* number of active cache nodes and the number of cache nodes pending creation (which may be zero). The
* number of Availability Zones supplied in this list must match the cache nodes being added in this request.
* </p>
* <p>
* This option is only supported on Memcached clusters.
* </p>
* <p>
* Scenarios:
* </p>
* <ul>
* <li>
* <p>
* <b>Scenario 1:</b> You have 3 active nodes and wish to add 2 nodes. Specify <code>NumCacheNodes=5</code>
* (3 + 2) and optionally specify two Availability Zones for the two new nodes.
* </p>
* </li>
* <li>
* <p>
* <b>Scenario 2:</b> You have 3 active nodes and 2 nodes pending creation (from the scenario 1 call) and
* want to add 1 more node. Specify <code>NumCacheNodes=6</code> ((3 + 2) + 1) and optionally specify an
* Availability Zone for the new node.
* </p>
* </li>
* <li>
* <p>
* <b>Scenario 3:</b> You want to cancel all pending operations. Specify <code>NumCacheNodes=3</code> to
* cancel all pending operations.
* </p>
* </li>
* </ul>
* <p>
* The Availability Zone placement of nodes pending creation cannot be modified. If you wish to cancel any
* nodes pending creation, add 0 nodes by setting <code>NumCacheNodes</code> to the number of current nodes.
* </p>
* <p>
* If <code>cross-az</code> is specified, existing Memcached nodes remain in their current Availability Zone.
* Only newly created nodes can be located in different Availability Zones. For guidance on how to move
* existing Memcached nodes to different Availability Zones, see the <b>Availability Zone Considerations</b>
* section of <a
* href="http://docs.aws.amazon.com/AmazonElastiCache/latest/UserGuide/CacheNode.Memcached.html">Cache Node
* Considerations for Memcached</a>.
* </p>
* <p>
* <b>Impact of new add/remove requests upon pending requests</b>
* </p>
* <ul>
* <li>
* <p>
* Scenario-1
* </p>
* <ul>
* <li>
* <p>
* Pending Action: Delete
* </p>
* </li>
* <li>
* <p>
* New Request: Delete
* </p>
* </li>
* <li>
* <p>
* Result: The new delete, pending or immediate, replaces the pending delete.
* </p>
* </li>
* </ul>
* </li>
* <li>
* <p>
* Scenario-2
* </p>
* <ul>
* <li>
* <p>
* Pending Action: Delete
* </p>
* </li>
* <li>
* <p>
* New Request: Create
* </p>
* </li>
* <li>
* <p>
* Result: The new create, pending or immediate, replaces the pending delete.
* </p>
* </li>
* </ul>
* </li>
* <li>
* <p>
* Scenario-3
* </p>
* <ul>
* <li>
* <p>
* Pending Action: Create
* </p>
* </li>
* <li>
* <p>
* New Request: Delete
* </p>
* </li>
* <li>
* <p>
* Result: The new delete, pending or immediate, replaces the pending create.
* </p>
* </li>
* </ul>
* </li>
* <li>
* <p>
* Scenario-4
* </p>
* <ul>
* <li>
* <p>
* Pending Action: Create
* </p>
* </li>
* <li>
* <p>
* New Request: Create
* </p>
* </li>
* <li>
* <p>
* Result: The new create is added to the pending create.
* </p>
* <important>
* <p>
* <b>Important:</b> If the new create request is <b>Apply Immediately - Yes</b>, all creates are performed
* immediately. If the new create request is <b>Apply Immediately - No</b>, all creates are pending.
* </p>
* </important></li>
* </ul>
* </li>
* @return Returns a reference to this object so that method calls can be chained together.
*/
public ModifyCacheClusterRequest withNewAvailabilityZones(java.util.Collection<String> newAvailabilityZones) {
setNewAvailabilityZones(newAvailabilityZones);
return this;
}
/**
* <p>
* A list of cache security group names to authorize on this cache cluster. This change is asynchronously applied as
* soon as possible.
* </p>
* <p>
* You can use this parameter only with clusters that are created outside of an Amazon Virtual Private Cloud (Amazon
* VPC).
* </p>
* <p>
* Constraints: Must contain no more than 255 alphanumeric characters. Must not be "Default".
* </p>
*
* @return A list of cache security group names to authorize on this cache cluster. This change is asynchronously
* applied as soon as possible.</p>
* <p>
* You can use this parameter only with clusters that are created outside of an Amazon Virtual Private Cloud
* (Amazon VPC).
* </p>
* <p>
* Constraints: Must contain no more than 255 alphanumeric characters. Must not be "Default".
*/
public java.util.List<String> getCacheSecurityGroupNames() {
if (cacheSecurityGroupNames == null) {
cacheSecurityGroupNames = new com.amazonaws.internal.SdkInternalList<String>();
}
return cacheSecurityGroupNames;
}
/**
* <p>
* A list of cache security group names to authorize on this cache cluster. This change is asynchronously applied as
* soon as possible.
* </p>
* <p>
* You can use this parameter only with clusters that are created outside of an Amazon Virtual Private Cloud (Amazon
* VPC).
* </p>
* <p>
* Constraints: Must contain no more than 255 alphanumeric characters. Must not be "Default".
* </p>
*
* @param cacheSecurityGroupNames
* A list of cache security group names to authorize on this cache cluster. This change is asynchronously
* applied as soon as possible.</p>
* <p>
* You can use this parameter only with clusters that are created outside of an Amazon Virtual Private Cloud
* (Amazon VPC).
* </p>
* <p>
* Constraints: Must contain no more than 255 alphanumeric characters. Must not be "Default".
*/
public void setCacheSecurityGroupNames(java.util.Collection<String> cacheSecurityGroupNames) {
if (cacheSecurityGroupNames == null) {
this.cacheSecurityGroupNames = null;
return;
}
this.cacheSecurityGroupNames = new com.amazonaws.internal.SdkInternalList<String>(cacheSecurityGroupNames);
}
/**
* <p>
* A list of cache security group names to authorize on this cache cluster. This change is asynchronously applied as
* soon as possible.
* </p>
* <p>
* You can use this parameter only with clusters that are created outside of an Amazon Virtual Private Cloud (Amazon
* VPC).
* </p>
* <p>
* Constraints: Must contain no more than 255 alphanumeric characters. Must not be "Default".
* </p>
* <p>
* <b>NOTE:</b> This method appends the values to the existing list (if any). Use
* {@link #setCacheSecurityGroupNames(java.util.Collection)} or
* {@link #withCacheSecurityGroupNames(java.util.Collection)} if you want to override the existing values.
* </p>
*
* @param cacheSecurityGroupNames
* A list of cache security group names to authorize on this cache cluster. This change is asynchronously
* applied as soon as possible.</p>
* <p>
* You can use this parameter only with clusters that are created outside of an Amazon Virtual Private Cloud
* (Amazon VPC).
* </p>
* <p>
* Constraints: Must contain no more than 255 alphanumeric characters. Must not be "Default".
* @return Returns a reference to this object so that method calls can be chained together.
*/
public ModifyCacheClusterRequest withCacheSecurityGroupNames(String... cacheSecurityGroupNames) {
if (this.cacheSecurityGroupNames == null) {
setCacheSecurityGroupNames(new com.amazonaws.internal.SdkInternalList<String>(cacheSecurityGroupNames.length));
}
for (String ele : cacheSecurityGroupNames) {
this.cacheSecurityGroupNames.add(ele);
}
return this;
}
/**
* <p>
* A list of cache security group names to authorize on this cache cluster. This change is asynchronously applied as
* soon as possible.
* </p>
* <p>
* You can use this parameter only with clusters that are created outside of an Amazon Virtual Private Cloud (Amazon
* VPC).
* </p>
* <p>
* Constraints: Must contain no more than 255 alphanumeric characters. Must not be "Default".
* </p>
*
* @param cacheSecurityGroupNames
* A list of cache security group names to authorize on this cache cluster. This change is asynchronously
* applied as soon as possible.</p>
* <p>
* You can use this parameter only with clusters that are created outside of an Amazon Virtual Private Cloud
* (Amazon VPC).
* </p>
* <p>
* Constraints: Must contain no more than 255 alphanumeric characters. Must not be "Default".
* @return Returns a reference to this object so that method calls can be chained together.
*/
public ModifyCacheClusterRequest withCacheSecurityGroupNames(java.util.Collection<String> cacheSecurityGroupNames) {
setCacheSecurityGroupNames(cacheSecurityGroupNames);
return this;
}
/**
* <p>
* Specifies the VPC Security Groups associated with the cache cluster.
* </p>
* <p>
* This parameter can be used only with clusters that are created in an Amazon Virtual Private Cloud (Amazon VPC).
* </p>
*
* @return Specifies the VPC Security Groups associated with the cache cluster.</p>
* <p>
* This parameter can be used only with clusters that are created in an Amazon Virtual Private Cloud (Amazon
* VPC).
*/
public java.util.List<String> getSecurityGroupIds() {
if (securityGroupIds == null) {
securityGroupIds = new com.amazonaws.internal.SdkInternalList<String>();
}
return securityGroupIds;
}
/**
* <p>
* Specifies the VPC Security Groups associated with the cache cluster.
* </p>
* <p>
* This parameter can be used only with clusters that are created in an Amazon Virtual Private Cloud (Amazon VPC).
* </p>
*
* @param securityGroupIds
* Specifies the VPC Security Groups associated with the cache cluster.</p>
* <p>
* This parameter can be used only with clusters that are created in an Amazon Virtual Private Cloud (Amazon
* VPC).
*/
public void setSecurityGroupIds(java.util.Collection<String> securityGroupIds) {
if (securityGroupIds == null) {
this.securityGroupIds = null;
return;
}
this.securityGroupIds = new com.amazonaws.internal.SdkInternalList<String>(securityGroupIds);
}
/**
* <p>
* Specifies the VPC Security Groups associated with the cache cluster.
* </p>
* <p>
* This parameter can be used only with clusters that are created in an Amazon Virtual Private Cloud (Amazon VPC).
* </p>
* <p>
* <b>NOTE:</b> This method appends the values to the existing list (if any). Use
* {@link #setSecurityGroupIds(java.util.Collection)} or {@link #withSecurityGroupIds(java.util.Collection)} if you
* want to override the existing values.
* </p>
*
* @param securityGroupIds
* Specifies the VPC Security Groups associated with the cache cluster.</p>
* <p>
* This parameter can be used only with clusters that are created in an Amazon Virtual Private Cloud (Amazon
* VPC).
* @return Returns a reference to this object so that method calls can be chained together.
*/
public ModifyCacheClusterRequest withSecurityGroupIds(String... securityGroupIds) {
if (this.securityGroupIds == null) {
setSecurityGroupIds(new com.amazonaws.internal.SdkInternalList<String>(securityGroupIds.length));
}
for (String ele : securityGroupIds) {
this.securityGroupIds.add(ele);
}
return this;
}
/**
* <p>
* Specifies the VPC Security Groups associated with the cache cluster.
* </p>
* <p>
* This parameter can be used only with clusters that are created in an Amazon Virtual Private Cloud (Amazon VPC).
* </p>
*
* @param securityGroupIds
* Specifies the VPC Security Groups associated with the cache cluster.</p>
* <p>
* This parameter can be used only with clusters that are created in an Amazon Virtual Private Cloud (Amazon
* VPC).
* @return Returns a reference to this object so that method calls can be chained together.
*/
public ModifyCacheClusterRequest withSecurityGroupIds(java.util.Collection<String> securityGroupIds) {
setSecurityGroupIds(securityGroupIds);
return this;
}
/**
* <p>
* 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.
* </p>
* <p>
* Valid values for <code>ddd</code> are:
* </p>
* <ul>
* <li>
* <p>
* <code>sun</code>
* </p>
* </li>
* <li>
* <p>
* <code>mon</code>
* </p>
* </li>
* <li>
* <p>
* <code>tue</code>
* </p>
* </li>
* <li>
* <p>
* <code>wed</code>
* </p>
* </li>
* <li>
* <p>
* <code>thu</code>
* </p>
* </li>
* <li>
* <p>
* <code>fri</code>
* </p>
* </li>
* <li>
* <p>
* <code>sat</code>
* </p>
* </li>
* </ul>
* <p>
* Example: <code>sun:23:00-mon:01:30</code>
* </p>
*
* @param 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.</p>
* <p>
* Valid values for <code>ddd</code> are:
* </p>
* <ul>
* <li>
* <p>
* <code>sun</code>
* </p>
* </li>
* <li>
* <p>
* <code>mon</code>
* </p>
* </li>
* <li>
* <p>
* <code>tue</code>
* </p>
* </li>
* <li>
* <p>
* <code>wed</code>
* </p>
* </li>
* <li>
* <p>
* <code>thu</code>
* </p>
* </li>
* <li>
* <p>
* <code>fri</code>
* </p>
* </li>
* <li>
* <p>
* <code>sat</code>
* </p>
* </li>
* </ul>
* <p>
* Example: <code>sun:23:00-mon:01:30</code>
*/
public void setPreferredMaintenanceWindow(String preferredMaintenanceWindow) {
this.preferredMaintenanceWindow = preferredMaintenanceWindow;
}
/**
* <p>
* 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.
* </p>
* <p>
* Valid values for <code>ddd</code> are:
* </p>
* <ul>
* <li>
* <p>
* <code>sun</code>
* </p>
* </li>
* <li>
* <p>
* <code>mon</code>
* </p>
* </li>
* <li>
* <p>
* <code>tue</code>
* </p>
* </li>
* <li>
* <p>
* <code>wed</code>
* </p>
* </li>
* <li>
* <p>
* <code>thu</code>
* </p>
* </li>
* <li>
* <p>
* <code>fri</code>
* </p>
* </li>
* <li>
* <p>
* <code>sat</code>
* </p>
* </li>
* </ul>
* <p>
* Example: <code>sun:23:00-mon:01:30</code>
* </p>
*
* @return 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.</p>
* <p>
* Valid values for <code>ddd</code> are:
* </p>
* <ul>
* <li>
* <p>
* <code>sun</code>
* </p>
* </li>
* <li>
* <p>
* <code>mon</code>
* </p>
* </li>
* <li>
* <p>
* <code>tue</code>
* </p>
* </li>
* <li>
* <p>
* <code>wed</code>
* </p>
* </li>
* <li>
* <p>
* <code>thu</code>
* </p>
* </li>
* <li>
* <p>
* <code>fri</code>
* </p>
* </li>
* <li>
* <p>
* <code>sat</code>
* </p>
* </li>
* </ul>
* <p>
* Example: <code>sun:23:00-mon:01:30</code>
*/
public String getPreferredMaintenanceWindow() {
return this.preferredMaintenanceWindow;
}
/**
* <p>
* 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.
* </p>
* <p>
* Valid values for <code>ddd</code> are:
* </p>
* <ul>
* <li>
* <p>
* <code>sun</code>
* </p>
* </li>
* <li>
* <p>
* <code>mon</code>
* </p>
* </li>
* <li>
* <p>
* <code>tue</code>
* </p>
* </li>
* <li>
* <p>
* <code>wed</code>
* </p>
* </li>
* <li>
* <p>
* <code>thu</code>
* </p>
* </li>
* <li>
* <p>
* <code>fri</code>
* </p>
* </li>
* <li>
* <p>
* <code>sat</code>
* </p>
* </li>
* </ul>
* <p>
* Example: <code>sun:23:00-mon:01:30</code>
* </p>
*
* @param 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.</p>
* <p>
* Valid values for <code>ddd</code> are:
* </p>
* <ul>
* <li>
* <p>
* <code>sun</code>
* </p>
* </li>
* <li>
* <p>
* <code>mon</code>
* </p>
* </li>
* <li>
* <p>
* <code>tue</code>
* </p>
* </li>
* <li>
* <p>
* <code>wed</code>
* </p>
* </li>
* <li>
* <p>
* <code>thu</code>
* </p>
* </li>
* <li>
* <p>
* <code>fri</code>
* </p>
* </li>
* <li>
* <p>
* <code>sat</code>
* </p>
* </li>
* </ul>
* <p>
* Example: <code>sun:23:00-mon:01:30</code>
* @return Returns a reference to this object so that method calls can be chained together.
*/
public ModifyCacheClusterRequest withPreferredMaintenanceWindow(String preferredMaintenanceWindow) {
setPreferredMaintenanceWindow(preferredMaintenanceWindow);
return this;
}
/**
* <p>
* The Amazon Resource Name (ARN) of the Amazon SNS topic to which notifications are sent.
* </p>
* <note>
* <p>
* The Amazon SNS topic owner must be same as the cache cluster owner.
* </p>
* </note>
*
* @param notificationTopicArn
* The Amazon Resource Name (ARN) of the Amazon SNS topic to which notifications are sent.</p> <note>
* <p>
* The Amazon SNS topic owner must be same as the cache cluster owner.
* </p>
*/
public void setNotificationTopicArn(String notificationTopicArn) {
this.notificationTopicArn = notificationTopicArn;
}
/**
* <p>
* The Amazon Resource Name (ARN) of the Amazon SNS topic to which notifications are sent.
* </p>
* <note>
* <p>
* The Amazon SNS topic owner must be same as the cache cluster owner.
* </p>
* </note>
*
* @return The Amazon Resource Name (ARN) of the Amazon SNS topic to which notifications are sent.</p> <note>
* <p>
* The Amazon SNS topic owner must be same as the cache cluster owner.
* </p>
*/
public String getNotificationTopicArn() {
return this.notificationTopicArn;
}
/**
* <p>
* The Amazon Resource Name (ARN) of the Amazon SNS topic to which notifications are sent.
* </p>
* <note>
* <p>
* The Amazon SNS topic owner must be same as the cache cluster owner.
* </p>
* </note>
*
* @param notificationTopicArn
* The Amazon Resource Name (ARN) of the Amazon SNS topic to which notifications are sent.</p> <note>
* <p>
* The Amazon SNS topic owner must be same as the cache cluster owner.
* </p>
* @return Returns a reference to this object so that method calls can be chained together.
*/
public ModifyCacheClusterRequest withNotificationTopicArn(String notificationTopicArn) {
setNotificationTopicArn(notificationTopicArn);
return this;
}
/**
* <p>
* The name of the cache parameter group to apply to this cache cluster. This change is asynchronously applied as
* soon as possible for parameters when the <code>ApplyImmediately</code> parameter is specified as
* <code>true</code> for this request.
* </p>
*
* @param cacheParameterGroupName
* The name of the cache parameter group to apply to this cache cluster. This change is asynchronously
* applied as soon as possible for parameters when the <code>ApplyImmediately</code> parameter is specified
* as <code>true</code> for this request.
*/
public void setCacheParameterGroupName(String cacheParameterGroupName) {
this.cacheParameterGroupName = cacheParameterGroupName;
}
/**
* <p>
* The name of the cache parameter group to apply to this cache cluster. This change is asynchronously applied as
* soon as possible for parameters when the <code>ApplyImmediately</code> parameter is specified as
* <code>true</code> for this request.
* </p>
*
* @return The name of the cache parameter group to apply to this cache cluster. This change is asynchronously
* applied as soon as possible for parameters when the <code>ApplyImmediately</code> parameter is specified
* as <code>true</code> for this request.
*/
public String getCacheParameterGroupName() {
return this.cacheParameterGroupName;
}
/**
* <p>
* The name of the cache parameter group to apply to this cache cluster. This change is asynchronously applied as
* soon as possible for parameters when the <code>ApplyImmediately</code> parameter is specified as
* <code>true</code> for this request.
* </p>
*
* @param cacheParameterGroupName
* The name of the cache parameter group to apply to this cache cluster. This change is asynchronously
* applied as soon as possible for parameters when the <code>ApplyImmediately</code> parameter is specified
* as <code>true</code> for this request.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public ModifyCacheClusterRequest withCacheParameterGroupName(String cacheParameterGroupName) {
setCacheParameterGroupName(cacheParameterGroupName);
return this;
}
/**
* <p>
* The status of the Amazon SNS notification topic. Notifications are sent only if the status is <code>active</code>
* .
* </p>
* <p>
* Valid values: <code>active</code> | <code>inactive</code>
* </p>
*
* @param notificationTopicStatus
* The status of the Amazon SNS notification topic. Notifications are sent only if the status is
* <code>active</code>.</p>
* <p>
* Valid values: <code>active</code> | <code>inactive</code>
*/
public void setNotificationTopicStatus(String notificationTopicStatus) {
this.notificationTopicStatus = notificationTopicStatus;
}
/**
* <p>
* The status of the Amazon SNS notification topic. Notifications are sent only if the status is <code>active</code>
* .
* </p>
* <p>
* Valid values: <code>active</code> | <code>inactive</code>
* </p>
*
* @return The status of the Amazon SNS notification topic. Notifications are sent only if the status is
* <code>active</code>.</p>
* <p>
* Valid values: <code>active</code> | <code>inactive</code>
*/
public String getNotificationTopicStatus() {
return this.notificationTopicStatus;
}
/**
* <p>
* The status of the Amazon SNS notification topic. Notifications are sent only if the status is <code>active</code>
* .
* </p>
* <p>
* Valid values: <code>active</code> | <code>inactive</code>
* </p>
*
* @param notificationTopicStatus
* The status of the Amazon SNS notification topic. Notifications are sent only if the status is
* <code>active</code>.</p>
* <p>
* Valid values: <code>active</code> | <code>inactive</code>
* @return Returns a reference to this object so that method calls can be chained together.
*/
public ModifyCacheClusterRequest withNotificationTopicStatus(String notificationTopicStatus) {
setNotificationTopicStatus(notificationTopicStatus);
return this;
}
/**
* <p>
* If <code>true</code>, this parameter causes the modifications in this request and any pending modifications to be
* applied, asynchronously and as soon as possible, regardless of the <code>PreferredMaintenanceWindow</code>
* setting for the cache cluster.
* </p>
* <p>
* If <code>false</code>, changes to the cache cluster are applied on the next maintenance reboot, or the next
* failure reboot, whichever occurs first.
* </p>
* <important>
* <p>
* If you perform a <code>ModifyCacheCluster</code> before a pending modification is applied, the pending
* modification is replaced by the newer modification.
* </p>
* </important>
* <p>
* Valid values: <code>true</code> | <code>false</code>
* </p>
* <p>
* Default: <code>false</code>
* </p>
*
* @param applyImmediately
* If <code>true</code>, this parameter causes the modifications in this request and any pending
* modifications to be applied, asynchronously and as soon as possible, regardless of the
* <code>PreferredMaintenanceWindow</code> setting for the cache cluster.</p>
* <p>
* If <code>false</code>, changes to the cache cluster are applied on the next maintenance reboot, or the
* next failure reboot, whichever occurs first.
* </p>
* <important>
* <p>
* If you perform a <code>ModifyCacheCluster</code> before a pending modification is applied, the pending
* modification is replaced by the newer modification.
* </p>
* </important>
* <p>
* Valid values: <code>true</code> | <code>false</code>
* </p>
* <p>
* Default: <code>false</code>
*/
public void setApplyImmediately(Boolean applyImmediately) {
this.applyImmediately = applyImmediately;
}
/**
* <p>
* If <code>true</code>, this parameter causes the modifications in this request and any pending modifications to be
* applied, asynchronously and as soon as possible, regardless of the <code>PreferredMaintenanceWindow</code>
* setting for the cache cluster.
* </p>
* <p>
* If <code>false</code>, changes to the cache cluster are applied on the next maintenance reboot, or the next
* failure reboot, whichever occurs first.
* </p>
* <important>
* <p>
* If you perform a <code>ModifyCacheCluster</code> before a pending modification is applied, the pending
* modification is replaced by the newer modification.
* </p>
* </important>
* <p>
* Valid values: <code>true</code> | <code>false</code>
* </p>
* <p>
* Default: <code>false</code>
* </p>
*
* @return If <code>true</code>, this parameter causes the modifications in this request and any pending
* modifications to be applied, asynchronously and as soon as possible, regardless of the
* <code>PreferredMaintenanceWindow</code> setting for the cache cluster.</p>
* <p>
* If <code>false</code>, changes to the cache cluster are applied on the next maintenance reboot, or the
* next failure reboot, whichever occurs first.
* </p>
* <important>
* <p>
* If you perform a <code>ModifyCacheCluster</code> before a pending modification is applied, the pending
* modification is replaced by the newer modification.
* </p>
* </important>
* <p>
* Valid values: <code>true</code> | <code>false</code>
* </p>
* <p>
* Default: <code>false</code>
*/
public Boolean getApplyImmediately() {
return this.applyImmediately;
}
/**
* <p>
* If <code>true</code>, this parameter causes the modifications in this request and any pending modifications to be
* applied, asynchronously and as soon as possible, regardless of the <code>PreferredMaintenanceWindow</code>
* setting for the cache cluster.
* </p>
* <p>
* If <code>false</code>, changes to the cache cluster are applied on the next maintenance reboot, or the next
* failure reboot, whichever occurs first.
* </p>
* <important>
* <p>
* If you perform a <code>ModifyCacheCluster</code> before a pending modification is applied, the pending
* modification is replaced by the newer modification.
* </p>
* </important>
* <p>
* Valid values: <code>true</code> | <code>false</code>
* </p>
* <p>
* Default: <code>false</code>
* </p>
*
* @param applyImmediately
* If <code>true</code>, this parameter causes the modifications in this request and any pending
* modifications to be applied, asynchronously and as soon as possible, regardless of the
* <code>PreferredMaintenanceWindow</code> setting for the cache cluster.</p>
* <p>
* If <code>false</code>, changes to the cache cluster are applied on the next maintenance reboot, or the
* next failure reboot, whichever occurs first.
* </p>
* <important>
* <p>
* If you perform a <code>ModifyCacheCluster</code> before a pending modification is applied, the pending
* modification is replaced by the newer modification.
* </p>
* </important>
* <p>
* Valid values: <code>true</code> | <code>false</code>
* </p>
* <p>
* Default: <code>false</code>
* @return Returns a reference to this object so that method calls can be chained together.
*/
public ModifyCacheClusterRequest withApplyImmediately(Boolean applyImmediately) {
setApplyImmediately(applyImmediately);
return this;
}
/**
* <p>
* If <code>true</code>, this parameter causes the modifications in this request and any pending modifications to be
* applied, asynchronously and as soon as possible, regardless of the <code>PreferredMaintenanceWindow</code>
* setting for the cache cluster.
* </p>
* <p>
* If <code>false</code>, changes to the cache cluster are applied on the next maintenance reboot, or the next
* failure reboot, whichever occurs first.
* </p>
* <important>
* <p>
* If you perform a <code>ModifyCacheCluster</code> before a pending modification is applied, the pending
* modification is replaced by the newer modification.
* </p>
* </important>
* <p>
* Valid values: <code>true</code> | <code>false</code>
* </p>
* <p>
* Default: <code>false</code>
* </p>
*
* @return If <code>true</code>, this parameter causes the modifications in this request and any pending
* modifications to be applied, asynchronously and as soon as possible, regardless of the
* <code>PreferredMaintenanceWindow</code> setting for the cache cluster.</p>
* <p>
* If <code>false</code>, changes to the cache cluster are applied on the next maintenance reboot, or the
* next failure reboot, whichever occurs first.
* </p>
* <important>
* <p>
* If you perform a <code>ModifyCacheCluster</code> before a pending modification is applied, the pending
* modification is replaced by the newer modification.
* </p>
* </important>
* <p>
* Valid values: <code>true</code> | <code>false</code>
* </p>
* <p>
* Default: <code>false</code>
*/
public Boolean isApplyImmediately() {
return this.applyImmediately;
}
/**
* <p>
* The upgraded version of the cache engine to be run on the cache nodes.
* </p>
* <p>
* <b>Important:</b> You can upgrade to a newer engine version (see <a
* href="http://docs.aws.amazon.com/AmazonElastiCache/latest/UserGuide/SelectEngine.html#VersionManagement"
* >Selecting a Cache Engine and Version</a>), 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 and create it anew with the earlier
* engine version.
* </p>
*
* @param engineVersion
* The upgraded version of the cache engine to be run on the cache nodes.</p>
* <p>
* <b>Important:</b> You can upgrade to a newer engine version (see <a
* href="http://docs.aws.amazon.com/AmazonElastiCache/latest/UserGuide/SelectEngine.html#VersionManagement"
* >Selecting a Cache Engine and Version</a>), 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 and create it anew with
* the earlier engine version.
*/
public void setEngineVersion(String engineVersion) {
this.engineVersion = engineVersion;
}
/**
* <p>
* The upgraded version of the cache engine to be run on the cache nodes.
* </p>
* <p>
* <b>Important:</b> You can upgrade to a newer engine version (see <a
* href="http://docs.aws.amazon.com/AmazonElastiCache/latest/UserGuide/SelectEngine.html#VersionManagement"
* >Selecting a Cache Engine and Version</a>), 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 and create it anew with the earlier
* engine version.
* </p>
*
* @return The upgraded version of the cache engine to be run on the cache nodes.</p>
* <p>
* <b>Important:</b> You can upgrade to a newer engine version (see <a href=
* "http://docs.aws.amazon.com/AmazonElastiCache/latest/UserGuide/SelectEngine.html#VersionManagement"
* >Selecting a Cache Engine and Version</a>), 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 and create it anew with
* the earlier engine version.
*/
public String getEngineVersion() {
return this.engineVersion;
}
/**
* <p>
* The upgraded version of the cache engine to be run on the cache nodes.
* </p>
* <p>
* <b>Important:</b> You can upgrade to a newer engine version (see <a
* href="http://docs.aws.amazon.com/AmazonElastiCache/latest/UserGuide/SelectEngine.html#VersionManagement"
* >Selecting a Cache Engine and Version</a>), 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 and create it anew with the earlier
* engine version.
* </p>
*
* @param engineVersion
* The upgraded version of the cache engine to be run on the cache nodes.</p>
* <p>
* <b>Important:</b> You can upgrade to a newer engine version (see <a
* href="http://docs.aws.amazon.com/AmazonElastiCache/latest/UserGuide/SelectEngine.html#VersionManagement"
* >Selecting a Cache Engine and Version</a>), 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 and create it anew with
* the earlier engine version.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public ModifyCacheClusterRequest withEngineVersion(String engineVersion) {
setEngineVersion(engineVersion);
return this;
}
/**
* <p>
* This parameter is currently disabled.
* </p>
*
* @param autoMinorVersionUpgrade
* This parameter is currently disabled.
*/
public void setAutoMinorVersionUpgrade(Boolean autoMinorVersionUpgrade) {
this.autoMinorVersionUpgrade = autoMinorVersionUpgrade;
}
/**
* <p>
* This parameter is currently disabled.
* </p>
*
* @return This parameter is currently disabled.
*/
public Boolean getAutoMinorVersionUpgrade() {
return this.autoMinorVersionUpgrade;
}
/**
* <p>
* This parameter is currently disabled.
* </p>
*
* @param autoMinorVersionUpgrade
* This parameter is currently disabled.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public ModifyCacheClusterRequest withAutoMinorVersionUpgrade(Boolean autoMinorVersionUpgrade) {
setAutoMinorVersionUpgrade(autoMinorVersionUpgrade);
return this;
}
/**
* <p>
* This parameter is currently disabled.
* </p>
*
* @return This parameter is currently disabled.
*/
public Boolean isAutoMinorVersionUpgrade() {
return this.autoMinorVersionUpgrade;
}
/**
* <p>
* The number of days for which ElastiCache retains automatic cache cluster snapshots before deleting them. For
* example, if you set <code>SnapshotRetentionLimit</code> to 5, a snapshot that was taken today is retained for 5
* days before being deleted.
* </p>
* <note>
* <p>
* If the value of <code>SnapshotRetentionLimit</code> is set to zero (0), backups are turned off.
* </p>
* </note>
*
* @param snapshotRetentionLimit
* The number of days for which ElastiCache retains automatic cache cluster snapshots before deleting them.
* For example, if you set <code>SnapshotRetentionLimit</code> to 5, a snapshot that was taken today is
* retained for 5 days before being deleted.</p> <note>
* <p>
* If the value of <code>SnapshotRetentionLimit</code> is set to zero (0), backups are turned off.
* </p>
*/
public void setSnapshotRetentionLimit(Integer snapshotRetentionLimit) {
this.snapshotRetentionLimit = snapshotRetentionLimit;
}
/**
* <p>
* The number of days for which ElastiCache retains automatic cache cluster snapshots before deleting them. For
* example, if you set <code>SnapshotRetentionLimit</code> to 5, a snapshot that was taken today is retained for 5
* days before being deleted.
* </p>
* <note>
* <p>
* If the value of <code>SnapshotRetentionLimit</code> is set to zero (0), backups are turned off.
* </p>
* </note>
*
* @return The number of days for which ElastiCache retains automatic cache cluster snapshots before deleting them.
* For example, if you set <code>SnapshotRetentionLimit</code> to 5, a snapshot that was taken today is
* retained for 5 days before being deleted.</p> <note>
* <p>
* If the value of <code>SnapshotRetentionLimit</code> is set to zero (0), backups are turned off.
* </p>
*/
public Integer getSnapshotRetentionLimit() {
return this.snapshotRetentionLimit;
}
/**
* <p>
* The number of days for which ElastiCache retains automatic cache cluster snapshots before deleting them. For
* example, if you set <code>SnapshotRetentionLimit</code> to 5, a snapshot that was taken today is retained for 5
* days before being deleted.
* </p>
* <note>
* <p>
* If the value of <code>SnapshotRetentionLimit</code> is set to zero (0), backups are turned off.
* </p>
* </note>
*
* @param snapshotRetentionLimit
* The number of days for which ElastiCache retains automatic cache cluster snapshots before deleting them.
* For example, if you set <code>SnapshotRetentionLimit</code> to 5, a snapshot that was taken today is
* retained for 5 days before being deleted.</p> <note>
* <p>
* If the value of <code>SnapshotRetentionLimit</code> is set to zero (0), backups are turned off.
* </p>
* @return Returns a reference to this object so that method calls can be chained together.
*/
public ModifyCacheClusterRequest withSnapshotRetentionLimit(Integer snapshotRetentionLimit) {
setSnapshotRetentionLimit(snapshotRetentionLimit);
return this;
}
/**
* <p>
* The daily time range (in UTC) during which ElastiCache begins taking a daily snapshot of your cache cluster.
* </p>
*
* @param snapshotWindow
* The daily time range (in UTC) during which ElastiCache begins taking a daily snapshot of your cache
* cluster.
*/
public void setSnapshotWindow(String snapshotWindow) {
this.snapshotWindow = snapshotWindow;
}
/**
* <p>
* The daily time range (in UTC) during which ElastiCache begins taking a daily snapshot of your cache cluster.
* </p>
*
* @return The daily time range (in UTC) during which ElastiCache begins taking a daily snapshot of your cache
* cluster.
*/
public String getSnapshotWindow() {
return this.snapshotWindow;
}
/**
* <p>
* The daily time range (in UTC) during which ElastiCache begins taking a daily snapshot of your cache cluster.
* </p>
*
* @param snapshotWindow
* The daily time range (in UTC) during which ElastiCache begins taking a daily snapshot of your cache
* cluster.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public ModifyCacheClusterRequest withSnapshotWindow(String snapshotWindow) {
setSnapshotWindow(snapshotWindow);
return this;
}
/**
* <p>
* A valid cache node type that you want to scale this cache cluster up to.
* </p>
*
* @param cacheNodeType
* A valid cache node type that you want to scale this cache cluster up to.
*/
public void setCacheNodeType(String cacheNodeType) {
this.cacheNodeType = cacheNodeType;
}
/**
* <p>
* A valid cache node type that you want to scale this cache cluster up to.
* </p>
*
* @return A valid cache node type that you want to scale this cache cluster up to.
*/
public String getCacheNodeType() {
return this.cacheNodeType;
}
/**
* <p>
* A valid cache node type that you want to scale this cache cluster up to.
* </p>
*
* @param cacheNodeType
* A valid cache node type that you want to scale this cache cluster up to.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public ModifyCacheClusterRequest withCacheNodeType(String cacheNodeType) {
setCacheNodeType(cacheNodeType);
return this;
}
/**
* Returns a string representation of this object; useful for testing and debugging.
*
* @return A string representation of this object.
*
* @see java.lang.Object#toString()
*/
@Override
public String toString() {
StringBuilder sb = new StringBuilder();
sb.append("{");
if (getCacheClusterId() != null)
sb.append("CacheClusterId: ").append(getCacheClusterId()).append(",");
if (getNumCacheNodes() != null)
sb.append("NumCacheNodes: ").append(getNumCacheNodes()).append(",");
if (getCacheNodeIdsToRemove() != null)
sb.append("CacheNodeIdsToRemove: ").append(getCacheNodeIdsToRemove()).append(",");
if (getAZMode() != null)
sb.append("AZMode: ").append(getAZMode()).append(",");
if (getNewAvailabilityZones() != null)
sb.append("NewAvailabilityZones: ").append(getNewAvailabilityZones()).append(",");
if (getCacheSecurityGroupNames() != null)
sb.append("CacheSecurityGroupNames: ").append(getCacheSecurityGroupNames()).append(",");
if (getSecurityGroupIds() != null)
sb.append("SecurityGroupIds: ").append(getSecurityGroupIds()).append(",");
if (getPreferredMaintenanceWindow() != null)
sb.append("PreferredMaintenanceWindow: ").append(getPreferredMaintenanceWindow()).append(",");
if (getNotificationTopicArn() != null)
sb.append("NotificationTopicArn: ").append(getNotificationTopicArn()).append(",");
if (getCacheParameterGroupName() != null)
sb.append("CacheParameterGroupName: ").append(getCacheParameterGroupName()).append(",");
if (getNotificationTopicStatus() != null)
sb.append("NotificationTopicStatus: ").append(getNotificationTopicStatus()).append(",");
if (getApplyImmediately() != null)
sb.append("ApplyImmediately: ").append(getApplyImmediately()).append(",");
if (getEngineVersion() != null)
sb.append("EngineVersion: ").append(getEngineVersion()).append(",");
if (getAutoMinorVersionUpgrade() != null)
sb.append("AutoMinorVersionUpgrade: ").append(getAutoMinorVersionUpgrade()).append(",");
if (getSnapshotRetentionLimit() != null)
sb.append("SnapshotRetentionLimit: ").append(getSnapshotRetentionLimit()).append(",");
if (getSnapshotWindow() != null)
sb.append("SnapshotWindow: ").append(getSnapshotWindow()).append(",");
if (getCacheNodeType() != null)
sb.append("CacheNodeType: ").append(getCacheNodeType());
sb.append("}");
return sb.toString();
}
@Override
public boolean equals(Object obj) {
if (this == obj)
return true;
if (obj == null)
return false;
if (obj instanceof ModifyCacheClusterRequest == false)
return false;
ModifyCacheClusterRequest other = (ModifyCacheClusterRequest) obj;
if (other.getCacheClusterId() == null ^ this.getCacheClusterId() == null)
return false;
if (other.getCacheClusterId() != null && other.getCacheClusterId().equals(this.getCacheClusterId()) == false)
return false;
if (other.getNumCacheNodes() == null ^ this.getNumCacheNodes() == null)
return false;
if (other.getNumCacheNodes() != null && other.getNumCacheNodes().equals(this.getNumCacheNodes()) == false)
return false;
if (other.getCacheNodeIdsToRemove() == null ^ this.getCacheNodeIdsToRemove() == null)
return false;
if (other.getCacheNodeIdsToRemove() != null && other.getCacheNodeIdsToRemove().equals(this.getCacheNodeIdsToRemove()) == false)
return false;
if (other.getAZMode() == null ^ this.getAZMode() == null)
return false;
if (other.getAZMode() != null && other.getAZMode().equals(this.getAZMode()) == false)
return false;
if (other.getNewAvailabilityZones() == null ^ this.getNewAvailabilityZones() == null)
return false;
if (other.getNewAvailabilityZones() != null && other.getNewAvailabilityZones().equals(this.getNewAvailabilityZones()) == false)
return false;
if (other.getCacheSecurityGroupNames() == null ^ this.getCacheSecurityGroupNames() == null)
return false;
if (other.getCacheSecurityGroupNames() != null && other.getCacheSecurityGroupNames().equals(this.getCacheSecurityGroupNames()) == false)
return false;
if (other.getSecurityGroupIds() == null ^ this.getSecurityGroupIds() == null)
return false;
if (other.getSecurityGroupIds() != null && other.getSecurityGroupIds().equals(this.getSecurityGroupIds()) == false)
return false;
if (other.getPreferredMaintenanceWindow() == null ^ this.getPreferredMaintenanceWindow() == null)
return false;
if (other.getPreferredMaintenanceWindow() != null && other.getPreferredMaintenanceWindow().equals(this.getPreferredMaintenanceWindow()) == false)
return false;
if (other.getNotificationTopicArn() == null ^ this.getNotificationTopicArn() == null)
return false;
if (other.getNotificationTopicArn() != null && other.getNotificationTopicArn().equals(this.getNotificationTopicArn()) == false)
return false;
if (other.getCacheParameterGroupName() == null ^ this.getCacheParameterGroupName() == null)
return false;
if (other.getCacheParameterGroupName() != null && other.getCacheParameterGroupName().equals(this.getCacheParameterGroupName()) == false)
return false;
if (other.getNotificationTopicStatus() == null ^ this.getNotificationTopicStatus() == null)
return false;
if (other.getNotificationTopicStatus() != null && other.getNotificationTopicStatus().equals(this.getNotificationTopicStatus()) == false)
return false;
if (other.getApplyImmediately() == null ^ this.getApplyImmediately() == null)
return false;
if (other.getApplyImmediately() != null && other.getApplyImmediately().equals(this.getApplyImmediately()) == false)
return false;
if (other.getEngineVersion() == null ^ this.getEngineVersion() == null)
return false;
if (other.getEngineVersion() != null && other.getEngineVersion().equals(this.getEngineVersion()) == false)
return false;
if (other.getAutoMinorVersionUpgrade() == null ^ this.getAutoMinorVersionUpgrade() == null)
return false;
if (other.getAutoMinorVersionUpgrade() != null && other.getAutoMinorVersionUpgrade().equals(this.getAutoMinorVersionUpgrade()) == false)
return false;
if (other.getSnapshotRetentionLimit() == null ^ this.getSnapshotRetentionLimit() == null)
return false;
if (other.getSnapshotRetentionLimit() != null && other.getSnapshotRetentionLimit().equals(this.getSnapshotRetentionLimit()) == false)
return false;
if (other.getSnapshotWindow() == null ^ this.getSnapshotWindow() == null)
return false;
if (other.getSnapshotWindow() != null && other.getSnapshotWindow().equals(this.getSnapshotWindow()) == false)
return false;
if (other.getCacheNodeType() == null ^ this.getCacheNodeType() == null)
return false;
if (other.getCacheNodeType() != null && other.getCacheNodeType().equals(this.getCacheNodeType()) == false)
return false;
return true;
}
@Override
public int hashCode() {
final int prime = 31;
int hashCode = 1;
hashCode = prime * hashCode + ((getCacheClusterId() == null) ? 0 : getCacheClusterId().hashCode());
hashCode = prime * hashCode + ((getNumCacheNodes() == null) ? 0 : getNumCacheNodes().hashCode());
hashCode = prime * hashCode + ((getCacheNodeIdsToRemove() == null) ? 0 : getCacheNodeIdsToRemove().hashCode());
hashCode = prime * hashCode + ((getAZMode() == null) ? 0 : getAZMode().hashCode());
hashCode = prime * hashCode + ((getNewAvailabilityZones() == null) ? 0 : getNewAvailabilityZones().hashCode());
hashCode = prime * hashCode + ((getCacheSecurityGroupNames() == null) ? 0 : getCacheSecurityGroupNames().hashCode());
hashCode = prime * hashCode + ((getSecurityGroupIds() == null) ? 0 : getSecurityGroupIds().hashCode());
hashCode = prime * hashCode + ((getPreferredMaintenanceWindow() == null) ? 0 : getPreferredMaintenanceWindow().hashCode());
hashCode = prime * hashCode + ((getNotificationTopicArn() == null) ? 0 : getNotificationTopicArn().hashCode());
hashCode = prime * hashCode + ((getCacheParameterGroupName() == null) ? 0 : getCacheParameterGroupName().hashCode());
hashCode = prime * hashCode + ((getNotificationTopicStatus() == null) ? 0 : getNotificationTopicStatus().hashCode());
hashCode = prime * hashCode + ((getApplyImmediately() == null) ? 0 : getApplyImmediately().hashCode());
hashCode = prime * hashCode + ((getEngineVersion() == null) ? 0 : getEngineVersion().hashCode());
hashCode = prime * hashCode + ((getAutoMinorVersionUpgrade() == null) ? 0 : getAutoMinorVersionUpgrade().hashCode());
hashCode = prime * hashCode + ((getSnapshotRetentionLimit() == null) ? 0 : getSnapshotRetentionLimit().hashCode());
hashCode = prime * hashCode + ((getSnapshotWindow() == null) ? 0 : getSnapshotWindow().hashCode());
hashCode = prime * hashCode + ((getCacheNodeType() == null) ? 0 : getCacheNodeType().hashCode());
return hashCode;
}
@Override
public ModifyCacheClusterRequest clone() {
return (ModifyCacheClusterRequest) super.clone();
}
}