NAME
    gcloud alpha biglake iceberg catalogs create - create a BigLake Iceberg
        REST catalog

SYNOPSIS
    gcloud alpha biglake iceberg catalogs create CATALOG
        --catalog-type=CATALOG_TYPE
        [--credential-mode=CREDENTIAL_MODE; default="end-user"]
        [--description=DESCRIPTION]
        [--federated-catalog-type=FEDERATED_CATALOG_TYPE]
        [--namespace-filters=[NAMESPACE,...]]
        [--primary-location=PRIMARY_LOCATION]
        [--refresh-interval=REFRESH_INTERVAL] [--secret-name=SECRET_NAME]
        [--unity-catalog-name=UNITY_CATALOG_NAME]
        [--unity-instance-name=UNITY_INSTANCE_NAME] [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    (ALPHA) Create a BigLake Iceberg REST catalog.

EXAMPLES
    To add a catalog using a Cloud Storage bucket my-catalog-bucket, run:

        $ gcloud alpha biglake iceberg catalogs create my-catalog-bucket \
            --catalog-type=gcs-bucket

    To create a catalog using a Cloud Storage bucket my-catalog-bucket with
    vended credentials, run:

        $ gcloud alpha biglake iceberg catalogs create my-catalog-bucket \
            --catalog-type=gcs-bucket --credential-mode=vended-credentials

    To create a unity federated catalog my-federated-catalog, run:

        $ gcloud alpha biglake iceberg catalogs create \
            my-federated-catalog --catalog-type=federated \
            --federated-catalog-type=unity \
            --secret-name=projects/my-project/locations/us/secrets/\
        my-secret --unity-instance-name=instance.cloud.databricks.com \
            --unity-catalog-name=my-catalog --primary-location=us

POSITIONAL ARGUMENTS
     Catalog resource - The Iceberg Catalog to create. 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
     --catalog-type=CATALOG_TYPE
        Catalog type to create the catalog with. CATALOG_TYPE must be (only one
        value is supported):

         gcs-bucket
            A catalog backed by a Cloud Storage bucket.

OPTIONAL FLAGS
     --credential-mode=CREDENTIAL_MODE; default="end-user"
        Credential mode to create the catalog with. CREDENTIAL_MODE must be one
        of:

         end-user
            Use end user credentials to access the catalog.
         vended-credentials
            Use vended credentials to access the catalog.

     --description=DESCRIPTION
        Description of the resource.

     --federated-catalog-type=FEDERATED_CATALOG_TYPE
        Type of the federated catalog. FEDERATED_CATALOG_TYPE must be (only one
        value is supported): unity.

     --namespace-filters=[NAMESPACE,...]
        Filters to determine which namespaces are included in the refresh
        process. Empty list means include all namespaces.

     --primary-location=PRIMARY_LOCATION
        Primary location for mirroring the remote catalog metadata. It must be
        a BigLake-supported location, and it should be proximate to the remote
        catalog's location for better performance and lower cost.

     --refresh-interval=REFRESH_INTERVAL
        The interval for refreshing metadata from the remote catalog (e.g.,
        "1hr5m30s"). Defaults to seconds if no unit is specified. If unset, the
        refresh interval will be set to 0s (background refresh disabled).

     --secret-name=SECRET_NAME
        The secret resource name in Secret Manager, in the format
        projects/{project_id}/locations/{location}/secrets/{secret_id} or
        projects/{project_id}/locations/{location}/secrets/{secret_id}/versions/{version_id}.

     --unity-catalog-name=UNITY_CATALOG_NAME
        Name of the catalog in Unity Catalog.

     --unity-instance-name=UNITY_INSTANCE_NAME
        The instance name is the first part of the URL when you log into your
        Databricks deployment. For example, for a Databricks on Google Cloud
        workspace URL https://1.1.gcp.databricks.com, the instance name is
        1.1.gcp.databricks.com.

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 alpha and might change without notice. If this
    command fails with API permission errors despite specifying the correct
    project, you might be trying to access an API with an invitation-only early
    access allowlist. These variants are also available:

        $ gcloud biglake iceberg catalogs create

        $ gcloud beta biglake iceberg catalogs create

