Performs a failover to transition a standby database into the primary database role.

POST {{baseUrl}}/databases/:databaseId/dataGuardAssociations/:dataGuardAssociationId/actions/failover

Performs a failover to transition the standby database identified by the databaseId parameter into the specified Data Guard association's primary role after the existing primary database fails or becomes unreachable.

A failover might result in data loss depending on the protection mode in effect at the time of the primary database failure.

Request Body

{"databaseAdminPassword"=>"<string>"}

HEADERS

KeyDatatypeRequiredDescription
if-matchstringFor optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match
parameter to the value of the etag from a previous GET or POST response for that resource. The resource
will be updated or deleted only if the etag you provide matches the resource's current etag value.
Content-Typestring
Acceptstring

RESPONSES

status: OK

{&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;databaseId&quot;:&quot;\u003cstring\u003e&quot;,&quot;role&quot;:&quot;PRIMARY&quot;,&quot;peerDbSystemId&quot;:&quot;\u003cstring\u003e&quot;,&quot;peerRole&quot;:&quot;STANDBY&quot;,&quot;protectionMode&quot;:&quot;MAXIMUM_AVAILABILITY&quot;,&quot;lifecycleState&quot;:&quot;FAILED&quot;,&quot;applyLag&quot;:&quot;\u003cstring\u003e&quot;,&quot;applyRate&quot;:&quot;\u003cstring\u003e&quot;,&quot;isActiveDataGuardEnabled&quot;:&quot;\u003cboolean\u003e&quot;,&quot;lifecycleDetails&quot;:&quot;\u003cstring\u003e&quot;,&quot;peerDataGuardAssociationId&quot;:&quot;\u003cstring\u003e&quot;,&quot;peerDatabaseId&quot;:&quot;\u003cstring\u003e&quot;,&quot;peerDbHomeId&quot;:&quot;\u003cstring\u003e&quot;,&quot;timeCreated&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;transportType&quot;:&quot;FASTSYNC&quot;}