Method: iceberg.v1.restcatalog.v1.projects.catalogs.namespaces.list

列出目錄中的 Iceberg 命名空間。命名空間只支援一層巢狀結構。

HTTP 要求

GET https://biglake.googleapis.com/iceberg/v1/restcatalog/v1/{apiParent=projects/*/catalogs/*}/namespaces

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
apiParent

string

這是必要旗標，資源路徑中的父項。

查詢參數

參數
pageToken

string

選用。指定前一個回應中傳回的 pageToken，即可擷取下一頁結果。
pageSize

integer

選用。對於支援分頁的伺服器，這會指出用戶端將收到的結果數量上限。如果伺服器不支援分頁，用戶端可能會收到大於指定 pageSize 的結果。如果未設定，預設值為 100。
parent

string

選用。選用命名空間，用於列出命名空間。如未提供或空白，則應列出所有頂層命名空間。如果父項是多部分命名空間，各部分必須以單元分隔符 (0x1F) 位元組分隔。不是實際的父項，因此 ST_NOT_REQUIRED。

要求主體

要求主體必須為空白。

回應主體

namespaces.list API 的回應訊息。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "namespaces": [
    array
  ],
  "next-page-token": string,
  "unreachable": [
    string
  ]
}
欄位
namespaces[]

array (ListValue format)

命名空間清單。
next-page-token

string

分頁的下一頁符記。
unreachable[]

string

僅供輸出。無法連線的略過位置清單。如果非空白，結果集可能不完整。

授權範圍

需要下列其中一種 OAuth 範圍：

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

詳情請參閱Authentication Overview。