gcloud alpha biglake iceberg catalogs create

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"] [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

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.

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. This variant is also available:

gcloud beta biglake iceberg catalogs create