REST Resource: projects.locations.clusters

Ressource: Cluster

Ein Google Distributed Cloud Edge-Kubernetes-Cluster.

JSON-Darstellung
{
  "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)
  },
  "enableClusterIsolation": boolean,
  "googleGroupAuthentication": {
    object (GoogleGroupAuthenticationConfig)
  }
}
Felder
name

string

Erforderlich. Der Ressourcenname des Clusters.

createTime

string (Timestamp format)

Nur Ausgabe. Die Zeit, zu der der Cluster erstellt wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"

updateTime

string (Timestamp format)

Nur Ausgabe. Die Zeit, zu der der Cluster zuletzt aktualisiert wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

labels

map (key: string, value: string)

Mit dieser Ressource verknüpfte Labels.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

fleet

object (Fleet)

Erforderlich. Flottenkonfiguration.

networking

object (ClusterNetworking)

Erforderlich. Clusterweite Netzwerkkonfiguration.

authorization

object (Authorization)

Erforderlich. Nicht veränderbar. RBAC-Richtlinie, die von GEC angewendet und verwaltet wird.

defaultMaxPodsPerNode

integer

Optional. Die standardmäßig maximale Anzahl von Pods pro Knoten, die verwendet wird, wenn für einen Knotenpool in diesem Cluster kein expliziter Höchstwert angegeben ist. Wenn nichts angegeben ist, wird der Kubernetes-Standardwert verwendet.

endpoint

string

Nur Ausgabe. Die IP-Adresse des Kubernetes API-Servers.

port

integer

Nur Ausgabe. Die Portnummer des Kubernetes API-Servers.

clusterCaCertificate

string

Nur Ausgabe. Das PEM-codierte öffentliche Zertifikat der Zertifizierungsstelle des Clusters.

maintenancePolicy

object (MaintenancePolicy)

Optional. Clusterweite Konfiguration der Wartungsrichtlinie.

controlPlaneVersion

string

Nur Ausgabe. Die Release-Version der Steuerungsebene

nodeVersion

string

Nur Ausgabe. Die niedrigste Release-Version aller Worker-Knoten. Dieses Feld kann leer sein, wenn der Cluster keine Worker-Knoten hat.

controlPlane

object (ControlPlane)

Optional. Die Konfiguration der Clustersteuerungsebene.

systemAddonsConfig

object (SystemAddonsConfig)

Optional. Die Konfiguration der System-Add‑ons.

externalLoadBalancerIpv4AddressPools[]

string

Optional. IPv4-Adresspools für das externe Load-Balancing der Clusterdatenebene.

controlPlaneEncryption

object (ControlPlaneEncryption)

Optional. Optionen für die Laufwerkverschlüsselung der Remote-Steuerungsebene. Dieses Feld wird nur verwendet, wenn die CMEK-Unterstützung aktiviert wird.

status

enum (Status)

Nur Ausgabe. Der aktuelle Status des Clusters.

maintenanceEvents[]

object (MaintenanceEvent)

Nur Ausgabe. Alle Wartungsereignisse, die für den Cluster geplant sind, einschließlich der laufenden, zukünftigen und vergangenen (bis zu 90 Tage).

targetVersion

string

Optional. Die Zielclusterversion. Beispiel: „1.5.0“.

releaseChannel

enum (ReleaseChannel)

Optional. Die Release-Version, für die ein Cluster registriert ist.

survivabilityConfig

object (SurvivabilityConfig)

Optional. Konfiguration der Cluster-Survivability, z.B. für den Fall, dass die Netzwerkverbindung unterbrochen wird. Hinweis: Dies gilt nur für Cluster mit lokaler Steuerungsebene.

externalLoadBalancerIpv6AddressPools[]

string

Optional. IPv6-Adresspools für externes Load-Balancing der Datenebene von Clustern.

connectionState

object (ConnectionState)

Nur Ausgabe. Der aktuelle Verbindungsstatus des Clusters.

externalLoadBalancerAddressPools[]

object (ExternalLoadBalancerPool)

Optional. Externe Load-Balancer-Pools für den Cluster.

zoneStorageEncryption

object (ZoneStorageEncryption)

Optional. Die Konfiguration der Speicherverschlüsselung für die Zone

