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,
  "port": integer,
  "clusterCaCertificate": string,
  "maintenancePolicy": {
    object (MaintenancePolicy)
  },
  "controlPlaneVersion": string,
  "nodeVersion": string,
  "controlPlane": {
    object (ControlPlane)
  },
  "systemAddonsConfig": {
    object (SystemAddonsConfig)
  },
  "externalLoadBalancerIpv4AddressPools": [
    string
  ],
  "controlPlaneEncryption": {
    object (ControlPlaneEncryption)
  },
  "status": enum (Status),
  "maintenanceEvents": [
    {
      object (MaintenanceEvent)
    }
  ],
  "targetVersion": string,
  "releaseChannel": enum (ReleaseChannel),
  "survivabilityConfig": {
    object (SurvivabilityConfig)
  },
  "externalLoadBalancerIpv6AddressPools": [
    string
  ],
  "connectionState": {
    object (ConnectionState)
  },
  "externalLoadBalancerAddressPools": [
    {
      object (ExternalLoadBalancerPool)
    }
  ],
  "zoneStorageEncryption": {
    object (ZoneStorageEncryption)
  },
  "containerRuntimeConfig": {
    object (ContainerRuntimeConfig)
  },
  "enableRemoteBackup": boolean,
  "enableClusterIsolation": boolean,
  "googleGroupAuthentication": {
    object (GoogleGroupAuthenticationConfig)
  }
}
欄位
name

string

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

string (Timestamp format)

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

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
updateTime

string (Timestamp format)

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

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
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 位址。
port

integer

僅供輸出。Kubernetes API 伺服器的通訊埠號碼。
clusterCaCertificate

string

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

object (MaintenancePolicy)

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

string

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

string

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

object (ControlPlane)

選用。叢集控制層的設定。
systemAddonsConfig

object (SystemAddonsConfig)

選用。系統外掛程式的設定。
externalLoadBalancerIpv4AddressPools[]

string

選用。叢集資料層外部負載平衡的 IPv4 位址集區。
controlPlaneEncryption

object (ControlPlaneEncryption)

選用。遠端控制層磁碟加密選項。只有在啟用 CMEK 支援時，才會使用這個欄位。
status

enum (Status)

僅供輸出。叢集的目前狀態。
maintenanceEvents[]

object (MaintenanceEvent)

僅供輸出。叢集排定的所有維護事件，包括進行中、未來計畫和過去完成的事件 (最多 90 天)。
targetVersion

string

選用。目標叢集版本。例如：「1.5.0」。
releaseChannel

enum (ReleaseChannel)

選用。叢集訂閱的發布管道。
survivabilityConfig

object (SurvivabilityConfig)

選用。叢集存續能力的設定，例如網路連線中斷時。注意：這項設定僅適用於本機控制層叢集。
externalLoadBalancerIpv6AddressPools[]

string

選用。叢集資料層外部負載平衡的 IPv6 位址集區。
connectionState

object (ConnectionState)

僅供輸出。叢集目前的連線狀態。
externalLoadBalancerAddressPools[]

object (ExternalLoadBalancerPool)

選用。叢集的外部負載平衡器集區。
zoneStorageEncryption

object (ZoneStorageEncryption)

選用。可用區儲存空間加密設定
containerRuntimeConfig

object (ContainerRuntimeConfig)

選用。叢集的容器執行階段設定。
enableRemoteBackup

boolean

選用。如果設為 true，系統會為這個叢集啟用遠端備份/還原功能。
enableClusterIsolation

boolean

選用。這表示是否需要隔離叢集。go/cluster-isolation-in-gdcc-cluster
googleGroupAuthentication

object (GoogleGroupAuthenticationConfig)

選用。叢集的 Google 群組驗證設定。

機群

機群相關設定。

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

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

string

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

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

string

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

會員名稱格式為 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)
  },
  "maintenanceExclusions": [
    {
      object (MaintenanceExclusionWindow)
    }
  ]
}
欄位
window

object (MaintenanceWindow)

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

object (MaintenanceExclusionWindow)

選用。自動維護作業排除項目。非緊急維護作業不應在這些時段進行。每個排除項目都有不重複的名稱，且可能有效或已過期。在特定時間，最多可有 3 個維護作業排除項目。

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)

