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

Cria o catálogo REST do Iceberg. O ID do bucket do Google Cloud Storage é o bucket em que o catálogo é criado (por exemplo, my-catalog para gs://my-catalog).

Se o bucket não existir ou se o autor da chamada não tiver permissões de metadados do bucket, o catálogo não será criado.

Solicitação HTTP


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

Os URLs usam a sintaxe de Transcodificação gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. O recurso pai em que este catálogo será criado. Formato: projects/{projectId}

Parâmetros de consulta

Parâmetros
iceberg-catalog-id

string

Obrigatório. O nome do catálogo.
primary_location

string

Opcional. O local principal onde os metadados do catálogo serão armazenados.

Para catálogos de buckets do Google Cloud Storage e do BigLake, se isso não for especificado, a região será inferida da região do bucket (bucket defaultLocation para catálogos do BigLake). Se especificada, a região precisa estar na jurisdição (próxima à região do bucket defaultLocation e às regiões dos buckets restrictedLocations para catálogos do BigLake).

Para catálogos federados, isso precisa ser especificado e ser um local compatível com o Lakehouse (https://docs.cloud.google.com/lakehouse/docs/locations). Ele precisa estar perto da localização do catálogo remoto para ter o melhor desempenho e custo.

Corpo da solicitação

O corpo da solicitação contém uma instância de IcebergCatalog.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta incluirá uma instância de IcebergCatalog.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para mais informações, consulte Authentication Overview.