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.
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
public virtual CreateDBClusterResponse CreateDBCluster( CreateDBClusterRequest request )
Container for the necessary parameters to execute the CreateDBCluster service method.
Exception | Condition |
---|---|
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. |
.NET Framework:
Supported in: 4.5, 4.0, 3.5