時段首次開始的時間。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
endTime

string (Timestamp format)

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

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

MaintenanceExclusionWindow

代表維護作業排除期。

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

object (TimeWindow)

選用。時間範圍。
id

string

選用。視窗的專屬 ID (每個叢集)。

ControlPlane

叢集控制層的設定。

JSON 表示法 
{

  // Union field config can be only one of the following:
  "remote": {
    object (Remote)
  },
  "local": {
    object (Local)
  }
  // End of list of possible types for union field config.
}
欄位

聯集欄位 config。

config 只能是下列其中一個設定：
remote

object (Remote)

遠端控制層設定。
local

object (Local)

本機控制層設定。

警告：本機控制層叢集必須在專屬專案中建立。本機控制層叢集無法與任何其他類型的叢集 (包括非 GDCE 叢集) 共存於同一個專案。在同一項專案中，將本機控制層 GDCE 叢集與任何其他類型的叢集混用，可能會導致資料遺失。

遠端

這個類型沒有任何欄位。

控制層託管於遠端的叢集專用設定。

本機

控制層託管於本機的叢集專用設定。

警告：本機控制層叢集必須在專屬專案中建立。本機控制層叢集無法與任何其他類型的叢集 (包括非 GDCE 叢集) 共存於同一個專案。在同一項專案中，將本機控制層 GDCE 叢集與任何其他類型的叢集混用，可能會導致資料遺失。

JSON 表示法 
{
  "nodeLocation": string,
  "nodeCount": integer,
  "machineFilter": string,
  "sharedDeploymentPolicy": enum (/1.13.0/docs/="/distributed-cloud/connected/latest/docs/reference/container/rest/v1/projects.locations.clusters#SharedDeploymentPolicy">SharedDeploymentPolicy),
  "controlPlaneNodeStorageSchema": string,
  "controlPlaneNodeSystemPartitionSize": SystemPartitionGiBSize)
}
欄位
nodeLocation

string

要建立這個節點集區的 Google Distributed Cloud Edge 可用區名稱。例如：us-central1-edge-customer-a。
nodeCount

integer

做為控制層副本的節點數量。
machineFilter

string

只有符合這個篩選條件的機器，才能託管控制層節點。篩選語言接受「name=」等字串，詳情請參閱 AIP-160。
sharedDeploymentPolicy

enum (SharedDeploymentPolicy)

使用者應用程式部署方式的政策設定。
controlPlaneNodeStorageSchema

string

選用。控制層節點的儲存空間結構定義名稱。
controlPlaneNodeSystemPartitionSize

enum (SystemPartitionGiBSize)

選用。控制層節點的系統分區大小 (以 GiB 為單位)。

SharedDeploymentPolicy

代表使用者應用程式部署方式的政策設定。

列舉
SHARED_DEPLOYMENT_POLICY_UNSPECIFIED 未指定。
ALLOWED 使用者應用程式可以部署至控制層和 worker 節點。
DISALLOWED 使用者應用程式無法部署至控制層節點，只能部署至 worker 節點。

SystemAddonsConfig

客戶可為 GDCE 系統外掛程式定義的設定。

JSON 表示法 
{
  "ingress": {
    object (Ingress)
  },
  "vmServiceConfig": {
    object (VMServiceConfig)
  }
}
欄位
ingress

object (Ingress)

選用。Ingress 設定。
vmServiceConfig

object (VMServiceConfig)

選用。VM 服務設定。

輸入

Ingress 外掛程式的設定，可讓客戶建立 Ingress 物件，管理叢集內伺服器的外部存取權。這個外掛程式包含 istiod 和 istio-ingress。

JSON 表示法 
{
  "disabled": boolean,
  "ipv4Vip": string
}
欄位
disabled

boolean

選用。是否停用輸入。
ipv4Vip

string

選用。Ingress VIP。

VMServiceConfig

VMServiceConfig 定義 GDCE VM 服務的設定。

JSON 表示法 
{
  "vmmEnabled": boolean
}
欄位
vmmEnabled

boolean

選用。是否啟用 VMM。

