NAME
    gcloud biglake iceberg catalogs failover - failover a BigLake Iceberg REST
        catalog

SYNOPSIS
    gcloud biglake iceberg catalogs failover CATALOG
        --primary-replica=PRIMARY_REPLICA
        [--conditional-failover-replication-time=CONDITIONAL_FAILOVER_REPLICATION_TIME]
        [--validate-only] [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    Failover a BigLake Iceberg REST catalog.

POSITIONAL ARGUMENTS
     Catalog resource - The Iceberg Catalog to failover. 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 catalog 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.

       CATALOG
          ID of the catalog or fully qualified identifier for the catalog.

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

REQUIRED FLAGS
     --primary-replica=PRIMARY_REPLICA
        The primary replica region to failover to.

OPTIONAL FLAGS
     --conditional-failover-replication-time=CONDITIONAL_FAILOVER_REPLICATION_TIME
        If not specified, wait for all data from the source region to replicate
        to the new primary region before completing the failover, with no data
        loss. If specified, the failover will be executed immediately,
        accepting data loss of any data commited after the specified timestamp.
        This timestamp must be in UTC format, e.g.
        "2025-10-09T01:13:34.038262Z". See $ gcloud topic datetimes for more
        information.

     --validate-only
        If true, the failover will be validated but not executed.

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.

NOTES
    These variants are also available:

        $ gcloud alpha biglake iceberg catalogs failover

        $ gcloud beta biglake iceberg catalogs failover

