Method: projects.locations.bareMetalClusters.list

列出指定專案和位置的裸機叢集。

HTTP 要求

GET https://gkeonprem.googleapis.com/v1/{parent=projects/*/locations/*}/bareMetalClusters

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

路徑參數

參數
parent

string

這是必要旗標，叢集所在專案和位置的父項。格式：「projects/{project}/locations/{location}」

查詢參數

參數
pageSize

integer

要求的頁面大小。伺服器傳回的項目數量可能會少於要求數量。如未指定，最多將傳回 50 個叢集。許可的最大值為 1000；超出的數值將一律指定為 1000。
pageToken

string

伺服器應傳回的結果頁面識別符記。
filter

string

資源篩選運算式，請參閱 https://google.aip.dev/160。如果這個欄位不是空白，系統只會傳回屬性欄位符合篩選條件的資源。
view

enum (ClusterView)

查看 Bare Metal 叢集。指定 BASIC 時，系統只會傳回叢集資源名稱和管理員叢集成員資格。預設/未設定值 CLUSTER_VIEW_UNSPECIFIED 與 `FULL' 相同，會傳回完整的叢集設定詳細資料。
allowMissing

boolean

(選用步驟) 如為 true，則傳回裸機叢集清單，包括僅存在於 RMS 中的叢集。

要求主體

要求主體必須為空白。

回應主體

列出裸機叢集的回應訊息。

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

JSON 表示法 
{
  "bareMetalClusters": [
    {
      object (BareMetalCluster)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
欄位
bareMetalClusters[]

object (BareMetalCluster)

Bare Metal 叢集清單。
nextPageToken

string

這個符記可識別伺服器應傳回的結果頁面。如果權杖不為空，表示還有更多結果可供擷取，因此應使用提供的網頁權杖重複要求。
unreachable[]

string

無法抵達的地點。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。

ClusterView

叢集資源的檢視畫面。

列舉
CLUSTER_VIEW_UNSPECIFIED 如未設定值，系統會使用預設 FULL 檢視畫面。
BASIC 包括叢集資源的基本資訊，例如叢集資源名稱和管理叢集成員資格。
FULL 包含 Bare Metal 叢集資源的完整設定。這是 ListBareMetalClustersRequest 方法的預設值。