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

创建 Iceberg REST Catalog。Google Cloud Storage 存储桶目录 ID 是创建目录所用的存储桶（例如，gs://my-catalog 的 ID 为 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。