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 DB instance that acts as a Read Replica for an existing source DB instance. You can create a Read Replica for a DB instance running MySQL, MariaDB, or PostgreSQL. For more information, see Working with PostgreSQL, MySQL, and MariaDB Read Replicas.

Amazon Aurora doesn't support this action. You must call the CreateDBInstance action to create a DB instance for an Aurora DB cluster.

All Read Replica DB instances are created with backups disabled. All other DB instance attributes (including DB security groups and DB parameter groups) are inherited from the source DB instance, except as specified following.

Your source DB instance must have backup retention enabled.


For .NET Core and PCL this operation is only available in asynchronous form. Please refer to CreateDBInstanceReadReplicaAsync.

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


public abstract CreateDBInstanceReadReplicaResponse CreateDBInstanceReadReplica(
         CreateDBInstanceReadReplicaRequest request
Type: Amazon.RDS.Model.CreateDBInstanceReadReplicaRequest

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

Return Value
The response from the CreateDBInstanceReadReplica service method, as returned by RDS.


DBInstanceAlreadyExistsException The user already has a DB instance with the given identifier.
DBInstanceNotFoundException DBInstanceIdentifier doesn't refer to an existing DB instance.
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.
DBSubnetGroupNotAllowedException The DBSubnetGroup shouldn't be specified while creating read replicas that lie in the same region as the source instance.
DBSubnetGroupNotFoundException DBSubnetGroupName doesn't refer to an existing DB subnet group.
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.
InvalidDBInstanceStateException The specified DB instance isn't in the available 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.
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 AWS KMS key.
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 Storage of the StorageType specified can't be associated with the DB instance.

Version Information

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

Portable Class Library:
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms

See Also