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

# GET /#Action=CreateDBInstanceReadReplica

`GET /#Action=CreateDBInstanceReadReplica`

Creates a new DB instance that acts as a read replica for an existing source DB instance or Multi-AZ DB cluster. You can create a read replica for a DB instance running MySQL, MariaDB, Oracle, PostgreSQL, or SQL Server. You can create a read replica for a Multi-AZ DB cluster running MySQL or PostgreSQL. For more information, see [Working with read replicas](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReadRepl.html) and [Migrating from a Multi-AZ DB cluster to a DB instance using a read replica](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html#multi-az-db-clusters-migrating-to-instance-with-read-replica) in the _Amazon RDS User Guide_.

Amazon Aurora doesn't support this operation. Call the `CreateDBInstance` operation to create a DB instance for an Aurora DB cluster.

All read replica DB instances are created with backups disabled. All other attributes (including DB security groups and DB parameter groups) are inherited from the source DB instance or cluster, except as specified.

Your source DB instance or cluster must have backup retention enabled.

## Query parameters

- `DBInstanceIdentifier` string, required
- `SourceDBInstanceIdentifier` string
- `DBInstanceClass` string
- `AvailabilityZone` string
- `Port` integer
- `MultiAZ` boolean
- `AutoMinorVersionUpgrade` boolean
- `Iops` integer
- `OptionGroupName` string
- `DBParameterGroupName` 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}_.:/=+\\-@]*)$").
- `DBSubnetGroupName` string
- `VpcSecurityGroupIds` string[]
- `StorageType` string
- `CopyTagsToSnapshot` boolean
- `MonitoringInterval` integer
- `MonitoringRoleArn` string
- `KmsKeyId` string
- `PreSignedUrl` 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.
- `UseDefaultProcessorFeatures` boolean
- `DeletionProtection` boolean
- `Domain` string
- `DomainIAMRoleName` string
- `ReplicaMode` 'open-read-only' | 'mounted'
- `MaxAllocatedStorage` integer
- `CustomIamInstanceProfile` string
- `NetworkType` string
- `StorageThroughput` integer
- `EnableCustomerOwnedIp` boolean
- `AllocatedStorage` integer
- `SourceDBClusterIdentifier` string
- `SourceRegion` string
- `Action` 'CreateDBInstanceReadReplica', required
- `Version` '2014-10-31', required

## Response `200`

Success

## Other responses

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

---

[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)