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

建立 Iceberg REST 目錄。Google Cloud Storage Bucket 目錄 ID 是建立目錄的 bucket (例如 my-catalog 的 gs://my-catalog)。

如果 bucket 不存在，或呼叫者沒有 bucket 中繼資料權限，系統就不會建立目錄。

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 bucket 目錄和 BigLake 目錄，如未指定，系統會從 bucket 的區域推斷區域 (BigLake 目錄為 defaultLocation bucket)。如果指定區域，該區域必須位於管轄範圍內 (靠近 BigLake 目錄的 defaultLocation bucket 區域和 restrictedLocations bucket 區域)。

如果是聯合目錄，則必須指定此項目，且必須是 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。