ControlPlaneEncryption

控制層節點的客戶自行管理 KMS 金鑰支援設定。

JSON 表示法 
{
  "kmsKey": string,
  "kmsKeyActiveVersion": string,
  "kmsKeyState": enum (KmsKeyState),
  "kmsStatus": {
    object (Status)
  },
  "resourceState": enum (ResourceState)
}
欄位
kmsKey

string

選用。Cloud KMS CryptoKey，例如 projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{cryptoKey}，用於保護控制層磁碟。如未指定，系統會改用 Google 代管的金鑰。
kmsKeyActiveVersion

string

僅供輸出。目前用於保護控制層磁碟的 Cloud KMS CryptoKeyVersion。只有在設定 kmsKey 時才適用。
kmsKeyState

enum (KmsKeyState)

僅供輸出。Cloud KMS CryptoKey 的可用性。如果不是 KEY_AVAILABLE，節點可能會因為無法存取店面資料而離線。這可能是因為您沒有使用金鑰的權限，或是金鑰已停用或刪除。
kmsStatus

object (Status)

僅供輸出。使用這組金鑰時，Cloud KMS 傳回的錯誤狀態。只有在 kmsKeyState 不是 KMS_KEY_STATE_KEY_AVAILABLE 時，才能填入這個欄位。如果填入這個欄位，則會包含 Cloud KMS 回報的錯誤狀態。
resourceState

enum (ResourceState)

僅供輸出。與 CMEK 相關聯的目前資源狀態。

狀態

指出叢集的狀態。

列舉
STATUS_UNSPECIFIED 狀態不明。
PROVISIONING 正在建立叢集。
RUNNING 叢集已建立，可完全使用。
DELETING 正在刪除叢集。
ERROR 這個狀態表示在協調/刪除叢集時發生錯誤。
RECONCILING 叢集正在進行版本升級等作業。

MaintenanceEvent

維護事件是指可能導致叢集工作負載暫時中斷的作業，包括 Google 驅動或使用者啟動的叢集升級、使用者啟動的叢集設定變更 (需要重新啟動節點) 等。

JSON 表示法 
{
  "uuid": string,
  "targetVersion": string,
  "operation": string,
  "type": enum (Type),
  "schedule": enum (Schedule),
  "state": enum (State),
  "createTime": string,
  "startTime": string,
  "endTime": string,
  "updateTime": string
}
欄位
uuid

string

僅供輸出。維護事件的 UUID。
targetVersion

string

僅供輸出。叢集的目標版本。
operation

string

