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 DB instance.
The new DB instance can be an RDS DB instance, or it can be a DB instance in an Aurora DB cluster. For an Aurora DB cluster, you can call this operation multiple times to add more than one DB instance to the cluster.
For more information about creating an RDS DB instance, see Creating an Amazon RDS DB instance in the Amazon RDS User Guide.
For more information about creating a DB instance in an Aurora DB cluster, see Creating an Amazon Aurora DB cluster in the Amazon Aurora User Guide.
For .NET Core this operation is only available in asynchronous form. Please refer to CreateDBInstanceAsync.
Namespace: Amazon.RDS
Assembly: AWSSDK.RDS.dll
Version: 3.x.y.z
public abstract CreateDBInstanceResponse CreateDBInstance( CreateDBInstanceRequest request )
Container for the necessary parameters to execute the CreateDBInstance service method.
| Exception | Condition |
|---|---|
| AuthorizationNotFoundException | The specified CIDR IP range or Amazon EC2 security group might not be authorized for the specified DB security group. Or, RDS might not be authorized to perform necessary actions using IAM on your behalf. |
| BackupPolicyNotFoundException | |
| CertificateNotFoundException | CertificateIdentifier doesn't refer to an existing certificate. |
| DBClusterNotFoundException | DBClusterIdentifier doesn't refer to an existing DB cluster. |
| DBInstanceAlreadyExistsException | The user already has a DB instance with the given identifier. |
| DBParameterGroupNotFoundException | DBParameterGroupName doesn't refer to an existing DB parameter group. |
| DBSecurityGroupNotFoundException | DBSecurityGroupName doesn't refer to an existing DB security group. |
| 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. |
| InstanceQuotaExceededException | The request would result in the user exceeding the allowed number of DB instances. |
| InsufficientDBInstanceCapacityException | The specified DB instance class isn't available in the specified Availability Zone. |
| InvalidDBClusterStateException | The requested operation can't be performed while the cluster is in this state. |
| 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. |
| NetworkTypeNotSupportedException | The network type is invalid for the DB instance. Valid nework type values are IPV4 and DUAL. |
| OptionGroupNotFoundException | The specified option group could not be found. |
| ProvisionedIopsNotAvailableInAZException | Provisioned IOPS not available in the specified Availability Zone. |
| StorageQuotaExceededException | The request would result in the user exceeding the allowed amount of storage available across all DB instances. |
| StorageTypeNotSupportedException | The specified StorageType can't be associated with the DB instance. |
| TenantDatabaseQuotaExceededException | You attempted to create more tenant databases than are permitted in your Amazon Web Services account. |
.NET Framework:
Supported in: 4.5, 4.0, 3.5