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)
  }
}
Felder
name

string

Erforderlich. Der Ressourcenname des Clusters.

createTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem 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. Der Zeitpunkt, zu dem 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. Konfiguration der clusterweiten 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 Cluster-Steuerungsebene.

systemAddonsConfig

object (SystemAddonsConfig)

Optional. Die Konfiguration der System-Add-ons.

externalLoadBalancerIpv4AddressPools[]

string

Optional. IPv4-Adresspools für das externe Load Balancing auf der Cluster-Datenebene.

controlPlaneEncryption

object (ControlPlaneEncryption)

Optional. Optionen für die Laufwerksverschlü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 für den Cluster geplanten Wartungsereignisse, einschließlich der laufenden, für die Zukunft geplanten und in der Vergangenheit (bis zu 90 Tage) durchgeführten Ereignisse.

targetVersion

string

Optional. Die Zielclusterversion. Beispiel: „1.5.0“.

releaseChannel

enum (ReleaseChannel)

Optional. Die Release-Version, die ein Cluster abonniert hat.

survivabilityConfig

object (SurvivabilityConfig)

Optional. Konfiguration der Cluster-Überlebensfähigkeit, 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 das externe Load Balancing der Cluster-Datenebene.

connectionState

object (ConnectionState)

Nur Ausgabe. Der aktuelle Verbindungsstatus des Clusters.

externalLoadBalancerAddressPools[]

object (ExternalLoadBalancerPool)

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

zoneStorageEncryption

object (ZoneStorageEncryption)

Optional. Die Konfiguration der Verschlüsselung des Zonenspeichers

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 Fleet-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 jedoch in Zukunft erweitert, um mehrere Administratoren zuzulassen.

ClusterUser

Ein Nutzerhauptkonto für eine RBAC-Richtlinie.

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

string

Erforderlich. 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 können.

maintenanceExclusions[]

object (MaintenanceExclusionWindow)

Optional. Ausschlüsse von der automatischen Wartung. Nicht dringende Wartungsarbeiten sollten in diesen Zeiträumen nicht durchgeführt werden. Jeder Ausschluss hat einen eindeutigen Namen und kann aktiv oder abgelaufen sein. Die maximale Anzahl von Wartungsausschlüssen, die zu einem bestimmten Zeitpunkt zulässig sind, beträgt 3.

MaintenanceWindow

Wartungsfenster konfigurieren

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

object (RecurringTimeWindow)

Konfiguration eines wiederkehrenden Wartungsfensters.

RecurringTimeWindow

Stellt ein beliebiges Zeitfenster dar, das sich wiederholt.

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

object (TimeWindow)

Das Fenster der ersten Wiederholung.

recurrence

string

Eine RRULE (https://tools.ietf.org/html/rfc5545#section-3.8.5.3) für die Wiederholung dieses Fensters. Sie dauern so lange wie die Zeitspanne zwischen Start- und Endzeit.

TimeWindow

Stellt ein beliebiges Zeitfenster dar.

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

string (Timestamp format)

Der Zeitpunkt, zu dem das Fenster zum ersten Mal 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)

Der Zeitpunkt, zu dem das Fenster 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 Fenster.

ControlPlane

Konfiguration der Cluster-Steuerungsebene.

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)

Konfiguration der lokalen Steuerungsebene.

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

Remote

Dieser Typ hat keine Felder.

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

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 mit anderen Clustern koexistieren, einschließlich Nicht-GDCE-Clustern. Wenn Sie GDCE-Cluster mit lokaler 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, können Knoten der Steuerungsebene hosten. Die Filtersprache akzeptiert Strings wie „name=“ und wird unter AIP-160 genauer beschrieben.

sharedDeploymentPolicy

enum (SharedDeploymentPolicy)

Richtlinienkonfiguration für die Bereitstellung von Nutzeranwendungen.

controlPlaneNodeStorageSchema

string

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

Warnung: Das Feature „Konfigurierbares Schema für lokalen Knotenspeicher“ ist ein experimentelles Feature und wird nicht für die allgemeine Verwendung in Produktionsclustern/-knotenpools empfohlen.

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 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. Virtuelle IP-Adresse für eingehenden Traffic.

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 der Steuerungsebene 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 liegen oder daran, dass der Schlüssel deaktiviert oder gelöscht wurde.

kmsStatus

object (Status)

Nur Ausgabe. Fehlerstatus, der von Cloud KMS zurückgegeben wird, wenn dieser Schlüssel verwendet wird. Dieses Feld darf nur ausgefüllt werden, wenn kmsKeyState nicht KMS_KEY_STATE_KEY_AVAILABLE ist. Wenn dieses Feld ausgefüllt ist, enthält es 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 einige Fehler aufgetreten sind.
RECONCILING Am Cluster werden gerade Arbeiten wie Versionsupgrades usw. durchgeführt.

MaintenanceEvent

Ein Wartungsereignis ist ein Vorgang, der zu vorübergehenden Unterbrechungen der Clusterarbeitslasten führen kann, einschließlich von Google gesteuerter oder vom Nutzer initiierter Clusterupgrades, vom Nutzer initiierter Ä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 aufgeteilt 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 Anfrage für das Wartungsereignis 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. Der Zeitpunkt, zu dem das Wartungsereignis gestartet 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"

endTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem das Wartungsereignis beendet wurde, entweder erfolgreich 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. Der Zeitpunkt, zu dem 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 Upgrade, das von Nutzern initiiert wurde.
GOOGLE_DRIVEN_UPGRADE Upgrade von Google.

Zeitplan

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

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

Bundesland

Gibt den Status des Wartungsereignisses an.

Enums
STATE_UNSPECIFIED Nicht angegeben.
RECONCILING Das Wartungsereignis ist aktiv. Der Cluster ist möglicherweise nicht verwendbar.
SUCCEEDED Das Wartungsereignis war erfolgreich.
FAILED Das Wartungsereignis ist fehlgeschlagen.

ReleaseChannel

Die Release-Version, die ein Cluster abonniert hat.

Enums
RELEASE_CHANNEL_UNSPECIFIED Unbekannte Release-Version. Dies ist standardmäßig der Regular channel.
NONE Keine Release-Version.
REGULAR Reguläre Release-Version.

SurvivabilityConfig

Konfiguration der Cluster-Überlebensfähigkeit, z.B. für den Fall, dass die Netzwerkverbindung verloren geht.

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

string (Duration format)

Optional. Zeitraum, in dem die Clusterknoten neu gestartet und ohne Netzwerkverbindung zu Google funktionsfähig werden können. Der Standardwert 0 bedeutet, dass die Option nicht zulässig ist. 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, wurde aber möglicherweise vor Kurzem nach einer Trennung wieder verbunden. Die Synchronisierung läuft noch.

ExternalLoadBalancerPool

Externer Load-Balancer-Pool mit benutzerdefinierter Konfiguration, z. B. Name, manuelle/automatische Zuweisung, nicht überlappender 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 externen Load-Balancer-Pools.

ipv6Range[]

string

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

avoidBuggyIps

boolean

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

manualAssign

boolean

Optional. Wenn „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 CMEK-Unterstützung für Zonenspeicher

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

string

Optional. Der 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 des CMEK

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 Offline-Anmeldedaten für einen Cluster.

get

Ruft Details zu einem einzelnen Cluster ab.

list

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

patch

Aktualisiert die Parameter eines einzelnen Clusters.

upgrade

Aktualisiert einen einzelnen Cluster.