Smaws_Client_RDS.CreateDBInstanceReadReplicaCreates 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 Db2, MariaDB, MySQL, 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 and Migrating from a Multi-AZ DB cluster to a DB instance using a read replica in the Amazon RDS User Guide.
Amazon Aurora doesn't support this operation. To create a DB instance for an Aurora DB cluster, use the CreateDBInstance operation.
RDS creates read replicas 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.
val error_to_string :
[ Smaws_Lib.Protocols.AwsQuery.error
| `CertificateNotFoundFault of Types.certificate_not_found_fault
| `DBClusterNotFoundFault of Types.db_cluster_not_found_fault
| `DBInstanceAlreadyExistsFault of Types.db_instance_already_exists_fault
| `DBInstanceNotFoundFault of Types.db_instance_not_found_fault
| `DBParameterGroupNotFoundFault of Types.db_parameter_group_not_found_fault
| `DBSecurityGroupNotFoundFault of Types.db_security_group_not_found_fault
| `DBSubnetGroupDoesNotCoverEnoughAZs of
Types.db_subnet_group_does_not_cover_enough_a_zs
| `DBSubnetGroupNotAllowedFault of Types.db_subnet_group_not_allowed_fault
| `DBSubnetGroupNotFoundFault of Types.db_subnet_group_not_found_fault
| `DomainNotFoundFault of Types.domain_not_found_fault
| `InstanceQuotaExceededFault of Types.instance_quota_exceeded_fault
| `InsufficientDBInstanceCapacityFault of
Types.insufficient_db_instance_capacity_fault
| `InvalidDBClusterStateFault of Types.invalid_db_cluster_state_fault
| `InvalidDBInstanceStateFault of Types.invalid_db_instance_state_fault
| `InvalidDBSubnetGroupFault of Types.invalid_db_subnet_group_fault
| `InvalidSubnet of Types.invalid_subnet
| `InvalidVPCNetworkStateFault of Types.invalid_vpc_network_state_fault
| `KMSKeyNotAccessibleFault of Types.kms_key_not_accessible_fault
| `NetworkTypeNotSupported of Types.network_type_not_supported
| `OptionGroupNotFoundFault of Types.option_group_not_found_fault
| `ProvisionedIopsNotAvailableInAZFault of
Types.provisioned_iops_not_available_in_az_fault
| `StorageQuotaExceededFault of Types.storage_quota_exceeded_fault
| `StorageTypeNotSupportedFault of Types.storage_type_not_supported_fault
| `TenantDatabaseQuotaExceededFault of
Types.tenant_database_quota_exceeded_fault
| `VpcEncryptionControlViolationException of
Types.vpc_encryption_control_violation_exception ] ->
stringval request :
'http_type Smaws_Lib.Context.t ->
Types.create_db_instance_read_replica_message ->
(Types.create_db_instance_read_replica_result,
[> Smaws_Lib.Protocols.AwsQuery.error
| `CertificateNotFoundFault of Types.certificate_not_found_fault
| `DBClusterNotFoundFault of Types.db_cluster_not_found_fault
| `DBInstanceAlreadyExistsFault of Types.db_instance_already_exists_fault
| `DBInstanceNotFoundFault of Types.db_instance_not_found_fault
| `DBParameterGroupNotFoundFault of
Types.db_parameter_group_not_found_fault
| `DBSecurityGroupNotFoundFault of Types.db_security_group_not_found_fault
| `DBSubnetGroupDoesNotCoverEnoughAZs of
Types.db_subnet_group_does_not_cover_enough_a_zs
| `DBSubnetGroupNotAllowedFault of Types.db_subnet_group_not_allowed_fault
| `DBSubnetGroupNotFoundFault of Types.db_subnet_group_not_found_fault
| `DomainNotFoundFault of Types.domain_not_found_fault
| `InstanceQuotaExceededFault of Types.instance_quota_exceeded_fault
| `InsufficientDBInstanceCapacityFault of
Types.insufficient_db_instance_capacity_fault
| `InvalidDBClusterStateFault of Types.invalid_db_cluster_state_fault
| `InvalidDBInstanceStateFault of Types.invalid_db_instance_state_fault
| `InvalidDBSubnetGroupFault of Types.invalid_db_subnet_group_fault
| `InvalidSubnet of Types.invalid_subnet
| `InvalidVPCNetworkStateFault of Types.invalid_vpc_network_state_fault
| `KMSKeyNotAccessibleFault of Types.kms_key_not_accessible_fault
| `NetworkTypeNotSupported of Types.network_type_not_supported
| `OptionGroupNotFoundFault of Types.option_group_not_found_fault
| `ProvisionedIopsNotAvailableInAZFault of
Types.provisioned_iops_not_available_in_az_fault
| `StorageQuotaExceededFault of Types.storage_quota_exceeded_fault
| `StorageTypeNotSupportedFault of Types.storage_type_not_supported_fault
| `TenantDatabaseQuotaExceededFault of
Types.tenant_database_quota_exceeded_fault
| `VpcEncryptionControlViolationException of
Types.vpc_encryption_control_violation_exception ])
Stdlib.resultval request_with_metadata :
'http_type Smaws_Lib.Context.t ->
Types.create_db_instance_read_replica_message ->
(Types.create_db_instance_read_replica_result Smaws_Lib.Response.t,
[> Smaws_Lib.Protocols.AwsQuery.error
| `CertificateNotFoundFault of Types.certificate_not_found_fault
| `DBClusterNotFoundFault of Types.db_cluster_not_found_fault
| `DBInstanceAlreadyExistsFault of Types.db_instance_already_exists_fault
| `DBInstanceNotFoundFault of Types.db_instance_not_found_fault
| `DBParameterGroupNotFoundFault of
Types.db_parameter_group_not_found_fault
| `DBSecurityGroupNotFoundFault of Types.db_security_group_not_found_fault
| `DBSubnetGroupDoesNotCoverEnoughAZs of
Types.db_subnet_group_does_not_cover_enough_a_zs
| `DBSubnetGroupNotAllowedFault of Types.db_subnet_group_not_allowed_fault
| `DBSubnetGroupNotFoundFault of Types.db_subnet_group_not_found_fault
| `DomainNotFoundFault of Types.domain_not_found_fault
| `InstanceQuotaExceededFault of Types.instance_quota_exceeded_fault
| `InsufficientDBInstanceCapacityFault of
Types.insufficient_db_instance_capacity_fault
| `InvalidDBClusterStateFault of Types.invalid_db_cluster_state_fault
| `InvalidDBInstanceStateFault of Types.invalid_db_instance_state_fault
| `InvalidDBSubnetGroupFault of Types.invalid_db_subnet_group_fault
| `InvalidSubnet of Types.invalid_subnet
| `InvalidVPCNetworkStateFault of Types.invalid_vpc_network_state_fault
| `KMSKeyNotAccessibleFault of Types.kms_key_not_accessible_fault
| `NetworkTypeNotSupported of Types.network_type_not_supported
| `OptionGroupNotFoundFault of Types.option_group_not_found_fault
| `ProvisionedIopsNotAvailableInAZFault of
Types.provisioned_iops_not_available_in_az_fault
| `StorageQuotaExceededFault of Types.storage_quota_exceeded_fault
| `StorageTypeNotSupportedFault of Types.storage_type_not_supported_fault
| `TenantDatabaseQuotaExceededFault of
Types.tenant_database_quota_exceeded_fault
| `VpcEncryptionControlViolationException of
Types.vpc_encryption_control_violation_exception ]
* Smaws_Lib.Response.metadata)
Stdlib.result