.TH "GCLOUD_ORACLE\-DATABASE_AUTONOMOUS\-DATABASES_FAILOVER" 1



.SH "NAME"
.HP
gcloud oracle\-database autonomous\-databases failover \- failovers a standby AutonomousDatabase to a new primary



.SH "SYNOPSIS"
.HP
\f5gcloud oracle\-database autonomous\-databases failover\fR \fIAUTONOMOUS_DATABASE\fR \fB\-\-peer\-autonomous\-database\fR=\fIPEER_AUTONOMOUS_DATABASE\fR [\fB\-\-async\fR] [\fB\-\-location\fR=\fILOCATION\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Failovers an AutonomousDatabase from a standby database to a new primary.



.SH "EXAMPLES"

To failover an AutonomousDatabase with id \f5my\-instance\fR in the location
\f5us\-east4\fR with primary database name as
\'projects/project\-id/locations/us\-west3/autonomousDatabases/my\-peer\-instance'
run:

.RS 2m
$ gcloud oracle\-database autonomous\-databases failover my\-instance \e
    \-\-location=us\-east4 \e
    \-\-peer\-autonomous\-database=projects/project\-id/locations/\e
us\-west3/autonomousDatabases/my\-peer\-instance
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

AutonomousDatabase resource \- The name of the Autonomous Database in the
following format:
projects/{project}/locations/{location}/autonomousDatabases/{autonomous_database}.
This represents a Cloud resource. (NOTE) Some attributes are not given arguments
in this group but can be set in other ways.

To set the \f5project\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5autonomous_database\fR on the command line with a fully
specified name;
.IP "\(em" 2m
provide the argument \f5\-\-project\fR on the command line;
.IP "\(em" 2m
set the property \f5core/project\fR.
.RE
.sp

To set the \f5location\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5autonomous_database\fR on the command line with a fully
specified name;
.IP "\(em" 2m
provide the argument \f5\-\-location\fR on the command line.
.RE
.sp

This must be specified.


.RS 2m
.TP 2m
\fIAUTONOMOUS_DATABASE\fR

ID of the autonomousDatabase or fully qualified identifier for the
autonomousDatabase.

To set the \f5autonomous_database\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5autonomous_database\fR on the command line.
.RE
.sp


.RE
.RE
.sp

.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m

AutonomousDatabase resource \- The peer database name to fail over to. This
represents a Cloud resource. (NOTE) Some attributes are not given arguments in
this group but can be set in other ways.

To set the \f5project\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5\-\-peer\-autonomous\-database\fR on the command line
with a fully specified name;
.IP "\(em" 2m
provide the argument \f5\-\-project\fR on the command line;
.IP "\(em" 2m
set the property \f5core/project\fR.
.RE
.sp

To set the \f5location\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5\-\-peer\-autonomous\-database\fR on the command line
with a fully specified name;
.IP "\(em" 2m
provide the argument \f5\-\-location\fR on the command line.
.RE
.sp

This must be specified.


.RS 2m
.TP 2m
\fB\-\-peer\-autonomous\-database\fR=\fIPEER_AUTONOMOUS_DATABASE\fR

ID of the autonomousDatabase or fully qualified identifier for the
autonomousDatabase.

To set the \f5autonomous\-database\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5\-\-peer\-autonomous\-database\fR on the command line.
.RE
.sp


.RE
.RE
.sp

.SH "OPTIONAL FLAGS"

.RS 2m
.TP 2m
\fB\-\-async\fR

Return immediately, without waiting for the operation in progress to complete.

.TP 2m
\fB\-\-location\fR=\fILOCATION\fR

For resources [autonomous_database, peer\-autonomous\-database], provides
fallback value for resource location attribute. When the resource's full URI
path is not provided, location will fallback to this flag value.


.RE
.sp

.SH "GCLOUD WIDE FLAGS"

These flags are available to all commands: \-\-access\-token\-file, \-\-account,
\-\-billing\-project, \-\-configuration, \-\-flags\-file, \-\-flatten,
\-\-format, \-\-help, \-\-impersonate\-service\-account, \-\-log\-http,
\-\-project, \-\-quiet, \-\-trace\-token, \-\-user\-output\-enabled,
\-\-verbosity.

Run \fB$ gcloud help\fR for details.



.SH "API REFERENCE"

This command uses the \fBoracledatabase/v1\fR API. The full documentation for
this API can be found at: https://cloud.google.com/oracle/database/docs