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.

Creates a cluster. All nodes in the cluster run the same protocol-compliant cache engine software, either Memcached or Redis.

This operation is not supported for Redis (cluster mode enabled) clusters.

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 BeginCreateCacheCluster and EndCreateCacheCluster.

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

Syntax

C#
public virtual Task<CreateCacheClusterResponse> CreateCacheClusterAsync(
         CreateCacheClusterRequest request,
         CancellationToken cancellationToken
)

Parameters

request
Type: Amazon.ElastiCache.Model.CreateCacheClusterRequest

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

Exceptions

ExceptionCondition
CacheClusterAlreadyExistsException You already have a cluster with the given identifier.
CacheParameterGroupNotFoundException The requested cache parameter group name does not refer to an existing cache parameter group.
CacheSecurityGroupNotFoundException The requested cache security group name does not refer to an existing cache security group.
CacheSubnetGroupNotFoundException The requested cache subnet group name does not refer to an existing cache subnet group.
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.
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.
NodeQuotaForClusterExceededException The request cannot be processed because it would exceed the allowed number of cache nodes in a single cluster.
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.
TagQuotaPerResourceExceededException The request cannot be processed because it would cause the resource to have more than the allowed number of tags. The maximum number of tags permitted on a resource is 50.

Version Information

.NET Core App:
Supported in: 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.5

See Also