僅供輸出。執行維護事件的操作。格式為 projects/*/locations/*/operations/*。如果維護事件分成多項作業 (例如因維護期間)，系統會記錄最新作業。
type

enum (Type)

僅供輸出。維護事件的類型。
schedule

enum (Schedule)

僅供輸出。維護事件的時間表。
state

enum (State)

僅供輸出。維護事件的狀態。
createTime

string (Timestamp format)

僅供輸出。建立維護活動支援申請的時間。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
startTime

string (Timestamp format)

僅供輸出。維護事件開始時間。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
endTime

string (Timestamp format)

僅供輸出。維護事件結束的時間 (無論是否成功)。如果維護事件分成多個維護期間，則只有在整個流程結束時，endTime 才會更新。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
updateTime

string (Timestamp format)

僅供輸出。維護事件訊息的更新時間。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

類型

指出維護事件類型。

列舉
TYPE_UNSPECIFIED 未指定。
USER_INITIATED_UPGRADE 由使用者啟動升級。
GOOGLE_DRIVEN_UPGRADE 由 Google 執行的升級作業。

排程

指出應執行維護事件的時間。

列舉
SCHEDULE_UNSPECIFIED 未指定。
IMMEDIATELY 收到要求後立即生效。

狀態

指出維護事件狀態。

列舉
STATE_UNSPECIFIED 未指定。
RECONCILING 維護事件正在進行中。叢集可能無法使用。
SUCCEEDED 維護事件已成功。
FAILED 維護事件失敗。

ReleaseChannel

叢集訂閱的發布管道。

列舉
RELEASE_CHANNEL_UNSPECIFIED 未指定發布管道。預設為一般版。
NONE 沒有發布管道。
REGULAR 一般發布管道。

SurvivabilityConfig

叢集存續性設定，例如網路連線中斷時。

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

string (Duration format)

選用。叢集節點可重新啟動並運作，而無需連線至 Google 網路的時間範圍。預設值為 0，表示不允許。最長不得超過 30 天。

以秒為單位的時間長度，最多 9 個小數位數，結尾為「s」。例如："3.5s"。

ConnectionState

ConnectionState 會保留叢集與 Google 之間的目前連線狀態。

JSON 表示法 
{
  "state": enum (State),
  "updateTime": string
}
欄位
state

enum (State)

僅供輸出。目前的連線狀態。
updateTime

string (Timestamp format)

僅供輸出。上次變更連線狀態的時間。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

狀態

連線狀態。

列舉
STATE_UNSPECIFIED 連線狀態不明。
DISCONNECTED 這個叢集目前與 Google 中斷連線。
CONNECTED 這個叢集目前已連線至 Google。
CONNECTED_AND_SYNCING 這個叢集目前已連線至 Google，但最近可能曾中斷連線，然後重新連線。系統仍在同步處理。

ExternalLoadBalancerPool

外部負載平衡器集區，可自訂名稱、手動/自動指派、不重疊的 IPv4 和選用的 IPv6 位址範圍等設定。

JSON 表示法 
{
  "addressPool": string,
  "ipv4Range": [
    string
  ],
  "ipv6Range": [
    string
  ],
  "avoidBuggyIps": boolean,
  "manualAssign": boolean
}
欄位
addressPool

string

選用。外部負載平衡器集區的名稱。
ipv4Range[]

string

這是必要旗標，外部負載平衡器集區的 IPv4 位址範圍，不得重疊。
ipv6Range[]

string

選用。外部負載平衡器集區的非重疊 IPv6 位址範圍。
avoidBuggyIps

boolean

選用。如果設為 true，集區會省略結尾為 .0 和 .255 的 IP 位址。部分網路硬體會捨棄傳送至這些特殊位址的流量。預設值為 false。
manualAssign

boolean

選用。如果設為 true，這個集區中的位址不會自動指派給 Kubernetes Service。如果設為 true，只有在服務明確指定時，才會使用這個集區中的 IP 位址。預設值為 false。

ZoneStorageEncryption

可用區儲存空間 CMEK 支援設定

JSON 表示法 
{
  "kmsKey": string,
  "kmsKeyActiveVersion": string,
  "resourceState": enum (ResourceState)
}
欄位
kmsKey

string

選用。Cloud KMS 金鑰
kmsKeyActiveVersion

string

僅供輸出。目前用於加密/解密的 Cloud KMS CryptoKeyVersion
resourceState

enum (ResourceState)

僅供輸出。CMEK 目前的資源狀態

ContainerRuntimeConfig

叢集的容器執行階段設定。

JSON 表示法 
{
  "defaultContainerRuntime": enum /1.13.0/docs/f="/distributed-cloud/connected/latest/docs/reference/container/rest/v1/projects.locations.clusters#DefaultContainerRuntime">DefaultContainerRuntime)
}
欄位
defaultContainerRuntime

enum (DefaultContainerRuntime)

選用。要在叢集中設定的預設容器執行階段。

DefaultContainerRuntime

支援的容器執行階段清單。

列舉
DEFAULT_CONTAINER_RUNTIME_UNSPECIFIED 未指定容器執行階段。
RUNC 在叢集中使用 runc 做為預設容器執行階段。
GVISOR 在叢集中使用 gVisor 做為預設容器執行階段。

GoogleGroupAuthenticationConfig

叢集的 Google 群組驗證設定。go/gdc-google-group-authentication

JSON 表示法 
{
  "enable": boolean
}
欄位
enable

boolean

選用。如果設為 true，叢集會設為使用 Google 群組驗證。

方法

create

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

delete

 刪除單一叢集。

generateAccessToken

 產生叢集的存取權杖。

generateOfflineCredential

 產生叢集的離線憑證。

get

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

list

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

patch

 更新單一叢集的參數。

upgrade

 升級單一叢集。