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

创建 Iceberg REST Catalog。Google Cloud Storage 存储桶目录 ID 是创建目录的存储桶（例如，my-catalog 的 gs://my-catalog）。

如果存储桶不存在，或者调用方没有存储桶元数据权限，则不会创建目录。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。将在其中创建此目录的父级资源。格式：projects/{projectId}

查询参数

参数
iceberg-catalog-id

string

必需。目录的名称。
primary_location

string

可选。将存储目录元数据的主要位置。

对于 Google Cloud Storage 存储桶目录和 BigLake 目录，如果未指定此项，则系统会从存储桶的区域（BigLake 目录的 defaultLocation 存储桶）推断出区域。如果指定了此项，则该区域必须在管辖范围内（靠近 BigLake 目录的 defaultLocation 存储桶的区域和 restrictedLocations 存储桶的区域）。

对于联合目录，必须指定此项，并且必须是 Lakehouse 支持的位置 (https://docs.cloud.google.com/lakehouse/docs/locations)。为了获得最佳性能和成本，它应靠近远程目录的位置。

请求正文

请求正文包含一个 IcebergCatalog 实例。

响应正文

如果成功，响应正文将包含一个新创建的 IcebergCatalog 实例。

授权范围

需要以下 OAuth 范围之一：

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

如需了解详情，请参阅 Authentication Overview。