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 Amazon Aurora DB cluster or Multi-AZ DB cluster.

If you create an Aurora DB cluster, the request creates an empty cluster. You must explicitly create the writer instance for your DB cluster using the CreateDBInstance operation. If you create a Multi-AZ DB cluster, the request creates a writer and two reader DB instances for you, each in a different Availability Zone.

You can use the ReplicationSourceIdentifier parameter to create an Amazon Aurora DB cluster as a read replica of another DB cluster or Amazon RDS for MySQL or PostgreSQL DB instance. For more information about Amazon Aurora, see What is Amazon Aurora? in the Amazon Aurora User Guide.

You can also use the ReplicationSourceIdentifier parameter to create a Multi-AZ DB cluster read replica with an RDS for MySQL or PostgreSQL DB instance as the source. For more information about Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.

Note:

For .NET Core this operation is only available in asynchronous form. Please refer to CreateDBClusterAsync.

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

Syntax

C#
public virtual CreateDBClusterResponse CreateDBCluster(
         CreateDBClusterRequest request
)

Parameters

request
Type: Amazon.RDS.Model.CreateDBClusterRequest

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

Return Value


The response from the CreateDBCluster service method, as returned by RDS.

Exceptions

ExceptionCondition
DBClusterAlreadyExistsException The user already has a DB cluster with the given identifier.
DBClusterNotFoundException DBClusterIdentifier doesn't refer to an existing DB cluster.
DBClusterParameterGroupNotFoundException DBClusterParameterGroupName doesn't refer to an existing DB cluster parameter group.
DBClusterQuotaExceededException The user attempted to create a new DB cluster and the user has already reached the maximum allowed DB cluster quota.
DBInstanceNotFoundException DBInstanceIdentifier doesn't refer to an existing DB instance.
DBSubnetGroupDoesNotCoverEnoughAZsException Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.
DBSubnetGroupNotFoundException DBSubnetGroupName doesn't refer to an existing DB subnet group.
DomainNotFoundException Domain doesn't refer to an existing Active Directory domain.
GlobalClusterNotFoundException The GlobalClusterIdentifier doesn't refer to an existing global database cluster.
InsufficientDBInstanceCapacityException The specified DB instance class isn't available in the specified Availability Zone.
InsufficientStorageClusterCapacityException There is insufficient storage available for the current action. You might be able to resolve this error by updating your subnet group to use different Availability Zones that have more storage available.
InvalidDBClusterStateException The requested operation can't be performed while the cluster is in this state.
InvalidDBInstanceStateException The DB instance isn't in a valid state.
InvalidDBSubnetGroupException The DBSubnetGroup doesn't belong to the same VPC as that of an existing cross-region read replica of the same source instance.
InvalidDBSubnetGroupStateException The DB subnet group cannot be deleted because it's in use.
InvalidGlobalClusterStateException The global cluster is in an invalid state and can't perform the requested operation.
InvalidSubnetException The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.
InvalidVPCNetworkStateException The DB subnet group doesn't cover all Availability Zones after it's created because of users' change.
KMSKeyNotAccessibleException An error occurred accessing an Amazon Web Services KMS key.
OptionGroupNotFoundException The specified option group could not be found.
StorageQuotaExceededException The request would result in the user exceeding the allowed amount of storage available across all DB instances.

Version Information

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

See Also