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

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

DESCRIPTION
    (BETA) 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
    This command is currently in beta and might change without notice. These
    variants are also available:

        $ gcloud biglake iceberg catalogs failover

        $ gcloud alpha biglake iceberg catalogs failover

