gcloud biglake iceberg catalogs create

INFORMATION
gcloud biglake iceberg catalogs create is not available in universe domain universe.
NAME
gcloud biglake iceberg catalogs create - create a BigLake Iceberg REST catalog
SYNOPSIS
gcloud biglake iceberg catalogs create CATALOG --catalog-type=CATALOG_TYPE [--credential-mode=CREDENTIAL_MODE; default="end-user"] [--default-location=DEFAULT_LOCATION] [--description=DESCRIPTION] [--primary-location=PRIMARY_LOCATION] [--restricted-locations=[LOCATION,…]] [GCLOUD_WIDE_FLAG]
DESCRIPTION
Create a BigLake Iceberg REST catalog.
EXAMPLES
To add a catalog using a Cloud Storage bucket my-catalog-bucket, run:
gcloud 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 biglake iceberg catalogs create my-catalog-bucket --catalog-type=gcs-bucket --credential-mode=vended-credentials
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 one of:
biglake
BigLake Iceberg catalog. Catalog type which allows namespaces and tables within a catalog to be mapped to locations beyond the catalog's designated default.
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.
--default-location=DEFAULT_LOCATION
Can only be used with BigLake catalogs. The default storage location for the catalog, e.g., gs://my-bucket/….
--description=DESCRIPTION
Description of the resource.
--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.
--restricted-locations=[LOCATION,…]
Additional Google Cloud Storage buckets and locations (e.g., gs://my-other-bucket/…) that are permitted for use by resources within a catalog. This field is currently only used for BigLake catalogs.If restricted_locations is empty and unrestricted catalog creation is enabled, all accessible locations are allowed. Otherwise, only default_location and locations in this list are allowed.
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 create
gcloud beta biglake iceberg catalogs create