AWS SDK Version 3 for .NET
API Reference

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

Dynamically decreases the number of replicas in a Redis (cluster mode disabled) replication group or the number of replica nodes in one or more node groups (shards) of a Redis (cluster mode enabled) replication group. This operation is performed with no cluster down time.

Note:

This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginDecreaseReplicaCount and EndDecreaseReplicaCount.

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

Syntax

C#
public abstract Task<DecreaseReplicaCountResponse> DecreaseReplicaCountAsync(
         DecreaseReplicaCountRequest request,
         CancellationToken cancellationToken
)

Parameters

request
Type: Amazon.ElastiCache.Model.DecreaseReplicaCountRequest

Container for the necessary parameters to execute the DecreaseReplicaCount service method.

cancellationToken
Type: System.Threading.CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Return Value


The response from the DecreaseReplicaCount service method, as returned by ElastiCache.

Exceptions

ExceptionCondition
ClusterQuotaForCustomerExceededException The request cannot be processed because it would exceed the allowed number of clusters per customer.
InsufficientCacheClusterCapacityException The requested cache node type is not available in the specified Availability Zone. For more information, see InsufficientCacheClusterCapacity in the ElastiCache User Guide.
InvalidCacheClusterStateException The requested cluster is not in the available state.
InvalidParameterCombinationException Two or more incompatible parameters were specified.
InvalidParameterValueException The value for a parameter is invalid.
InvalidReplicationGroupStateException The requested replication group is not in the available state.
InvalidVPCNetworkStateException The VPC network is in an invalid state.
NodeGroupsPerReplicationGroupQuotaExceededException The request cannot be processed because it would exceed the maximum allowed number of node groups (shards) in a single replication group. The default maximum is 90
NodeQuotaForCustomerExceededException The request cannot be processed because it would exceed the allowed number of cache nodes per customer.
NoOperationException The operation was not performed because no changes were required.
ReplicationGroupNotFoundException The specified replication group does not exist.
ServiceLinkedRoleNotFoundException The specified service linked role (SLR) was not found.

Version Information

.NET:
Supported in: 8.0 and newer, Core 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.5 and newer

See Also