REST Resource: projects.locations.clusters.nodePools

Ressource: NodePool

Eine Gruppe von Kubernetes-Knoten in einem Cluster mit gemeinsamer Konfiguration und Spezifikation.

JSON-Darstellung
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "nodeLocation": string,
  "nodeCount": integer,
  "machineFilter": string,
  "localDiskEncryption": {
    object (LocalDiskEncryption)
  },
  "nodeVersion": string,
  "nodeConfig": {
    object (NodeConfig)
  }
}
Felder
name

string

Erforderlich. Der Ressourcenname des Knotenpools.

createTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem der Knotenpool 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. Der Zeitpunkt, zu dem der Knotenpool 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" }.

nodeLocation

string

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

nodeCount

integer

Erforderlich. Die Anzahl der Knoten im Pool.

machineFilter

string

Nur Maschinen, die diesem Filter entsprechen, dürfen dem Knotenpool beitreten. Die Filtersprache akzeptiert Strings wie „name=“ und wird unter AIP-160 genauer beschrieben.

localDiskEncryption

object (LocalDiskEncryption)

Optional. Optionen für die Verschlüsselung lokaler Festplatten. Dieses Feld wird nur verwendet, wenn die CMEK-Unterstützung aktiviert wird.

nodeVersion

string

Nur Ausgabe. Die niedrigste Release-Version aller Worker-Knoten.

nodeConfig

object (NodeConfig)

Optional. Konfiguration für jeden Knoten im NodePool

LocalDiskEncryption

Konfiguration für die CMEK-Unterstützung für die Verschlüsselung lokaler Laufwerke von Edge-Maschinen.

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

string

Optional. Der Cloud KMS CryptoKey, z.B. projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{cryptoKey}, der zum Schutz lokaler Knotenlaufwerke 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 lokaler Knotenlaufwerke 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.

NodeConfig

Konfiguration für jeden Knoten im NodePool

JSON-Darstellung
{
  "labels": {
    string: string,
    ...
  }
}
Felder
labels

map (key: string, value: string)

Optional. Die Kubernetes-Knotenlabels

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

Methoden

create

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

delete

Löscht einen einzelnen NodePool.

get

Ruft Details zu einem einzelnen NodePool ab.

list

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

patch

Aktualisiert die Parameter eines einzelnen NodePool.