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. Es muss sich um ein Subnetz unter dem virtuellen Netzwerk in der Clusterkonfiguration handeln.

autoscaling

object (AzureNodePoolAutoscaling)

Erforderlich. Autoscaler-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.

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. Die Zeit, zu der dieser 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".

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 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 nichts angegeben ist, wird standardmäßig 1 verwendet.

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 Azure-VM-Größe. Beispiel: Standard_DS2_v2.

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

Wenn nichts angegeben ist, wird standardmäßig Standard_DS2_v2 verwendet.

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

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 Betriebssystem-Image-Typ, der für Knotenpoolinstanzen verwendet werden soll. Kann nicht angegeben werden oder den Wert ubuntu haben.

Wenn nichts angegeben ist, wird standardmäßig ubuntu verwendet.

sshConfig

object (AzureSshConfig)

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

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 Markierungen, die den Knoten dieses Knotenpools zugewiesen sind.

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 festgelegt.
PROVISIONING Der Status PROVISIONING 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 RECONCILING gibt an, dass der Knotenpool abgeglichen wird.
STOPPING Der Status STOPPING gibt an, dass der Knotenpool gelöscht wird.
ERROR Der Status „ERROR“ gibt an, dass sich der Knotenpool in einem nicht behebbaren Fehlerzustand befindet.
DEGRADED Der Status „DEGRADED“ gibt an, dass zum Wiederherstellen der vollen Funktionalität des Knotenpools eine Nutzeraktion erforderlich ist.

AzureNodePoolError

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

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

string

Eine nutzerfreundliche Beschreibung des Fehlers.

AzureNodeManagement

AzureNodeManagement definiert die Menge der Funktionen zur Knotenverwaltung, 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 dieser Wert auf „true“ gesetzt ist, werden die Knoten in diesem Knotenpool überwacht. Wenn sie über einen längeren Zeitraum hinweg wiederholt Systemdiagnosen nicht bestehen, wird eine automatische Reparaturaktion ausgelöst, um sie durch neue Knoten zu ersetzen.

Methoden

create
(deprecated)

Erstellt einen neuen AzureNodePool, der an einen bestimmten 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 für eine bestimmte AzureCluster auf.

patch
(deprecated)

Aktualisiert ein AzureNodePool.