REST Resource: projects.locations.azureClusters.azureNodePools

Ressource : AzureNodePool

Un pool de nœuds Anthos exécuté sur Azure.

Représentation JSON
{
  "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)
  }
}
Champs
name

string

Nom de cette ressource.

Les noms des pools de nœuds sont au format projects/<project-number>/locations/<region>/azureClusters/<cluster-id>/azureNodePools/<node-pool-id>.

Pour en savoir plus sur les noms de ressources Google Cloud, consultez la page Noms des ressources.

version

string

Obligatoire. Version de Kubernetes (par exemple, 1.19.10-gke.1000) exécutée sur ce pool de nœuds.

config

object (AzureNodeConfig)

Obligatoire. Configuration du pool de nœuds.

subnetId

string

Obligatoire. ID ARM du sous-réseau dans lequel s'exécutent les VM du pool de nœuds. Assurez-vous qu'il s'agit d'un sous-réseau du réseau virtuel dans la configuration du cluster.

autoscaling

object (AzureNodePoolAutoscaling)

Obligatoire. Configuration de l'autoscaler pour ce pool de nœuds.

state

enum (State)

Uniquement en sortie. État actuel du pool de nœuds.

uid

string

Uniquement en sortie. Identifiant global unique du pool de nœuds.

reconciling

boolean

Uniquement en sortie. Si cette option est définie, des modifications apportées au pool de nœuds sont actuellement en attente.

createTime

string (Timestamp format)

Uniquement en sortie. Heure à laquelle le pool de nœuds a été créé.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Uniquement en sortie. Heure de la dernière mise à jour de ce pool de nœuds.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

etag

string

Permet aux clients d'effectuer des opérations de lecture-modification-écriture cohérentes via un contrôle de simultanéité optimiste.

Peut être envoyé lors des requêtes de mise à jour et de suppression pour s'assurer que le client dispose d'une valeur à jour avant de continuer.

annotations

map (key: string, value: string)

Facultatif. Annotations sur le pool de nœuds.

Ce champ est soumis aux mêmes restrictions que les annotations Kubernetes. La taille totale de toutes les clés et valeurs combinées est limitée à 256 000. Les clés peuvent avoir deux segments : un préfixe (facultatif) et un nom (obligatoire), séparés par une barre oblique (/). Le préfixe doit être un sous-domaine DNS. Le nom ne doit pas dépasser 63 caractères. Il doit commencer et se terminer par un caractère alphanumérique, et contenir des tirets (-), des traits de soulignement (_), des points (.), avec des caractères alphanumériques entre les caractères spéciaux.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

maxPodsConstraint

object (MaxPodsConstraint)

Obligatoire. La contrainte qui s'applique au nombre maximal de pods pouvant être exécutés simultanément sur un nœud du pool de nœuds.

azureAvailabilityZone

string

Facultatif. Zone de disponibilité Azure des nœuds de ce pool de nœuds.

Si cette valeur n'est pas spécifiée, elle est définie par défaut sur 1.

errors[]

object (AzureNodePoolError)

Uniquement en sortie. Ensemble d'erreurs détectées dans le pool de nœuds.

management

object (AzureNodeManagement)

Facultatif. Configuration de la gestion pour ce pool de nœuds.

AzureNodeConfig

Paramètres décrivant la configuration de toutes les machines de nœuds d'un pool de nœuds donné.

Représentation JSON
{
  "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,
    ...
  }
}
Champs
vmSize

string

Facultatif. Nom de la taille de machine virtuelle Azure. Exemple : Standard_DS2_v2

Consultez la page Tailles de VM compatibles pour connaître les options.

Si cette valeur n'est pas spécifiée, elle est définie par défaut sur Standard_DS2_v2.

rootVolume

object (AzureDiskTemplate)

Facultatif. Configuration liée au volume racine provisionné pour chaque machine du pool de nœuds.

Lorsqu'il n'est pas spécifié, il est défini par défaut sur un disque Azure de 32 Gio.

tags

map (key: string, value: string)

Facultatif. Ensemble de tags à appliquer à toutes les ressources Azure sous-jacentes de ce pool de nœuds. Actuellement, cela ne concerne que les groupes de mise à l'échelle de machines virtuelles.

