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.

Modifies a replication group's shards (node groups) by allowing you to add shards, remove shards, or rebalance the keyspaces among existing shards.

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 BeginModifyReplicationGroupShardConfiguration and EndModifyReplicationGroupShardConfiguration.

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

Syntax

C#
public abstract Task<ModifyReplicationGroupShardConfigurationResponse> ModifyReplicationGroupShardConfigurationAsync(
         ModifyReplicationGroupShardConfigurationRequest request,
         CancellationToken cancellationToken
)

Parameters

request
Type: Amazon.ElastiCache.Model.ModifyReplicationGroupShardConfigurationRequest

Container for the necessary parameters to execute the ModifyReplicationGroupShardConfiguration 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 ModifyReplicationGroupShardConfiguration service method, as returned by ElastiCache.

Exceptions

ExceptionCondition
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.
InvalidKMSKeyException The KMS key supplied is not valid.
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.
ReplicationGroupNotFoundException The specified replication group does not exist.

Version Information

.NET Core App:
Supported in: 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.5

See Also