REST Resource: projects.locations.clusters

資源：叢集

Google Distributed Cloud Edge Kubernetes 叢集。

JSON 表示法 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "fleet": {
    object (Fleet)
  },
  "networking": {
    object (ClusterNetworking)
  },
  "authorization": {
    object (Authorization)
  },
  "defaultMaxPodsPerNode": integer,
  "endpoint": string,
  "clusterCaCertificate": string,
  "maintenancePolicy": {
    object (MaintenancePolicy)
  },
  "controlPlaneVersion": string,
  "nodeVersion": string
}
欄位
name

string

這是必要旗標，叢集的資源名稱。
createTime

string (Timestamp format)

僅供輸出。叢集的建立時間。

RFC3339 世界標準時間「Zulu」格式的時間戳記，解析度達奈秒單位，最多九個小數位數。例如："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
updateTime

string (Timestamp format)

僅供輸出。叢集上次更新的時間。

RFC3339 世界標準時間「Zulu」格式的時間戳記，解析度達奈秒單位，最多九個小數位數。例如："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
labels

map (key: string, value: string)

與這個資源相關聯的標籤。

包含 "key": value 組合清單的物件，範例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
fleet

object (Fleet)

選用。機群設定。
networking

object (ClusterNetworking)

這是必要旗標，全叢集網路設定。
authorization

object (Authorization)

這是必要旗標，不可變動。由 GEC 套用及管理的 RBAC 政策。
defaultMaxPodsPerNode

integer

選用。當這個叢集中未明確指定節點集區的最大值時，每個節點的預設 pod 數量上限。如未指定，系統會使用 Kubernetes 預設值。
endpoint

string

僅供輸出。Kubernetes API 伺服器的 IP 位址。
clusterCaCertificate

string

僅供輸出。叢集 CA 的 PEM 編碼公開憑證。
maintenancePolicy

object (MaintenancePolicy)

選用。全叢集維護政策設定。
controlPlaneVersion

string

僅供輸出。控制層發布版本
nodeVersion

string

僅供輸出。所有工作站節點中最低的發布版本。如果叢集沒有任何工作站節點，這個欄位可以留空。

機群

機群相關設定。

「機群」是按照邏輯整理叢集的 Google Cloud 概念，可讓您使用及管理多叢集功能，並在不同系統中套用一致的政策。

JSON 表示法 
{
  "project": string,
  "membership": string
}
欄位
project

string

這是必要旗標，這個叢集註冊的機群主專案名稱。

專案名稱的格式為 projects/<project-number>。
membership

string

僅供輸出。與這個叢集相關聯的代管 Hub Membership 資源名稱。

會員名稱的格式為 projects/<project-number>/locations/global/membership/<cluster-id>。

ClusterNetworking

全叢集網路設定。

JSON 表示法 
{
  "clusterIpv4CidrBlocks": [
    string
  ],
  "servicesIpv4CidrBlocks": [
    string
  ]
}
欄位
clusterIpv4CidrBlocks[]

string

這是必要旗標，系統會為叢集中的所有 Pod 指派這些區塊內的 RFC1918 IPv4 位址；僅支援單一區塊。建立後即無法變更這個欄位。
servicesIpv4CidrBlocks[]

string

這是必要旗標，系統會為叢集中的所有服務指派這些區塊內的 RFC1918 IPv4 位址；僅支援單一區塊。建立後即無法變更這個欄位。

授權

由 GEC 套用及管理的 RBAC 政策。

JSON 表示法 
{
  "adminUsers": {
    object (ClusterUser)
  }
}
欄位
adminUsers

object (ClusterUser)

這是必要旗標，會在叢集中獲得叢集管理員角色的使用者，具備叢集的完整存取權。目前只能填寫一個欄位，但日後會擴充，允許填寫多位管理員。

ClusterUser

RBAC 政策的使用者主體。

JSON 表示法 
{
  "username": string
}
欄位
username

string

這是必要旗標，有效的 Google 使用者名稱。

MaintenancePolicy

維護政策設定。

JSON 表示法 
{
  "window": {
    object (MaintenanceWindow)
  }
}
欄位
window

object (MaintenanceWindow)

指定可執行維護作業的維護期間。

MaintenanceWindow

維護期間設定

JSON 表示法 
{
  "recurringWindow": {
    object (RecurringTimeWindow)
  }
}
欄位
recurringWindow

object (RecurringTimeWindow)

設定週期性維護期間。

RecurringTimeWindow

代表會重複出現的任意時間範圍。

JSON 表示法 
{
  "window": {
    object (TimeWindow)
  },
  "recurrence": string
}
欄位
window

object (TimeWindow)

第一個週期性事件的時段。
recurrence

string

這個時間範圍的重複規則 (RRULE) (https://tools.ietf.org/html/rfc5545#section-3.8.5.3)。這些活動會持續到結束時間為止。

TimeWindow

代表任意時間範圍。

JSON 表示法 
{
  "startTime": string,
  "endTime": string
}
欄位
startTime

string (Timestamp format)

視窗首次啟動的時間。

RFC3339 世界標準時間「Zulu」格式的時間戳記，解析度達奈秒單位，最多九個小數位數。例如："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
endTime

string (Timestamp format)

時間範圍的結束時間。結束時間必須晚於開始時間。

RFC3339 世界標準時間「Zulu」格式的時間戳記，解析度達奈秒單位，最多九個小數位數。例如："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

方法

create

 在指定專案和位置建立新叢集。

delete

 刪除單一叢集。

generateAccessToken

 為叢集產生存取權杖。

get

 取得單一叢集的詳細資料。

list

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

patch

 更新單一叢集的參數。