Switches over AutonomousDatabase to a Standby.

POST {{baseUrl}}/autonomousDatabases/:autonomousDatabaseId/actions/switchover?peerDbId=<string>

Initiates a switchover of the specified Autonomous Database to the associated peer database. Applicable only to databases with Disaster Recovery enabled. This API should be called in the remote region where the peer database resides. Below parameter is optional: - peerDbId Use this parameter to specify the database OCID of the Disaster Recovery peer, which is located in a different (remote) region from the current peer database. If this parameter is not provided, the switchover will happen in the same region.

Request Params

KeyDatatypeRequiredDescription
peerDbIdstringThe database OCID(/Content/General/Concepts/identifiers.htm) of the Disaster Recovery peer (source Primary) database, which is located in a different (remote) region from the current peer database.

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.
opc-retry-tokenstringA token that uniquely identifies a request so it can be retried in case of a timeout or
server error without risk of executing that same action again. Retry tokens expire after 24
hours, but can be invalidated before then due to conflicting operations (for example, if a resource
has been deleted and purged from the system, then a retry of the original creation request
may be rejected).
opc-request-idstringUnique identifier for the request.
Acceptstring

RESPONSES

status: OK

{&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;compartmentId&quot;:&quot;\u003cstring\u003e&quot;,&quot;lifecycleState&quot;:&quot;RESTORE_IN_PROGRESS&quot;,&quot;dbName&quot;:&quot;\u003cstring\u003e&quot;,&quot;cpuCoreCount&quot;:&quot;\u003cinteger\u003e&quot;,&quot;dataStorageSizeInTBs&quot;:&quot;\u003cinteger\u003e&quot;,&quot;actualUsedDataStorageSizeInTBs&quot;:&quot;\u003cdouble\u003e&quot;,&quot;allocatedStorageSizeInTBs&quot;:&quot;\u003cdouble\u003e&quot;,&quot;apexDetails&quot;:{&quot;apexVersion&quot;:&quot;\u003cstring\u003e&quot;,&quot;ordsVersion&quot;:&quot;\u003cstring\u003e&quot;},&quot;arePrimaryWhitelistedIpsUsed&quot;:&quot;\u003cboolean\u003e&quot;,&quot;autoRefreshFrequencyInSeconds&quot;:&quot;\u003cinteger\u003e&quot;,&quot;autoRefreshPointLagInSeconds&quot;:&quot;\u003cinteger\u003e&quot;,&quot;autonomousContainerDatabaseId&quot;:&quot;\u003cstring\u003e&quot;,&quot;autonomousMaintenanceScheduleType&quot;:&quot;REGULAR&quot;,&quot;availableUpgradeVersions&quot;:[&quot;\u003cstring\u003e&quot;],&quot;backupConfig&quot;:{&quot;manualBackupBucketName&quot;:&quot;\u003cstring\u003e&quot;,&quot;manualBackupType&quot;:&quot;OBJECT_STORE&quot;},&quot;characterSet&quot;:&quot;\u003cstring\u003e&quot;,&quot;computeCount&quot;:&quot;\u003cfloat\u003e&quot;,&quot;computeModel&quot;:&quot;OCPU&quot;,&quot;connectionStrings&quot;:{&quot;allConnectionStrings&quot;:{&quot;culpa899&quot;:&quot;\u003cstring\u003e&quot;,&quot;pariatur_0&quot;:&quot;\u003cstring\u003e&quot;,&quot;non66_&quot;:&quot;\u003cstring\u003e&quot;,&quot;reprehenderit3da&quot;:&quot;\u003cstring\u003e&quot;},&quot;dedicated&quot;:&quot;\u003cstring\u003e&quot;,&quot;high&quot;:&quot;\u003cstring\u003e&quot;,&quot;low&quot;:&quot;\u003cstring\u003e&quot;,&quot;medium&quot;:&quot;\u003cstring\u003e&quot;,&quot;profiles&quot;:[{&quot;displayName&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:&quot;\u003cstring\u003e&quot;,&quot;protocol&quot;:&quot;TCPS&quot;,&quot;hostFormat&quot;:&quot;FQDN&quot;,&quot;sessionMode&quot;:&quot;REDIRECT&quot;,&quot;syntaxFormat&quot;:&quot;EZCONNECT&quot;,&quot;consumerGroup&quot;:&quot;TP&quot;,&quot;isRegional&quot;:&quot;\u003cboolean\u003e&quot;,&quot;tlsAuthentication&quot;:&quot;MUTUAL&quot;}]},&quot;connectionUrls&quot;:{&quot;apexUrl&quot;:&quot;\u003cstring\u003e&quot;,&quot;databaseTransformsUrl&quot;:&quot;\u003cstring\u003e&quot;,&quot;graphStudioUrl&quot;:&quot;\u003cstring\u003e&quot;,&quot;machineLearningNotebookUrl&quot;:&quot;\u003cstring\u003e&quot;,&quot;machineLearningUserManagementUrl&quot;:&quot;\u003cstring\u003e&quot;,&quot;mongoDbUrl&quot;:&quot;\u003cstring\u003e&quot;,&quot;ordsUrl&quot;:&quot;\u003cstring\u003e&quot;,&quot;sqlDevWebUrl&quot;:&quot;\u003cstring\u003e&quot;},&quot;customerContacts&quot;:[{&quot;email&quot;:&quot;\u003cstring\u003e&quot;}],&quot;dataSafeStatus&quot;:&quot;REGISTERED&quot;,&quot;dataStorageSizeInGBs&quot;:&quot;\u003cinteger\u003e&quot;,&quot;databaseEdition&quot;:&quot;ENTERPRISE_EDITION&quot;,&quot;dataguardRegionType&quot;:&quot;PRIMARY_DG_REGION&quot;,&quot;dbToolsDetails&quot;:[{&quot;name&quot;:&quot;DATABASE_ACTIONS&quot;,&quot;isEnabled&quot;:false}],&quot;dbVersion&quot;:&quot;\u003cstring\u003e&quot;,&quot;dbWorkload&quot;:&quot;DW&quot;,&quot;definedTags&quot;:{&quot;irurec&quot;:{&quot;ea_fa&quot;:{}}},&quot;disasterRecoveryRegionType&quot;:&quot;REMOTE&quot;,&quot;displayName&quot;:&quot;\u003cstring\u003e&quot;,&quot;failedDataRecoveryInSeconds&quot;:&quot;\u003cinteger\u003e&quot;,&quot;freeformTags&quot;:{&quot;amet7b&quot;:&quot;\u003cstring\u003e&quot;,&quot;adipisicing_99a&quot;:&quot;\u003cstring\u003e&quot;},&quot;inMemoryAreaInGBs&quot;:&quot;\u003cinteger\u003e&quot;,&quot;inMemoryPercentage&quot;:&quot;\u003cinteger\u003e&quot;,&quot;infrastructureType&quot;:&quot;CLOUD_AT_CUSTOMER&quot;,&quot;isAccessControlEnabled&quot;:&quot;\u003cboolean\u003e&quot;,&quot;isAutoScalingEnabled&quot;:&quot;\u003cboolean\u003e&quot;,&quot;isAutoScalingForStorageEnabled&quot;:&quot;\u003cboolean\u003e&quot;,&quot;isDataGuardEnabled&quot;:&quot;\u003cboolean\u003e&quot;,&quot;isDedicated&quot;:&quot;\u003cboolean\u003e&quot;,&quot;isDevTier&quot;:false,&quot;isFreeTier&quot;:false,&quot;isLocalDataGuardEnabled&quot;:&quot;\u003cboolean\u003e&quot;,&quot;isMtlsConnectionRequired&quot;:&quot;\u003cboolean\u003e&quot;,&quot;isPreview&quot;:&quot;\u003cboolean\u003e&quot;,&quot;isReconnectCloneEnabled&quot;:&quot;\u003cboolean\u003e&quot;,&quot;isRefreshableClone&quot;:&quot;\u003cboolean\u003e&quot;,&quot;isRemoteDataGuardEnabled&quot;:&quot;\u003cboolean\u003e&quot;,&quot;keyHistoryEntry&quot;:[{&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;timeActivated&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;vaultId&quot;:&quot;\u003cstring\u003e&quot;}],&quot;keyStoreId&quot;:&quot;\u003cstring\u003e&quot;,&quot;keyStoreWalletName&quot;:&quot;\u003cstring\u003e&quot;,&quot;kmsKeyId&quot;:&quot;\u003cstring\u003e&quot;,&quot;kmsKeyLifecycleDetails&quot;:&quot;\u003cstring\u003e&quot;,&quot;licenseModel&quot;:&quot;BRING_YOUR_OWN_LICENSE&quot;,&quot;lifecycleDetails&quot;:&quot;\u003cstring\u003e&quot;,&quot;localAdgAutoFailoverMaxDataLossLimit&quot;:&quot;\u003cinteger\u003e&quot;,&quot;localDisasterRecoveryType&quot;:&quot;\u003cstring\u003e&quot;,&quot;localStandbyDb&quot;:{&quot;lagTimeInSeconds&quot;:&quot;\u003cinteger\u003e&quot;,&quot;lifecycleDetails&quot;:&quot;\u003cstring\u003e&quot;,&quot;lifecycleState&quot;:&quot;SCALE_IN_PROGRESS&quot;,&quot;timeDataGuardRoleChanged&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;timeDisasterRecoveryRoleChanged&quot;:&quot;\u003cdateTime\u003e&quot;},&quot;longTermBackupSchedule&quot;:{&quot;isDisabled&quot;:false,&quot;repeatCadence&quot;:&quot;ONE_TIME&quot;,&quot;retentionPeriodInDays&quot;:&quot;\u003cinteger\u003e&quot;,&quot;timeOfBackup&quot;:&quot;\u003cdateTime\u003e&quot;},&quot;memoryPerOracleComputeUnitInGBs&quot;:&quot;\u003cinteger\u003e&quot;,&quot;ncharacterSet&quot;:&quot;\u003cstring\u003e&quot;,&quot;netServicesArchitecture&quot;:&quot;DEDICATED&quot;,&quot;nextLongTermBackupTimeStamp&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;nsgIds&quot;:[&quot;\u003cstring\u003e&quot;],&quot;ocpuCount&quot;:&quot;\u003cfloat\u003e&quot;,&quot;openMode&quot;:&quot;READ_WRITE&quot;,&quot;operationsInsightsStatus&quot;:&quot;FAILED_ENABLING&quot;,&quot;peerDbIds&quot;:[&quot;\u003cstring\u003e&quot;],&quot;permissionLevel&quot;:&quot;UNRESTRICTED&quot;,&quot;privateEndpoint&quot;:&quot;\u003cstring\u003e&quot;,&quot;privateEndpointIp&quot;:&quot;\u003cstring\u003e&quot;,&quot;privateEndpointLabel&quot;:&quot;\u003cstring\u003e&quot;,&quot;provisionableCpus&quot;:[&quot;\u003cfloat\u003e&quot;],&quot;refreshableMode&quot;:&quot;MANUAL&quot;,&quot;refreshableStatus&quot;:&quot;REFRESHING&quot;,&quot;remoteDisasterRecoveryConfiguration&quot;:{&quot;disasterRecoveryType&quot;:&quot;BACKUP_BASED&quot;,&quot;isReplicateAutomaticBackups&quot;:&quot;\u003cboolean\u003e&quot;,&quot;isSnapshotStandby&quot;:&quot;\u003cboolean\u003e&quot;,&quot;timeSnapshotStandbyEnabledTill&quot;:&quot;\u003cdateTime\u003e&quot;},&quot;resourcePoolLeaderId&quot;:&quot;\u003cstring\u003e&quot;,&quot;resourcePoolSummary&quot;:{&quot;isDisabled&quot;:&quot;\u003cboolean\u003e&quot;,&quot;poolSize&quot;:&quot;\u003cinteger\u003e&quot;},&quot;role&quot;:&quot;PRIMARY&quot;,&quot;scheduledOperations&quot;:[{&quot;dayOfWeek&quot;:{&quot;name&quot;:&quot;FRIDAY&quot;},&quot;scheduledStartTime&quot;:&quot;\u003cstring\u003e&quot;,&quot;scheduledStopTime&quot;:&quot;\u003cstring\u003e&quot;}],&quot;serviceConsoleUrl&quot;:&quot;\u003cstring\u003e&quot;,&quot;sourceId&quot;:&quot;\u003cstring\u003e&quot;,&quot;sqlWebDeveloperUrl&quot;:&quot;\u003cstring\u003e&quot;,&quot;standbyDb&quot;:{&quot;lagTimeInSeconds&quot;:&quot;\u003cinteger\u003e&quot;,&quot;lifecycleDetails&quot;:&quot;\u003cstring\u003e&quot;,&quot;lifecycleState&quot;:&quot;STARTING&quot;,&quot;timeDataGuardRoleChanged&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;timeDisasterRecoveryRoleChanged&quot;:&quot;\u003cdateTime\u003e&quot;},&quot;standbyWhitelistedIps&quot;:[&quot;\u003cstring\u003e&quot;],&quot;subnetId&quot;:&quot;\u003cstring\u003e&quot;,&quot;supportedRegionsToCloneTo&quot;:[&quot;\u003cstring\u003e&quot;],&quot;systemTags&quot;:{&quot;aliquae&quot;:{&quot;id__4&quot;:{},&quot;exercitation_13&quot;:{},&quot;proident_e&quot;:{}}},&quot;timeCreated&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;timeDataGuardRoleChanged&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;timeDeletionOfFreeAutonomousDatabase&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;timeDisasterRecoveryRoleChanged&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;timeLocalDataGuardEnabled&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;timeMaintenanceBegin&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;timeMaintenanceEnd&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;timeOfAutoRefreshStart&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;timeOfJoiningResourcePool&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;timeOfLastFailover&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;timeOfLastRefresh&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;timeOfLastRefreshPoint&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;timeOfLastSwitchover&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;timeOfNextRefresh&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;timeReclamationOfFreeAutonomousDatabase&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;timeUntilReconnectCloneEnabled&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;usedDataStorageSizeInGBs&quot;:&quot;\u003cinteger\u003e&quot;,&quot;usedDataStorageSizeInTBs&quot;:&quot;\u003cinteger\u003e&quot;,&quot;vaultId&quot;:&quot;\u003cstring\u003e&quot;,&quot;whitelistedIps&quot;:[&quot;\u003cstring\u003e&quot;]}