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.
For .NET Core this operation is only available in asynchronous form. Please refer to CreateCacheClusterAsync.
Namespace: Amazon.ElastiCache
Assembly: AWSSDK.ElastiCache.dll
Version: 3.x.y.z
public abstract CreateCacheClusterResponse CreateCacheCluster( CreateCacheClusterRequest request )
Container for the necessary parameters to execute the CreateCacheCluster service method.
| Exception | Condition |
|---|---|
| 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. |
Creates a Memcached cluster with 2 nodes.
var client = new AmazonElastiCacheClient();
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.
var client = new AmazonElastiCacheClient();
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;
.NET Framework:
Supported in: 4.5, 4.0, 3.5