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.

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 Knotenpool 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" }.

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, können in den Knotenpool aufgenommen werden. Die Filtersprache akzeptiert Strings wie „name=“ und wird unter AIP-160 genauer beschrieben.

localDiskEncryption

object (LocalDiskEncryption)

Optional. Verschlüsselungsoptionen für lokale Laufwerke. 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)
  },
  "resourceState": enum (ResourceState)
}
Felder
kmsKey

string

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

NodeConfig

Konfiguration für jeden Knoten im NodePool

JSON-Darstellung
{
  "labels": {
    string: string,
    ...
  },
  "nodeStorageSchema": string,
  "nodeSystemPartitionSize": enum /1.13.0/docs/f="/distributed-cloud/connected/latest/docs/reference/container/rest/v1/SystemPartitionGiBSize">SystemPartitionGiBSize)
}
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" }.

nodeStorageSchema

string

Optional. Name für das Speicherschema von Worker-Knoten.

nodeSystemPartitionSize

enum (SystemPartitionGiBSize)

Optional. Größe der Systempartition für Worker-Knoten in GiB.

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 angegebenen Projekt und an einem angegebenen Standort auf.

patch

Aktualisiert die Parameter eines einzelnen NodePools.