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 new cluster.

To create the cluster in Virtual Private Cloud (VPC), you must provide a cluster subnet group name. The cluster subnet group identifies the subnets of your VPC that Amazon Redshift uses when creating the cluster. For more information about managing clusters, go to Amazon Redshift Clusters in the Amazon Redshift Cluster Management Guide.

Note:

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

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

Syntax

C#
public virtual CreateClusterResponse CreateCluster(
         CreateClusterRequest request
)
Parameters
request
Type: Amazon.Redshift.Model.CreateClusterRequest

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

Return Value
The response from the CreateCluster service method, as returned by Redshift.

Exceptions

ExceptionCondition
ClusterAlreadyExistsException The account already has a cluster with the given identifier.
ClusterParameterGroupNotFoundException The parameter group name does not refer to an existing parameter group.
ClusterQuotaExceededException The request would exceed the allowed number of cluster instances for this account. For information about increasing your quota, go to Limits in Amazon Redshift in the Amazon Redshift Cluster Management Guide.
ClusterSecurityGroupNotFoundException The cluster security group name does not refer to an existing cluster security group.
ClusterSubnetGroupNotFoundException The cluster subnet group name does not refer to an existing cluster subnet group.
DependentServiceRequestThrottlingException The request cannot be completed because a dependent service is throttling requests made by Amazon Redshift on your behalf. Wait and retry the request.
HsmClientCertificateNotFoundException There is no Amazon Redshift HSM client certificate with the specified identifier.
HsmConfigurationNotFoundException There is no Amazon Redshift HSM configuration with the specified identifier.
InsufficientClusterCapacityException The number of nodes specified exceeds the allotted capacity of the cluster.
InvalidClusterSubnetGroupStateException The cluster subnet group cannot be deleted because it is in use.
InvalidElasticIpException The Elastic IP (EIP) is invalid or cannot be found.
InvalidSubnetException The requested subnet is not valid, or not all of the subnets are in the same VPC.
InvalidTagException The tag is invalid.
InvalidVPCNetworkStateException The cluster subnet group does not cover all Availability Zones.
LimitExceededException The encryption key has exceeded its grant limit in AWS KMS.
NumberOfNodesPerClusterLimitExceededException The operation would exceed the number of nodes allowed for a cluster.
NumberOfNodesQuotaExceededException The operation would exceed the number of nodes allotted to the account. For information about increasing your quota, go to Limits in Amazon Redshift in the Amazon Redshift Cluster Management Guide.
TagLimitExceededException The request exceeds the limit of 10 tags for the resource.
UnauthorizedOperationException Your account is not authorized to perform the requested operation.

Examples

This example creates a cluster with the minimal set of parameters. By default, the output is in JSON format.

To create a cluster with minimal parameters


var response = client.CreateCluster(new CreateClusterRequest 
{
    ClusterIdentifier = "mycluster",
    MasterUserPassword = "TopSecret1",
    MasterUsername = "adminuser ",
    NodeType = "dw.hs1.xlarge"
});


            

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