NAME
    gcloud oracle-database autonomous-databases failover - failovers a standby
        AutonomousDatabase to a new primary

SYNOPSIS
    gcloud oracle-database autonomous-databases failover AUTONOMOUS_DATABASE
        --peer-autonomous-database=PEER_AUTONOMOUS_DATABASE [--async]
        [--location=LOCATION] [GCLOUD_WIDE_FLAG ...]

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

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

        $ gcloud oracle-database autonomous-databases failover my-instance \
            --location=us-east4 \
            --peer-autonomous-database=projects/project-id/locations/\
        us-west3/autonomousDatabases/my-peer-instance

POSITIONAL ARGUMENTS
     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 project attribute:
      ◆ provide the argument autonomous_database on the command line with a
        fully specified name;
      ◆ provide the argument --project on the command line;
      ◆ set the property core/project.

     To set the location attribute:
      ◆ provide the argument autonomous_database on the command line with a
        fully specified name;
      ◆ provide the argument --location on the command line.

     This must be specified.

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

          To set the autonomous_database attribute:
          ▸ provide the argument autonomous_database on the command line.

REQUIRED FLAGS
     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 project attribute:
      ◆ provide the argument --peer-autonomous-database on the command line
        with a fully specified name;
      ◆ provide the argument --project on the command line;
      ◆ set the property core/project.

     To set the location attribute:
      ◆ provide the argument --peer-autonomous-database on the command line
        with a fully specified name;
      ◆ provide the argument --location on the command line.

     This must be specified.

       --peer-autonomous-database=PEER_AUTONOMOUS_DATABASE
          ID of the autonomousDatabase or fully qualified identifier for the
          autonomousDatabase.

          To set the autonomous-database attribute:
          ▸ provide the argument --peer-autonomous-database on the command
            line.

OPTIONAL FLAGS
     --async
        Return immediately, without waiting for the operation in progress to
        complete.

     --location=LOCATION
        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.

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 $ gcloud help for details.

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