REST Resource: projects.locations.azureClusters.azureNodePools

Ressource: AzureNodePool

Ein Anthos-Knotenpool, der auf Azure ausgeführt wird.

JSON-Darstellung
{
  "name": string,
  "version": string,
  "config": {
    object (AzureNodeConfig)
  },
  "subnetId": string,
  "autoscaling": {
    object (AzureNodePoolAutoscaling)
  },
  "state": enum (State),
  "uid": string,
  "reconciling": boolean,
  "createTime": string,
  "updateTime": string,
  "etag": string,
  "annotations": {
    string: string,
    ...
  },
  "maxPodsConstraint": {
    object (MaxPodsConstraint)
  },
  "azureAvailabilityZone": string,
  "errors": [
    {
      object (AzureNodePoolError)
    }
  ],
  "management": {
    object (AzureNodeManagement)
  }
}
Felder
name

string

Der Name dieser Ressource.

Knotenpoolnamen haben das Format projects/<project-number>/locations/<region>/azureClusters/<cluster-id>/azureNodePools/<node-pool-id>.

Weitere Informationen zu Google Cloud-Ressourcennamen finden Sie unter Ressourcennamen.

version

string

Erforderlich. Die Kubernetes-Version (z.B. 1.19.10-gke.1000), die auf diesem Knotenpool ausgeführt wird.

config

object (AzureNodeConfig)

Erforderlich. Die Knotenkonfiguration des Knotenpools.

subnetId

string

Erforderlich. Die ARM-ID des Subnetzes, in dem die Knotenpool-VMs ausgeführt werden. Achten Sie darauf, dass es sich in der Clusterkonfiguration um ein Subnetz des virtuellen Netzwerks handelt.

autoscaling

object (AzureNodePoolAutoscaling)

Erforderlich. Autoscaling-Konfiguration für diesen Knotenpool.

state

enum (State)

Nur Ausgabe. Der aktuelle Status des Knotenpools.

uid

string

Nur Ausgabe. Eine global eindeutige Kennung für den Knotenpool.

reconciling

boolean

Nur Ausgabe. Wenn festgelegt, gibt es aktuell ausstehende Änderungen am Knotenpool.

createTime

string (Timestamp format)

Nur Ausgabe. Die Zeit, zu der dieser Knotenpool erstellt wurde.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. 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 dieser Knotenpool zuletzt aktualisiert wurde.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

etag

string

Ermöglicht Clients durch optimistische Nebenläufigkeitserkennung, konsistente Read-Modify-Write-Vorgänge auszuführen.

Kann bei Aktualisierungs- und Löschanfragen gesendet werden, um sicherzustellen, dass der Client vor dem Fortfahren einen aktuellen Wert hat.

annotations

map (key: string, value: string)

Optional. Annotation des Knotenpools.

Für dieses Feld gelten die gleichen Einschränkungen wie für Kubernetes-Annotationen. Die Gesamtgröße aller Schlüssel und Werte zusammen ist auf 256 KB begrenzt. Schlüssel können zwei Segmente haben: Präfix (optional) und Name (erforderlich), getrennt durch einen Schrägstrich (/). Das Präfix muss eine DNS-Subdomain sein. Der Name darf maximal 63 Zeichen lang sein und muss mit alphanumerischen Zeichen beginnen und enden. Dazwischen müssen Bindestriche (-), Unterstriche (_), Punkte (.) und alphanumerische Zeichen liegen.

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

maxPodsConstraint

object (MaxPodsConstraint)

Erforderlich. Die Einschränkung für die maximale Anzahl an Pods, die gleichzeitig auf einem Knoten im Knotenpool ausgeführt werden können.

azureAvailabilityZone

string

Optional. Die Azure-Verfügbarkeitszone der Knoten in diesem Knotenpool.

Wenn nicht angegeben, lautet die Standardeinstellung 1.

errors[]

object (AzureNodePoolError)

Nur Ausgabe. Eine Reihe von Fehlern, die im Knotenpool gefunden wurden.

management

object (AzureNodeManagement)

Optional. Die Verwaltungskonfiguration für diesen Knotenpool.

AzureNodeConfig

Parameter, die die Konfiguration aller Knotenmaschinen in einem bestimmten Knotenpool beschreiben.

JSON-Darstellung
{
  "vmSize": string,
  "rootVolume": {
    object (AzureDiskTemplate)
  },
  "tags": {
    string: string,
    ...
  },
  "imageType": string,
  "sshConfig": {
    object (AzureSshConfig)
  },
  "proxyConfig": {
    object (AzureProxyConfig)
  },
  "configEncryption": {
    object (AzureConfigEncryption)
  },
  "taints": [
    {
      object (NodeTaint)
    }
  ],
  "labels": {
    string: string,
    ...
  }
}
Felder
vmSize

string

Optional. Der Name der Größe der Azure-VM. Beispiel: Standard_DS2_v2.

Informationen zu den Optionen finden Sie unter Unterstützte VM-Größen.

