Method: iceberg.v1.restcatalog.extensions.projects.catalogs.create

Crea el catálogo de REST de Iceberg. El ID del catálogo del bucket de Google Cloud Storage es el bucket para el que se crea el catálogo (p.ej., my-catalog para gs://my-catalog).

Si el bucket no existe o el llamador no tiene permisos de metadatos del bucket, no se creará el catálogo.

Solicitud HTTP


POST https://biglake.googleapis.com/iceberg/v1/restcatalog/extensions/{parent=projects/*}/catalogs

Las URL usan la sintaxis de transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. El recurso superior en el que se creará este catálogo. Formato: projects/{projectId}

Parámetros de consulta

Parámetros
iceberg-catalog-id

string

Obligatorio. Es el nombre del catálogo.
primary_location

string

Es opcional. Es la ubicación principal en la que se almacenarán los metadatos del catálogo.

En el caso de los catálogos de buckets de Google Cloud Storage y los catálogos de BigLake, si no se especifica, la región se infiere de la región del bucket (bucket de defaultLocation para los catálogos de BigLake). Si se especifica, la región debe estar dentro de la jurisdicción (cerca de la región del bucket defaultLocation y las regiones de los buckets restrictedLocations para los catálogos de BigLake).

En el caso de los catálogos federados, se debe especificar y debe ser una ubicación compatible con Lakehouse (https://docs.cloud.google.com/lakehouse/docs/locations). Debe estar cerca de la ubicación del catálogo remoto para obtener el mejor rendimiento y costo.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene una instancia de IcebergCatalog.

Cuerpo de la respuesta

Si el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada de IcebergCatalog.

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • https://www.googleapis.com/auth/bigquery
  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta Authentication Overview.