- INFORMATION
-
gcloud biglake iceberg catalogs createis not available in universe domainuniverse. - NAME
-
- gcloud biglake iceberg catalogs create - create a BigLake Iceberg REST catalog
- SYNOPSIS
-
-
gcloud biglake iceberg catalogs createCATALOG--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-bucketTo create a catalog using a Cloud Storage bucket
my-catalog-bucketwith 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
projectattribute:-
provide the argument
catalogon the command line with a fully specified name; -
provide the argument
--projecton 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
catalogattribute:-
provide the argument
catalogon the command line.
-
provide the argument
-
provide the argument
-
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.
- REQUIRED FLAGS
-
--catalog-type=CATALOG_TYPE-
Catalog type to create the catalog with.
CATALOG_TYPEmust 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_MODEmust 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.Ifrestricted_locationsis empty and unrestricted catalog creation is enabled, all accessible locations are allowed. Otherwise, onlydefault_locationand 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 helpfor details. - NOTES
-
These variants are also available:
gcloud alpha biglake iceberg catalogs creategcloud beta biglake iceberg catalogs create
gcloud biglake iceberg catalogs create
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-06-16 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2026-06-16 UTC."],[],[]]