containerRuntimeConfig

object (ContainerRuntimeConfig)

Optional. Die Containerlaufzeitkonfiguration des Clusters.

enableClusterIsolation

boolean

Optional. Gibt an, ob der Cluster isoliert werden muss. go/cluster-isolation-in-gdcc-cluster

googleGroupAuthentication

object (GoogleGroupAuthenticationConfig)

Optional. Die Google-Gruppen-Authentifizierungskonfiguration des Clusters.

Flotte

Flottenbezogene Konfiguration.

Flotten sind ein Google Cloud-Konzept für die logische Organisation von Clustern, mit dem Sie Multi-Cluster-Funktionen nutzen und verwalten sowie einheitliche Richtlinien auf Ihre Systeme anwenden können.

JSON-Darstellung
{
  "project": string,
  "membership": string
}
Felder
project

string

Erforderlich. Der Name des Flotten-Hostprojekts, in dem dieser Cluster registriert wird.

Projektnamen werden im Format projects/<project-number> angegeben.

membership

string

Nur Ausgabe. Der Name der verwalteten Hub-Mitgliedschaftsressource, die diesem Cluster zugeordnet ist.

Mitgliedschaftsnamen werden im Format projects/<project-number>/locations/global/membership/<cluster-id> angegeben.

ClusterNetworking

Clusterweite Netzwerkkonfiguration.

JSON-Darstellung
{
  "clusterIpv4CidrBlocks": [
    string
  ],
  "servicesIpv4CidrBlocks": [
    string
  ]
}
Felder
clusterIpv4CidrBlocks[]

string

Erforderlich. Allen Pods im Cluster wird eine RFC1918-IPv4-Adresse aus diesen Blöcken zugewiesen. Es wird nur ein einzelner Block unterstützt. Dieses Feld kann nach dem Erstellen nicht mehr geändert werden.

servicesIpv4CidrBlocks[]

string

Erforderlich. Allen Diensten im Cluster wird eine RFC1918-IPv4-Adresse aus diesen Blöcken zugewiesen. Es wird nur ein einzelner Block unterstützt. Dieses Feld kann nach dem Erstellen nicht mehr geändert werden.

Autorisierung

RBAC-Richtlinie, die von GEC angewendet und verwaltet wird.

JSON-Darstellung
{
  "adminUsers": {
    object (ClusterUser)
  }
}
Felder
adminUsers

object (ClusterUser)

Erforderlich. Nutzer, dem die Rolle „cluster-admin“ für den Cluster und damit vollständiger Zugriff auf den Cluster gewährt wird. Derzeit ist dies ein einzelnes Feld, es wird aber erweitert, um in Zukunft mehrere Administratoren zu ermöglichen.

ClusterUser

Ein Nutzerprinzipal für eine RBAC-Richtlinie.

JSON-Darstellung
{
  "username": string
}
Felder
username

string

Erforderlich. Sie haben einen aktiven Google-Nutzernamen.

MaintenancePolicy

Konfiguration der Wartungsrichtlinie.

JSON-Darstellung
{
  "window": {
    object (MaintenanceWindow)
  },
  "maintenanceExclusions": [
    {
      object (MaintenanceExclusionWindow)
    }
  ]
}
Felder
window

object (MaintenanceWindow)

Gibt das Wartungsfenster an, in dem Wartungsarbeiten durchgeführt werden dürfen.

maintenanceExclusions[]

object (MaintenanceExclusionWindow)

Optional. Ausschlüsse für die automatische Wartung Wartungsarbeiten, die keine Notfälle sind, sollten nicht in diesen Zeiträumen stattfinden. Jeder Ausschluss hat einen eindeutigen Namen und kann aktiv oder abgelaufen sein. Es sind maximal drei Wartungsausschlüsse gleichzeitig zulässig.

MaintenanceWindow

Konfiguration des Wartungsfensters

JSON-Darstellung
{
  "recurringWindow": {
    object (RecurringTimeWindow)
  }
}
Felder
recurringWindow

object (RecurringTimeWindow)

Konfiguration eines wiederkehrenden Wartungsfensters.

RecurringTimeWindow

Stellt ein beliebiges Zeitfenster dar, das wiederkehrt.

