NAME
    gcloud filestore instances promote-replica - promote a Filestore standby
        replication instance

SYNOPSIS
    gcloud filestore instances promote-replica (INSTANCE : --zone=ZONE)
        [--async] [--location=LOCATION] [--peer-instance=PEER_INSTANCE]
        [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    Promote a Filestore standby replication instance to a regular instance.
    This command can be called directly on the standby instance or on the
    active instance with the standby peer instance parameter. When used on the
    standby instance promotes the standby instance to a regular instance even
    if the active instance is unavailable. When used on the active instance
    detaches the standby instance from the active instance even if the standby
    instance is unavailable.

    This command can fail for the following reasons:
      ▪ The target instance does not exist.
      ▪ The instance is not a standby replication member.
      ▪ The instance is an active instance and the peer instance parameter is
        missing or invalid.

EXAMPLES
    To promote a standby instance with the name my-replica-instance located in
    us-central1, run:

        $ gcloud filestore instances promote-replica my-replica-instance \
            --zone=us-central1

    To promote a standby instance with the name my-replica-instance located in
    us-central1, attached to the active peer instance my-active-instance
    located in us-west1, run:

        $ gcloud filestore instances promote-replica my-active-instance \
            --zone=us-west1 \
            --peer-instance=projects/my-project/locations/us-central1/\
        instances/my-replica-instance

POSITIONAL ARGUMENTS
     Instance resource - Arguments and flags that specify the Filestore
     instance to promote. The arguments in this group can be used to specify
     the attributes of this 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 instance on the command line with a fully
        specified name;
      ◆ provide the argument --project on the command line;
      ◆ set the property core/project.

     This must be specified.

       INSTANCE
          ID of the instance or fully qualified identifier for the instance.

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

          This positional argument must be specified if any of the other
          arguments in this group are specified.

       --zone=ZONE
          The zone of the Filestore instance.

          To set the zone attribute:
          ▸ provide the argument instance on the command line with a fully
            specified name;
          ▸ provide the argument --zone on the command line;
          ▸ provide the argument --location on the command line;
          ▸ set the property filestore/zone.

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

     --location=LOCATION
        Location of the Filestore instance to promote.

     --peer-instance=PEER_INSTANCE
        The name of the standby peer instance to promote.

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 file/v1 API. The full documentation for this API can
    be found at: https://cloud.google.com/filestore/

NOTES
    This variant is also available:

        $ gcloud beta filestore instances promote-replica

