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,
  "clusterCaCertificate": string,
  "maintenancePolicy": {
    object (MaintenancePolicy)
  },
  "controlPlaneVersion": string,
  "nodeVersion": string
}
Felder
name

string

Erforderlich. Der Ressourcenname des Clusters.
createTime

string (Timestamp format)

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

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

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

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
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)

Optional. 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.
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.

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

object (MaintenanceWindow)

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

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.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
endTime

string (Timestamp format)

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

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

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.

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.