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

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 información sobre los nombres de recursos de Google Cloud, consulta Nombres de recursos.

version

string

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

config

object (AzureNodeConfig)

Obligatorio. Configuración de nodos 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 de la red virtual en la configuración del clúster.

autoscaling

object (AzureNodePoolAutoscaling)

Obligatorio. Configuración de la herramienta de ajuste automático de escala de este grupo de nodos.

state

enum (State)

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

uid

string

Solo de salida. Identificador único global del grupo de nodos.

reconciling

boolean

Solo de salida. Si se define, significa que hay cambios pendientes en el grupo de nodos.

createTime

string (Timestamp format)

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

Usa RFC 3339, donde la salida generada siempre se normaliza con Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otros desplazamientos distintos de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Solo de salida. Hora a la que se actualizó este grupo de nodos por última vez.

Usa RFC 3339, donde la salida generada siempre se normaliza con Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otros desplazamientos distintos de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

etag

string

Permite a los clientes realizar lecturas, modificaciones y escrituras coherentes mediante el control de simultaneidad optimista.

Se puede enviar en las solicitudes de actualización y eliminación para asegurarse de que el cliente tiene 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 no puede superar los 256 k. Las claves pueden tener dos segmentos: un prefijo (opcional) y un nombre (obligatorio), separados por una barra (/). El prefijo debe ser un subdominio DNS. El nombre debe tener 63 caracteres como máximo, empezar y terminar con caracteres alfanuméricos, e incluir guiones (-), guiones bajos (_), puntos (.) y caracteres alfanuméricos.

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

maxPodsConstraint

object (MaxPodsConstraint)

Obligatorio. Restricción sobre el número máximo de pods que se pueden ejecutar simultáneamente en un nodo del grupo de nodos.

azureAvailabilityZone

string

Opcional. Zona de disponibilidad de Azure de los nodos de este grupo de nodos.

Si no se especifica, se utiliza 1 de forma predeterminada.

errors[]

object (AzureNodePoolError)

Solo de salida. Conjunto de errores detectados en el grupo de nodos.

management

object (AzureNodeManagement)

Opcional. Configuración de gestión de este grupo de nodos.

AzureNodeConfig

Parámetros que describen la configuración de todas las máquinas de nodo de 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. Nombre del tamaño de la máquina virtual de Azure. Ejemplo: Standard_DS2_v2

Consulta las opciones de tamaños de máquinas virtuales compatibles.

Si no se especifica, se utiliza Standard_DS2_v2 de forma predeterminada.

rootVolume

object (AzureDiskTemplate)

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

Si no se especifica, se usa un disco de Azure de 32 GiB de forma predeterminada.

tags

map (key: string, value: string)

Opcional. Conjunto de etiquetas que se aplicarán a todos los recursos de Azure subyacentes de este grupo de nodos. Actualmente, solo se incluyen conjuntos de escalado de máquinas virtuales.

Especifica un máximo de 50 pares 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 va a usar en las instancias del grupo de nodos. Puede no especificarse o tener el valor ubuntu.

Si no se especifica, se utiliza ubuntu de forma predeterminada.

sshConfig

object (AzureSshConfig)

Obligatorio. Configuración de 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 el cifrado de la configuración de la máquina virtual.

taints[]

object (NodeTaint)

Opcional. Taints iniciales asignados a los nodos de este grupo de nodos.

labels

map (key: string, value: string)

Opcional. 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 la herramienta de adaptación dinámica de clústeres de Kubernetes.

La herramienta de autoescalado de clústeres de Kubernetes ajustará automáticamente el tamaño del grupo de nodos en función de la carga del clúster.

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

integer

Obligatorio. Número mínimo de nodos del grupo de nodos. Debe ser mayor o igual que 1 y menor o igual que maxNodeCount.

maxNodeCount

integer

Obligatorio. Número máximo de nodos del 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.

Enumeraciones
STATE_UNSPECIFIED Sin definir.
PROVISIONING El estado PROVISIONING indica que se está creando el grupo de nodos.
RUNNING El estado RUNNING indica que el grupo de nodos se ha creado 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á eliminando el grupo de nodos.
ERROR El estado ERROR indica que el grupo de nodos está en un estado dañado irrecuperable.
DEGRADED El estado DEGRADED indica que el grupo de nodos requiere que el usuario realice alguna acción para restaurar 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 del error legible por humanos.

AzureNodeManagement

AzureNodeManagement define el conjunto de funciones de gestión de nodos activadas en un grupo de nodos de Azure.

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

boolean

Opcional. Indica si los nodos se repararán automáticamente o no. Si se le asigna el valor true, los nodos de este pool de nodos se monitorizarán y, si no superan las comprobaciones del estado de forma constante durante un periodo, se activará una acción de reparación automática para sustituirlos por nodos nuevos.

Métodos

create
(deprecated)

Crea un AzureNodePool y lo adjunta a un AzureCluster determinado.

delete
(deprecated)

Elimina un recurso AzureNodePool específico.

get
(deprecated)

Describe un recurso AzureNodePool específico.

list
(deprecated)

Muestra todos los recursos AzureNodePool de un AzureCluster determinado.

patch
(deprecated)

Actualiza un AzureNodePool.