JSON-Darstellung
{
  "window": {
    object (TimeWindow)
  },
  "recurrence": string
}
Felder
window

object (TimeWindow)

Das Fenster des ersten Wiederholungsereignisses.

recurrence

string

Eine RRULE (https://tools.ietf.org/html/rfc5545#section-3.8.5.3) für die Wiederholung dieses Fensters. Sie werden über den Zeitraum zwischen Start- und Endzeit ausgeführt.

TimeWindow

Stellt einen beliebigen Zeitraum dar.

JSON-Darstellung
{
  "startTime": string,
  "endTime": string
}
Felder
startTime

string (Timestamp format)

Der Zeitpunkt, zu dem das Zeitfenster beginnt.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

endTime

string (Timestamp format)

Die Uhrzeit, zu der das Zeitfenster endet. Das Ende muss nach dem Beginn liegen.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

MaintenanceExclusionWindow

Stellt ein Wartungsausschlussfenster dar.

JSON-Darstellung
{
  "window": {
    object (TimeWindow)
  },
  "id": string
}
Felder
window

object (TimeWindow)

Optional. Das Zeitfenster.

id

string

Optional. Eine eindeutige ID (pro Cluster) für das Zeitfenster.

ControlPlane

Konfiguration der Clustersteuerungsebene.

JSON-Darstellung
{

  // 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.
}
Felder

Union-Feld config.

Für config ist nur einer der folgenden Werte zulässig:

remote

object (Remote)

Konfiguration der Remote-Steuerungsebene.

local

object (Local)

Lokale Konfiguration der Steuerungsebene.

Warnung: Cluster mit lokaler Steuerungsebene müssen in einem eigenen Projekt erstellt werden. Cluster mit lokaler Steuerungsebene können nicht im selben Projekt wie andere Clustertypen vorhanden sein, einschließlich Nicht-GDCE-Clustern. Wenn Sie lokale GDCE-Cluster mit Steuerungsebene mit anderen Clustertypen im selben Projekt kombinieren, kann dies zu Datenverlust führen.

Remote

Dieser Typ hat keine Felder.

Konfiguration für Cluster mit einer Steuerungsebene, die remote gehostet wird.

Lokal

Konfiguration speziell für Cluster mit einer lokal gehosteten Steuerungsebene.

Warnung: Cluster mit lokaler Steuerungsebene müssen in einem eigenen Projekt erstellt werden. Cluster mit lokaler Steuerungsebene können nicht im selben Projekt wie andere Clustertypen vorhanden sein, einschließlich Nicht-GDCE-Clustern. Wenn Sie lokale GDCE-Cluster mit Steuerungsebene mit anderen Clustertypen im selben Projekt kombinieren, kann dies zu Datenverlust führen.

JSON-Darstellung
{
  "nodeLocation": string,
  "nodeCount": integer,
  "machineFilter": string,
  "sharedDeploymentPolicy": enum (SharedDeploymentPolicy),
  "controlPlaneNodeStorageSchema": string
}
Felder
nodeLocation

string

Name der Google Distributed Cloud Edge-Zonen, in denen dieser Knotenpool erstellt wird. Beispiel: us-central1-edge-customer-a.

nodeCount

integer

Die Anzahl der Knoten, die als Replikate der Steuerungsebene dienen sollen.

machineFilter

string

Nur Maschinen, die diesem Filter entsprechen, dürfen Knoten der Steuerungsebene hosten. Die Filtersprache akzeptiert Strings wie „name=“ und wird hier beschrieben: AIP-160.

sharedDeploymentPolicy

enum (SharedDeploymentPolicy)

Richtlinienkonfiguration für die Bereitstellung von Nutzeranwendungen.

controlPlaneNodeStorageSchema

string

Optional. Name für das Speicherschema der Knoten der Steuerungsebene.

SharedDeploymentPolicy

Stellt die Richtlinienkonfiguration für die Bereitstellung von Nutzeranwendungen dar.

Enums
SHARED_DEPLOYMENT_POLICY_UNSPECIFIED Nicht angegeben.
ALLOWED Nutzeranwendungen können sowohl auf Knoten der Steuerungsebene als auch auf Worker-Knoten bereitgestellt werden.
DISALLOWED Nutzeranwendungen können nicht auf Knoten der Steuerungsebene, sondern nur auf Worker-Knoten bereitgestellt werden.

SystemAddonsConfig

Konfiguration, die Kunden für GDCE-System-Add-ons definieren dürfen.

JSON-Darstellung
{
  "ingress": {
    object (Ingress)
  },
  "vmServiceConfig": {
    object (VMServiceConfig)
  }
}
Felder
ingress

object (Ingress)

Optional. Konfiguration für Ingress.

vmServiceConfig

object (VMServiceConfig)

Optional. Konfiguration für den VM-Dienst.

Eingehender Traffic

Konfiguration für das Ingress-Add-on, mit dem Kunden ein Ingress-Objekt erstellen können, um den externen Zugriff auf die Server in einem Cluster zu verwalten. Das Add-on besteht aus istiod und istio-ingress.

JSON-Darstellung
{
  "disabled": boolean,
  "ipv4Vip": string
}
Felder
disabled

boolean

Optional. Gibt an, ob Ingress deaktiviert ist.

ipv4Vip

string

Optional. Ingress-VIP.

VMServiceConfig

VMServiceConfig definiert die Konfiguration für den GDCE-VM-Dienst.

JSON-Darstellung
{
  "vmmEnabled": boolean
}
Felder
vmmEnabled

boolean

Optional. Gibt an, ob VMM aktiviert ist.

ControlPlaneEncryption

Konfiguration für die Unterstützung von kundenverwalteten KMS-Schlüsseln für Knoten der Steuerungsebene.

JSON-Darstellung
{
  "kmsKey": string,
  "kmsKeyActiveVersion": string,
  "kmsKeyState": enum (KmsKeyState),
  "kmsStatus": {
    object (Status)
  },
  "resourceState": enum (ResourceState)
}
Felder
kmsKey

string

Optional. Der Cloud KMS CryptoKey, z.B. projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{cryptoKey}, der zum Schutz von Laufwerken für Steuerungsebenen verwendet werden soll. Wenn keine Angabe erfolgt, wird stattdessen ein von Google verwalteter Schlüssel verwendet.

kmsKeyActiveVersion

string

Nur Ausgabe. Die Cloud KMS CryptoKeyVersion, die derzeit zum Schutz von Laufwerken der Steuerungsebene verwendet wird. Gilt nur, wenn „kmsKey“ festgelegt ist.

kmsKeyState

enum (KmsKeyState)

Nur Ausgabe. Verfügbarkeit des Cloud KMS-CryptoKey. Wenn nicht KEY_AVAILABLE, können Knoten offline gehen, da sie nicht auf ihre lokalen Daten zugreifen können. Dies kann an fehlenden Berechtigungen zur Verwendung des Schlüssels oder daran liegen, dass der Schlüssel deaktiviert oder gelöscht wurde.

kmsStatus

object (Status)

Nur Ausgabe. Der von Cloud KMS zurückgegebene Fehlerstatus bei Verwendung dieses Schlüssels. Dieses Feld darf nur ausgefüllt werden, wenn kmsKeyState nicht KMS_KEY_STATE_KEY_AVAILABLE ist. Falls ausgefüllt, enthält dieses Feld den von Cloud KMS gemeldeten Fehlerstatus.

resourceState

enum (ResourceState)

Nur Ausgabe. Der aktuelle Ressourcenstatus, der mit dem CMEK verknüpft ist.

Status

Gibt den Status des Clusters an.

Enums
STATUS_UNSPECIFIED Status unbekannt.
PROVISIONING Der Cluster wird erstellt.
RUNNING Der Cluster wurde erstellt und ist vollständig nutzbar.
DELETING Der Cluster wird gelöscht.
ERROR Der Status gibt an, dass beim Abgleichen/Löschen des Clusters Fehler aufgetreten sind.
RECONCILING Im Cluster werden gerade Arbeiten wie Versionsupgrades durchgeführt.

MaintenanceEvent

Ein Wartungsereignis ist ein Vorgang, der zu vorübergehenden Unterbrechungen der Clusterarbeitslasten führen kann, z. B. von Google oder vom Nutzer initiierte Clusterupgrades, vom Nutzer initiierte Änderungen der Clusterkonfiguration, die einen Neustart von Knoten erfordern usw.

JSON-Darstellung
{
  "uuid": string,
  "targetVersion": string,
  "operation": string,
  "type": enum (Type),
  "schedule": enum (Schedule),
  "state": enum (State),
  "createTime": string,
  "startTime": string,
  "endTime": string,
  "updateTime": string
}
Felder
uuid

string

Nur Ausgabe. UUID des Wartungsereignisses.

targetVersion

string

Nur Ausgabe. Die Zielversion des Clusters.

operation

string

Nur Ausgabe. Der Vorgang zum Ausführen des Wartungsereignisses. Wird im Format „projects/*/locations/*/operations/*“ angegeben. Wenn das Wartungsereignis in mehrere Vorgänge unterteilt ist (z.B. aufgrund von Wartungsfenstern), wird der letzte Vorgang aufgezeichnet.

type

enum (Type)

Nur Ausgabe. Der Typ des Wartungsereignisses.

schedule

enum (Schedule)

Nur Ausgabe. Der Zeitplan des Wartungsereignisses.

state

enum (State)

Nur Ausgabe. Der Status des Wartungsereignisses.

createTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem die Wartungsereignisanfrage erstellt wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"

startTime

string (Timestamp format)

Nur Ausgabe. Die Uhrzeit, zu der das Wartungsereignis begonnen hat.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"

endTime

string (Timestamp format)

Nur Ausgabe. Die Uhrzeit, zu der das Wartungsereignis beendet wurde, unabhängig davon, ob es erfolgreich war oder nicht. Wenn das Wartungsereignis in mehrere Wartungsfenster aufgeteilt ist, wird „endTime“ erst aktualisiert, wenn der gesamte Ablauf beendet ist.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"

updateTime

string (Timestamp format)

Nur Ausgabe. Die Uhrzeit, zu der die Nachricht zum Wartungsereignis aktualisiert wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

Typ

Gibt den Typ des Wartungsereignisses an.

Enums
TYPE_UNSPECIFIED Nicht angegeben.
USER_INITIATED_UPGRADE Von Nutzern initiiertes Upgrade
GOOGLE_DRIVEN_UPGRADE Upgrade durch Google

Zeitplan

Gibt an, wann das Wartungsereignis ausgeführt werden soll.

Enums
SCHEDULE_UNSPECIFIED Nicht angegeben.
IMMEDIATELY Unmittelbar nach Erhalt der Anfrage.

Bundesland

Gibt den Status des Wartungsereignisses an.

Enums
STATE_UNSPECIFIED Nicht angegeben.
RECONCILING Das Wartungsereignis läuft. Der Cluster ist möglicherweise nicht nutzbar.
SUCCEEDED Das Wartungsereignis war erfolgreich.
FAILED Das Wartungsereignis ist fehlgeschlagen.

ReleaseChannel

Die Release-Version, für die ein Cluster registriert ist.

Enums
RELEASE_CHANNEL_UNSPECIFIED Unbekannte Release-Version. Standardmäßig wird der REGULAR-Channel verwendet.
NONE Keine Release-Version.
REGULAR Reguläre Release-Version.

SurvivabilityConfig

Konfiguration der Cluster-Survivability, z.B. für den Fall, dass die Netzwerkverbindung unterbrochen wird.

JSON-Darstellung
{
  "offlineRebootTtl": string
}
Felder
offlineRebootTtl

string (Duration format)

Optional. Zeitraum, in dem die Clusterknoten neu gestartet werden können und ohne Netzwerkverbindung zu Google funktionsfähig sind. Der Standardwert 0 bedeutet „nicht zulässig“. Die maximale Dauer beträgt 7 Tage.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit „s“. Beispiel: "3.5s".

ConnectionState

ConnectionState enthält den aktuellen Verbindungsstatus vom Cluster zu Google.

JSON-Darstellung
{
  "state": enum (State),
  "updateTime": string
}
Felder
state

enum (State)

Nur Ausgabe. Der aktuelle Verbindungsstatus.

updateTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem der Verbindungsstatus zuletzt geändert wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

Bundesland

Der Verbindungsstatus.

Enums
STATE_UNSPECIFIED Unbekannter Verbindungsstatus.
DISCONNECTED Dieser Cluster ist derzeit nicht mit Google verbunden.
CONNECTED Dieser Cluster ist derzeit mit Google verbunden.
CONNECTED_AND_SYNCING Dieser Cluster ist derzeit mit Google verbunden, hat aber möglicherweise vor Kurzem nach einer Trennung wieder eine Verbindung hergestellt. Die Synchronisierung läuft noch.

ExternalLoadBalancerPool

Externer Load-Balancer-Pool mit benutzerdefinierter Konfiguration wie Name, manuelle/automatische Zuweisung, nicht überlappende IPv4- und optionaler IPv6-Adressbereich.

JSON-Darstellung
{
  "addressPool": string,
  "ipv4Range": [
    string
  ],
  "ipv6Range": [
    string
  ],
  "avoidBuggyIps": boolean,
  "manualAssign": boolean
}
Felder
addressPool

string

Optional. Name des externen Load-Balancer-Pools.

ipv4Range[]

string

Erforderlich. Nicht überlappender IPv4-Adressbereich des Pools für externe Load Balancer.

ipv6Range[]

string

Optional. Nicht überlappender IPv6-Adressbereich des externen Load-Balancer-Pools.

avoidBuggyIps

boolean

Optional. Bei „true“ werden IP-Adressen, die auf „.0“ und „.255“ enden, aus dem Pool ausgeschlossen. Bestimmte Netzwerkhardware führt zu einem Rückgang des Traffics zu diesen speziellen Adressen. Der Standardwert ist „false“.

manualAssign

boolean

Optional. Bei „true“ werden Adressen in diesem Pool nicht automatisch Kubernetes-Diensten zugewiesen. Bei „true“ wird eine IP-Adresse in diesem Pool nur verwendet, wenn sie explizit von einem Dienst angegeben wird. Der Standardwert ist „false“.

ZoneStorageEncryption

Konfiguration für die CMEK-Unterstützung für Zonenspeicher

JSON-Darstellung
{
  "kmsKey": string,
  "kmsKeyActiveVersion": string,
  "resourceState": enum (ResourceState)
}
Felder
kmsKey

string

Optional. Cloud KMS-Schlüssel

kmsKeyActiveVersion

string

Nur Ausgabe. Die Cloud KMS CryptoKeyVersion, die derzeit für die Verschlüsselung/Entschlüsselung verwendet wird

resourceState

enum (ResourceState)

Nur Ausgabe. Der aktuelle Ressourcenstatus von CMEK

ContainerRuntimeConfig

Containerlaufzeitkonfiguration des Clusters.

JSON-Darstellung
{
  "defaultContainerRuntime": enum (DefaultContainerRuntime)
}
Felder
defaultContainerRuntime

enum (DefaultContainerRuntime)

Optional. Die Standard-Containerlaufzeit, die im Cluster konfiguriert werden soll.

DefaultContainerRuntime

Liste der unterstützten Container-Runtimes.

Enums
DEFAULT_CONTAINER_RUNTIME_UNSPECIFIED Containerlaufzeit nicht angegeben.
RUNC Verwenden Sie runc als Standard-Containerlaufzeit im Cluster.
GVISOR gVisor als Standard-Containerlaufzeit im Cluster verwenden

GoogleGroupAuthenticationConfig

Google Groups-Authentifizierungskonfiguration des Clusters. go/gdc-google-group-authentication

JSON-Darstellung
{
  "enable": boolean
}
Felder
enable

boolean

Optional. Wenn „true“, wird der Cluster für die Verwendung der Google-Gruppenauthentifizierung konfiguriert.

Methoden

create

Erstellt einen neuen Cluster in einem bestimmten Projekt und an einem bestimmten Standort.

delete

Löscht einen einzelnen Cluster.

generateAccessToken

Generiert ein Zugriffstoken für einen Cluster.

generateOfflineCredential

Generiert einen Offlineanmeldedatensatz für einen Cluster.

get

Ruft Details zu einem einzelnen Cluster ab.

list

Listet Cluster in einem angegebenen Projekt und an einem angegebenen Standort auf.

patch

Aktualisiert die Parameter eines einzelnen Clusters.

upgrade

Aktualisiert einen einzelnen Cluster.