---
title: "GET /#Action=CreateDBInstance"
method: GET
path: "/#Action=CreateDBInstance"
---

# GET /#Action=CreateDBInstance

`GET /#Action=CreateDBInstance`

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](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.html) 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](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.CreateInstance.html) in the _Amazon Aurora User Guide_.

## Query parameters

- `DBName` string
- `DBInstanceIdentifier` string, required
- `AllocatedStorage` integer
- `DBInstanceClass` string, required
- `Engine` string, required
- `MasterUsername` string
- `MasterUserPassword` string
- `DBSecurityGroups` string[]
- `VpcSecurityGroupIds` string[]
- `AvailabilityZone` string
- `DBSubnetGroupName` string
- `PreferredMaintenanceWindow` string
- `DBParameterGroupName` string
- `BackupRetentionPeriod` integer
- `PreferredBackupWindow` string
- `Port` integer
- `MultiAZ` boolean
- `EngineVersion` string
- `AutoMinorVersionUpgrade` boolean
- `LicenseModel` string
- `Iops` integer
- `OptionGroupName` string
- `CharacterSetName` string
- `NcharCharacterSetName` string
- `PubliclyAccessible` boolean
- `Tags` object[] — A list of tags. For more information, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html">Tagging Amazon RDS Resources</a> in the <i>Amazon RDS User Guide.</i>
  - `Key` string — A key is the required name of the tag. The string value can be from 1 to 128 Unicode characters in length and can't be prefixed with <code>aws:</code> or <code>rds:</code>. The string can only contain only the set of Unicode letters, digits, white-space, '_', '.', ':', '/', '=', '+', '-', '@' (Java regex: "^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$").
  - `Value` string — A value is the optional value of the tag. The string value can be from 1 to 256 Unicode characters in length and can't be prefixed with <code>aws:</code> or <code>rds:</code>. The string can only contain only the set of Unicode letters, digits, white-space, '_', '.', ':', '/', '=', '+', '-', '@' (Java regex: "^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$").
- `DBClusterIdentifier` string
- `StorageType` string
- `TdeCredentialArn` string
- `TdeCredentialPassword` string
- `StorageEncrypted` boolean
- `KmsKeyId` string
- `Domain` string
- `CopyTagsToSnapshot` boolean
- `MonitoringInterval` integer
- `MonitoringRoleArn` string
- `DomainIAMRoleName` string
- `PromotionTier` integer
- `Timezone` string
- `EnableIAMDatabaseAuthentication` boolean
- `EnablePerformanceInsights` boolean
- `PerformanceInsightsKMSKeyId` string
- `PerformanceInsightsRetentionPeriod` integer
- `EnableCloudwatchLogsExports` String[]
- `ProcessorFeatures` object[]
  - `Name` string — The name of the processor feature. Valid names are <code>coreCount</code> and <code>threadsPerCore</code>.
  - `Value` string — The value of a processor feature name.
- `DeletionProtection` boolean
- `MaxAllocatedStorage` integer
- `EnableCustomerOwnedIp` boolean
- `CustomIamInstanceProfile` string
- `BackupTarget` string
- `NetworkType` string
- `StorageThroughput` integer
- `ManageMasterUserPassword` boolean
- `MasterUserSecretKmsKeyId` string
- `CACertificateIdentifier` string
- `Action` 'CreateDBInstance', required
- `Version` '2014-10-31', required

## Response `200`

Success

## Other responses

- `480` — DBInstanceAlreadyExistsFault
- `481` — InsufficientDBInstanceCapacityFault
- `482` — DBParameterGroupNotFoundFault
- `483` — DBSecurityGroupNotFoundFault
- `484` — InstanceQuotaExceededFault
- `485` — StorageQuotaExceededFault
- `486` — DBSubnetGroupNotFoundFault
- `487` — DBSubnetGroupDoesNotCoverEnoughAZs
- `488` — InvalidDBClusterStateFault
- `489` — InvalidSubnet
- `490` — InvalidVPCNetworkStateFault
- `491` — ProvisionedIopsNotAvailableInAZFault
- `492` — OptionGroupNotFoundFault
- `493` — DBClusterNotFoundFault
- `494` — StorageTypeNotSupportedFault
- `495` — AuthorizationNotFoundFault
- `496` — KMSKeyNotAccessibleFault
- `497` — DomainNotFoundFault
- `498` — BackupPolicyNotFoundFault
- `499` — NetworkTypeNotSupported
- `500` — CertificateNotFoundFault

---

[API](https://skmtc.net/aws/apis/rds.md) · [All operations](https://skmtc.net/aws/apis/rds/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/rds/versions/e6b3ad7df19b/schema)