# SwitchoverReadReplica
Switches over an Oracle standby database in an Oracle Data Guard environment, making it the new primary database. Issue this command in the Region that hosts the current standby database.
## Request Parameters
For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).
** DBInstanceIdentifier **
The DB instance identifier of the current standby database. This value is stored as a lowercase string.
Constraints:
+ Must match the identiļ¬er of an existing Oracle read replica DB instance.
Type: String
Required: Yes
## Response Elements
The following element is returned by the service.
** DBInstance **
Contains the details of an Amazon RDS DB instance.
This data type is used as a response element in the operations `CreateDBInstance`, `CreateDBInstanceReadReplica`, `DeleteDBInstance`, `DescribeDBInstances`, `ModifyDBInstance`, `PromoteReadReplica`, `RebootDBInstance`, `RestoreDBInstanceFromDBSnapshot`, `RestoreDBInstanceFromS3`, `RestoreDBInstanceToPointInTime`, `StartDBInstance`, and `StopDBInstance`.
Type: [DBInstance](API_DBInstance.md) object
## Errors
For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).
** DBInstanceNotFound **
`DBInstanceIdentifier` doesn't refer to an existing DB instance.
HTTP Status Code: 404
** InvalidDBInstanceState **
The DB instance isn't in a valid state.
HTTP Status Code: 400
## Examples
### Example
The following example shows one use of SwitchoverReadReplica.
#### Sample Request
```
https://rds.us-east-1.amazonaws.com/
?Action=SwitchoverReadReplica
&DBInstanceIdentifier=new-primary
&Version=2014-10-31
&Signature=12345678caef670d84c14ffba62e107842557f934f1e68e5d38a2d219ae70527
```
#### Sample Response
```
20
bystanders-old-primary
default.oracle-ee-19
in-sync
us-west-2c
true
read replication
replicating
19.0.0.0.ru-2021-10.rur-2021-10.r1
masteruser
2022-01-09T11:55:29.005Z
db.m4.xlarge
0
false
false
0
available
1
default:oracle-ee-19
in-sync
region
rds-ca-2019
0
db-ABCDEFG12H3I4J5KLMNOPQR6ST
11:11-11:11
false
new-primary
arn:aws:rds:us-west-2:123456789012:db:new-primary
ABCD7F8REH8UF3
new-primary.abcdefgh0ijk.us-west-2.rds.amazonaws.com
1521
oracle-ee
true
false
IPV4
false
open-read-only
ORCL
false
AL32UTF8
false
vpc-2f206b57
subnet-ac26e0e6
Active
us-west-2a
subnet-1a2bcde3
Active
us-west-2b
subnet-a1b2c3de
Active
us-west-2d
subnet-a12345b6
Active
us-west-2c
Complete
default
default
ab-12c3d45e
active
AL16UTF16
bring-your-own-license
tue:07:56-tue:08:26
gp2
true
false
abcd12ef-34g5-41d6-aed9-b6366d786923
```
## See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following:
+ [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/rds-2014-10-31/SwitchoverReadReplica)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/rds-2014-10-31/SwitchoverReadReplica)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/rds-2014-10-31/SwitchoverReadReplica)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/rds-2014-10-31/SwitchoverReadReplica)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/rds-2014-10-31/SwitchoverReadReplica)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/rds-2014-10-31/SwitchoverReadReplica)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/rds-2014-10-31/SwitchoverReadReplica)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/rds-2014-10-31/SwitchoverReadReplica)
+ [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/rds-2014-10-31/SwitchoverReadReplica)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/rds-2014-10-31/SwitchoverReadReplica)