Spécifiez au maximum 50 paires contenant des caractères alphanumériques, des espaces et des symboles (.+-=_:@/). Les clés peuvent contenir jusqu'à 127 caractères Unicode. Les valeurs peuvent comporter jusqu'à 255 caractères Unicode.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

imageType

string

Facultatif. Type d'image d'OS à utiliser sur les instances de pool de nœuds. Peut ne pas être spécifié ou avoir la valeur ubuntu.

Si cette valeur n'est pas spécifiée, elle est définie par défaut sur ubuntu.

sshConfig

object (AzureSshConfig)

Obligatoire. Configuration SSH pour l'accès aux machines du pool de nœuds.

proxyConfig

object (AzureProxyConfig)

Facultatif. Configuration du proxy pour le trafic HTTP(S) sortant.

configEncryption

object (AzureConfigEncryption)

Facultatif. Configuration liée au chiffrement de la configuration des VM.

taints[]

object (NodeTaint)

Facultatif. Rejets initiaux attribués aux nœuds de ce pool de nœuds.

labels

map (key: string, value: string)

Facultatif. Étiquettes initiales attribuées aux nœuds de ce pool de nœuds. Objet contenant une liste de paires "clé:valeur". Exemple : { "nom": "clé", "masse": "1,3 kg", "nombre": "3" }.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

AzureNodePoolAutoscaling

Configuration liée à l'autoscaler de cluster Kubernetes.

L'autoscaler de cluster Kubernetes ajuste automatiquement la taille du pool de nœuds en fonction de la charge du cluster.

Représentation JSON
{
  "minNodeCount": integer,
  "maxNodeCount": integer
}
Champs
minNodeCount

integer

Obligatoire. Nombre minimal de nœuds dans le pool de nœuds. Doit être supérieur ou égal à 1 et inférieur ou égal à maxNodeCount.

maxNodeCount

integer

Obligatoire. Nombre maximal de nœuds dans le pool de nœuds. Doit être supérieur ou égal à minNodeCount et inférieur ou égal à 50.

État

État du cycle de vie du pool de nœuds.

Enums
STATE_UNSPECIFIED Non défini.
PROVISIONING L'état "PROVISIONING" (En cours de provisionnement) indique que le pool de nœuds est en cours de création.
RUNNING L'état "RUNNING" (En cours d'exécution) indique que le pool de nœuds a été créé et qu'il est entièrement utilisable.
RECONCILING L'état "RECONCILING" (Rapprochement) indique que le pool de nœuds est en cours de rapprochement.
STOPPING L'état "STOPPING" (Arrêt) indique que le pool de nœuds est en cours de suppression.
ERROR L'état "ERROR" (Erreur) indique que le pool de nœuds est dans un état défaillant irrécupérable.
DEGRADED L'état "DEGRADED" (Dégradé) indique que le pool de nœuds nécessite une action de l'utilisateur pour restaurer toutes les fonctionnalités.

AzureNodePoolError

AzureNodePoolError décrit les erreurs détectées sur les pools de nœuds Azure.

Représentation JSON
{
  "message": string
}
Champs
message

string

Description de l'erreur compréhensible par l'utilisateur.

AzureNodeManagement

AzureNodeManagement définit l'ensemble des fonctionnalités de gestion des nœuds activées pour un pool de nœuds Azure.

Représentation JSON
{
  "autoRepair": boolean
}
Champs
autoRepair

boolean

Facultatif. Indique si les nœuds sont réparés automatiquement ou non. Si cette valeur est définie sur "true", les nœuds de ce pool de nœuds sont surveillés. Si les vérifications d'état échouent de manière cohérente sur une période donnée, une action de réparation automatique est déclenchée pour les remplacer par de nouveaux nœuds.

Méthodes

create

Crée un AzureNodePool associé à un AzureCluster donné.

delete

Supprime une ressource AzureNodePool spécifique.

get

Décrit une ressource AzureNodePool spécifique.

list

Répertorie toutes les ressources AzureNodePool d'un AzureCluster donné.

patch

Met à jour un AzureNodePool.