REST Resource: projects.locations.azureClusters.azureNodePools

Recurso: AzureNodePool

Un grupo de nodos de Anthos que se ejecuta en Azure.

Representación 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)
  }
}
Campos
name

string

El nombre de este recurso.

Los nombres de los grupos de nodos tienen el formato projects/<project-number>/locations/<region>/azureClusters/<cluster-id>/azureNodePools/<node-pool-id>.

Para obtener más detalles sobre los nombres de recursos de Google Cloud, consulta Nombres de recursos

version

string

Obligatorio. La versión de Kubernetes (p. ej., 1.19.10-gke.1000) que se ejecuta en este grupo de nodos.

config

object (AzureNodeConfig)

Obligatorio. La configuración de nodo del grupo de nodos.

subnetId

string

Obligatorio. El ID de ARM de la subred en la que se ejecutan las VMs del grupo de nodos. Asegúrate de que sea una subred en la red virtual en la configuración del clúster.

autoscaling

object (AzureNodePoolAutoscaling)

Obligatorio. Configuración del escalador automático para este grupo de nodos.

state

enum (State)

Solo salida. El estado actual del ciclo de vida del grupo de nodos.

uid

string

Solo salida. Un identificador único a nivel global para el grupo de nodos.

reconciling

boolean

Solo salida. Si se configura, hay cambios pendientes actualmente en el grupo de nodos.

createTime

string (Timestamp format)

Solo salida. La hora a la que se creó este grupo de nodos.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Solo salida. La hora en la que se actualizó este grupo de nodos por última vez.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

etag

string

Permite a los clientes realizar operaciones de lectura, modificación y escritura coherentes a través del control de simultaneidad optimista.

Se pueden enviar en las solicitudes de actualización y eliminación para garantizar que el cliente tenga un valor actualizado antes de continuar.

annotations

map (key: string, value: string)

Opcional. Anotaciones en el grupo de nodos.

Este campo tiene las mismas restricciones que las anotaciones de Kubernetes. El tamaño total de todas las claves y valores combinados se limita a 256,000. Las claves pueden tener 2 segmentos: prefijo (opcional) y nombre (obligatorio), separados por una barra (/). El prefijo debe ser un subdominio DNS. El nombre debe tener 63 caracteres o menos, comenzar y terminar con caracteres alfanuméricos, con guiones (-), guiones bajos (_), puntos (.) y caracteres alfanuméricos en el medio.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

maxPodsConstraint

object (MaxPodsConstraint)

Obligatorio. La restricción sobre la cantidad máxima de Pods que se pueden ejecutar simultáneamente en un nodo del grupo de nodos.

azureAvailabilityZone

string

Opcional. La zona de disponibilidad de Azure de los nodos de este grupo de nodos.

Cuando no se especifica, el valor predeterminado es 1.

errors[]

object (AzureNodePoolError)

Solo salida. Un conjunto de errores encontrados en el grupo de nodos.

management

object (AzureNodeManagement)

Opcional. La configuración de administración para este grupo de nodos.

AzureNodeConfig

Parámetros que describen la configuración de todas las máquinas de nodo en un grupo de nodos determinado.

Representación 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,
    ...
  }
}
Campos
vmSize

string

Opcional. El nombre del tamaño de la VM de Azure. Ejemplo: Standard_DS2_v2.

Consulta Tamaños de VM compatibles para ver las opciones.

Cuando no se especifica, el valor predeterminado es Standard_DS2_v2.

rootVolume

object (AzureDiskTemplate)

Opcional. Configuración relacionada con el volumen raíz aprovisionado para cada máquina del grupo de nodos.

Cuando no se especifica, el valor predeterminado es un Azure Disk de 32 GiB.

tags

map (key: string, value: string)

Opcional. Un conjunto de etiquetas que se aplicará a todos los recursos subyacentes de Azure para este grupo de nodos. Por el momento, esto solo incluye conjuntos de escalamiento de máquinas virtuales.

Especifica 50 pares como máximo que contengan caracteres alfanuméricos, espacios y símbolos (.+-=_:@/). Las claves pueden tener hasta 127 caracteres Unicode. Los valores pueden tener hasta 255 caracteres Unicode.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

imageType

string

Opcional. El tipo de imagen de SO que se usará en instancias de grupos de nodos. Puede no especificarse o tener un valor de ubuntu.

Cuando no se especifica, el valor predeterminado es ubuntu.

sshConfig

object (AzureSshConfig)

Obligatorio. Configuración SSH para acceder a las máquinas del grupo de nodos.

proxyConfig

object (AzureProxyConfig)

Opcional. Configuración de proxy para el tráfico HTTP(S) saliente.

configEncryption

object (AzureConfigEncryption)

Opcional. Configuración relacionada con la encriptación de configuración de VM.

taints[]

object (NodeTaint)

Opcional. Son los taints iniciales asignados a los nodos de este grupo de nodos.

labels

map (key: string, value: string)

Opcional. Son las etiquetas iniciales asignadas a los nodos de este grupo de nodos. Un objeto que contiene una lista de pares "clave": valor. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

AzureNodePoolAutoscaling

Configuración relacionada con el escalador automático de clústeres de Kubernetes.

El escalador automático de clústeres de Kubernetes ajustará automáticamente el tamaño del grupo de nodos según la carga del clúster.

Representación JSON
{
  "minNodeCount": integer,
  "maxNodeCount": integer
}
Campos
minNodeCount

integer

Obligatorio. Cantidad mínima de nodos en el grupo de nodos. Debe ser mayor o igual que 1 y menor o igual que maxNodeCount.

maxNodeCount

integer

Obligatorio. Cantidad máxima de nodos en el grupo de nodos. Debe ser mayor o igual que minNodeCount y menor o igual que 50.

Estado

El estado del ciclo de vida del grupo de nodos.

Enums
STATE_UNSPECIFIED Sin establecer
PROVISIONING El estado PROVISIONING indica que se está creando el grupo de nodos.
RUNNING El estado EN EJECUCIÓN indica que el grupo de nodos se creó y se puede usar por completo.
RECONCILING El estado RECONCILING indica que el grupo de nodos se está conciliando.
STOPPING El estado STOPPING indica que se está borrando el grupo de nodos.
ERROR El estado ERROR indica que el grupo de nodos se encuentra en un estado irrecuperable dañado.
DEGRADED El estado DEGRADED indica que el grupo de nodos requiere una acción del usuario para restablecer la funcionalidad completa.

AzureNodePoolError

AzureNodePoolError describe los errores encontrados en los grupos de nodos de Azure.

Representación JSON
{
  "message": string
}
Campos
message

string

Descripción sencilla del error.

AzureNodeManagement

AzureNodeManagement define el conjunto de funciones de administración de nodos activadas para un grupo de nodos de Azure.

Representación JSON
{
  "autoRepair": boolean
}
Campos
autoRepair

boolean

Opcional. Indica si los nodos se repararán de forma automática o no. Cuando se configura como verdadero, los nodos de este grupo de nodos se supervisan y, si fallan las verificaciones de estado de forma coherente durante un período, se activará una acción de reparación automática para reemplazarlos por nodos nuevos.

Métodos

create

Crea una AzureNodePool nueva, conectada a una AzureCluster determinada.

delete

Elimina un recurso AzureNodePool específico.

get

Describe un recurso AzureNodePool específico.

list

Enumera todos los recursos AzureNodePool en una AzureCluster determinada.

patch

Actualiza una AzureNodePool.