Wenn nicht angegeben, lautet die Standardeinstellung Standard_DS2_v2.

rootVolume

object (AzureDiskTemplate)

Optional. Konfiguration in Bezug auf die Stamm-Volumes, die für die einzelnen Knotenpoolmaschinen bereitgestellt werden.

Wenn nicht angegeben, wird standardmäßig eine Azure Disk mit 32 GiB verwendet.

tags

map (key: string, value: string)

Optional. Eine Reihe von Tags, die auf alle zugrunde liegenden Azure-Ressourcen für diesen Knotenpool angewendet werden sollen. Derzeit sind nur VM-Skalierungsgruppen inbegriffen.

Geben Sie höchstens 50 Paare mit alphanumerischen Zeichen, Leerzeichen und Symbolen (.+-=_:@/) an. Schlüssel können bis zu 127 Unicode-Zeichen enthalten. Werte können bis zu 255 Unicode-Zeichen enthalten.

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

imageType

string

Optional. Der Typ des Betriebssystem-Images, der für Knotenpool-Instanzen verwendet werden soll. Kann nicht angegeben werden oder den Wert ubuntu haben.

Wenn nicht angegeben, lautet die Standardeinstellung ubuntu.

sshConfig

object (AzureSshConfig)

Erforderlich. SSH-Konfiguration für den Zugriff auf die Knotenpool-Maschinen.

proxyConfig

object (AzureProxyConfig)

Optional. Proxykonfiguration für ausgehenden HTTP(S)-Traffic.

configEncryption

object (AzureConfigEncryption)

Optional. Konfiguration im Zusammenhang mit der Verschlüsselung der VM-Konfiguration.

taints[]

object (NodeTaint)

Optional. Die anfänglichen Beschädigungen, die den Knoten dieses Knotenpools zugewiesen wurden.

labels

map (key: string, value: string)

Optional. Die anfänglichen Labels, die den Knoten dieses Knotenpools zugewiesen sind. Ein Objekt mit einer Liste der Paare "key": value. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }

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

AzureNodePoolAutoscaling

Konfiguration im Zusammenhang mit dem Kubernetes-Cluster-Autoscaler.

Der Kubernetes-Cluster-Autoscaler passt die Größe des Knotenpools automatisch an die Clusterlast an.

JSON-Darstellung
{
  "minNodeCount": integer,
  "maxNodeCount": integer
}
Felder
minNodeCount

integer

Erforderlich. Die minimale Anzahl von Knoten im Knotenpool. Muss größer oder gleich 1 und kleiner oder gleich „maxNodeCount“ sein.

maxNodeCount

integer

Erforderlich. Die maximale Anzahl von Knoten im Knotenpool. Muss größer oder gleich „minNodeCount“ und kleiner oder gleich 50 sein.

Bundesland

Der Lebenszyklusstatus des Knotenpools.

Enums
STATE_UNSPECIFIED Nicht definiert.
PROVISIONING Der Status „BEREITSTELLUNG“ gibt an, dass der Knotenpool erstellt wird.
RUNNING Der Status „RUNNING“ gibt an, dass der Knotenpool erstellt wurde und vollständig nutzbar ist.
RECONCILING Der Status „ABGLEICHEND“ gibt an, dass der Knotenpool gerade abgeglichen wird.
STOPPING Der Status „STOPPING“ (Anhalten) gibt an, dass der Knotenpool gelöscht wird.
ERROR Der Status „FEHLER“ gibt an, dass sich der Knotenpool in einem fehlerhaften, nicht wiederherstellbaren Zustand befindet.
DEGRADED Der Status „BESCHÄDIGT“ gibt an, dass für den Knotenpool eine Nutzeraktion erforderlich ist, um die volle Funktionalität wiederherzustellen.

AzureNodePoolError

AzureNodePoolError beschreibt Fehler, die in Azure-Knotenpools gefunden wurden.

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

string

Eine nutzerfreundliche Beschreibung des Fehlers.

AzureNodeManagement

Mit AzureNodeManagement werden die Knotenverwaltungsfunktionen definiert, die für einen Azure-Knotenpool aktiviert sind.

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

boolean

Optional. Gibt an, ob die Knoten automatisch repariert werden. Wenn diese Option auf „wahr“ gesetzt ist, werden die Knoten in diesem Knotenpool überwacht. Wenn sie über einen bestimmten Zeitraum hinweg wiederholt die Systemdiagnosen nicht bestehen, wird eine automatische Reparaturaktion ausgelöst, um sie durch neue Knoten zu ersetzen.

Methoden

create
(deprecated)

Erstellt eine neue AzureNodePool, die an eine bestimmte AzureCluster angehängt ist.

delete
(deprecated)

Löscht eine bestimmte AzureNodePool-Ressource.

get
(deprecated)

Beschreibt eine bestimmte AzureNodePool-Ressource.

list
(deprecated)

Listet alle AzureNodePool-Ressourcen auf einer bestimmten AzureCluster auf.

patch
(deprecated)

Aktualisiert eine AzureNodePool.