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 cache cluster. All nodes in the cache cluster run the same protocol-compliant cache engine software, either Memcached or Redis.

Due to current limitations on Redis (cluster mode disabled), this operation or parameter is not supported on Redis (cluster mode enabled) replication groups.

Note:

For PCL this operation is only available in asynchronous form. Please refer to CreateCacheClusterAsync.

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

Syntax

C#
public abstract CreateCacheClusterResponse CreateCacheCluster(
         CreateCacheClusterRequest request
)
Parameters
request
Type: Amazon.ElastiCache.Model.CreateCacheClusterRequest

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

Return Value
The response from the CreateCacheCluster service method, as returned by ElastiCache.

Exceptions

ExceptionCondition
CacheClusterAlreadyExistsException You already have a cache 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 cache clusters per customer.
InsufficientCacheClusterCapacityException The requested cache node type is not available in the specified Availability Zone.
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 cache 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.

Examples

Creates a Memcached cluster with 2 nodes.

CreateCacheCluster


var response = client.CreateCacheCluster(new CreateCacheClusterRequest 
{
    AZMode = "cross-az",
    CacheClusterId = "my-memcached-cluster",
    CacheNodeType = "cache.r3.large",
    CacheSubnetGroupName = "default",
    Engine = "memcached",
    EngineVersion = "1.4.24",
    NumCacheNodes = 2,
    Port = 11211
});

CacheCluster cacheCluster = response.CacheCluster;

            

Creates a Redis cluster with 1 node.

CreateCacheCluster


var response = client.CreateCacheCluster(new CreateCacheClusterRequest 
{
    AZMode = "cross-az",
    CacheClusterId = "my-memcached-cluster",
    CacheNodeType = "cache.r3.large",
    CacheSubnetGroupName = "default",
    Engine = "memcached",
    EngineVersion = "1.4.24",
    NumCacheNodes = 2,
    Port = 11211
});

CacheCluster cacheCluster = response.CacheCluster;

            

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

Portable Class Library:
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms

See Also