REST Resource: projects.locations.azureClusters.azureNodePools

Recurso: AzureNodePool

Um node pool do Anthos em execução no Azure.

Representação 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

O nome deste recurso.

Os nomes dos conjuntos de nós estão formatados como projects/<project-number>/locations/<region>/azureClusters/<cluster-id>/azureNodePools/<node-pool-id>.

Para ver mais detalhes sobre os nomes de recursos do Google Cloud, consulte o artigo Nomes de recursos

version

string

Obrigatório. A versão do Kubernetes (por exemplo, 1.19.10-gke.1000) em execução neste node pool.

config

object (AzureNodeConfig)

Obrigatório. A configuração do nó do node pool.

subnetId

string

Obrigatório. O ID ARM da sub-rede onde as VMs do conjunto de nós são executadas. Certifique-se de que é uma sub-rede na rede virtual na configuração do cluster.

autoscaling

object (AzureNodePoolAutoscaling)

Obrigatório. Configuração do escalador automático para este conjunto de nós.

state

enum (State)

Apenas saída. O estado atual do node pool.

uid

string

Apenas saída. Um identificador global exclusivo para o conjunto de nós.

reconciling

boolean

Apenas saída. Se estiver definido, existem atualmente alterações pendentes ao conjunto de nós.

createTime

string (Timestamp format)

Apenas saída. A hora em que este node pool foi criado.

Usa RFC 3339, em que o resultado gerado é sempre normalizado em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Também são aceites desvios diferentes de "Z". Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Apenas saída. A hora em que este node pool foi atualizado pela última vez.

Usa RFC 3339, em que o resultado gerado é sempre normalizado em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Também são aceites desvios diferentes de "Z". Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

etag

string

Permite que os clientes façam leituras-modificações-escritas consistentes através do controlo de concorrência otimista.

Pode ser enviado em pedidos de atualização e eliminação para garantir que o cliente tem um valor atualizado antes de continuar.

annotations

map (key: string, value: string)

Opcional. Anotações no node pool.

Este campo tem as mesmas restrições que as anotações do Kubernetes. O tamanho total de todas as chaves e valores combinados está limitado a 256 KB. As chaves podem ter 2 segmentos: prefixo (opcional) e nome (obrigatório), separados por uma barra (/). O prefixo tem de ser um subdomínio DNS. O nome tem de ter 63 carateres ou menos, começar e terminar com carateres alfanuméricos, com traços (-), sublinhados (_), pontos (.) e carateres alfanuméricos entre eles.

Um objeto que contém uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

maxPodsConstraint

object (MaxPodsConstraint)

Obrigatório. A restrição no número máximo de pods que podem ser executados em simultâneo num nó no conjunto de nós.

azureAvailabilityZone

string

Opcional. A zona de disponibilidade do Azure dos nós neste conjunto de nós.

Quando não é especificado, o valor predefinido é 1.

errors[]

object (AzureNodePoolError)

Apenas saída. Um conjunto de erros encontrados no conjunto de nós.

management

object (AzureNodeManagement)

Opcional. A configuração de gestão para este node pool.

AzureNodeConfig

Parâmetros que descrevem a configuração de todas as máquinas de nós num determinado conjunto de nós.

Representação 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. O nome do tamanho da VM do Azure. Exemplo: Standard_DS2_v2.

Consulte as dimensões de VMs suportadas para ver as opções.

Quando não é especificado, o valor predefinido é Standard_DS2_v2.

rootVolume

object (AzureDiskTemplate)

Opcional. Configuração relacionada com o volume raiz aprovisionado para cada máquina do conjunto de nós.

Quando não é especificado, a predefinição é um disco do Azure de 32 GiB.

tags

map (key: string, value: string)

Opcional. Um conjunto de etiquetas a aplicar a todos os recursos do Azure subjacentes para este conjunto de nós. Atualmente, isto inclui apenas conjuntos de dimensionamento de máquinas virtuais.

Especifique, no máximo, 50 pares que contenham carateres alfanuméricos, espaços e símbolos (.+-=_:@/). As chaves podem ter até 127 carateres Unicode. Os valores podem ter até 255 carateres Unicode.

Um objeto que contém uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

imageType

string

Opcional. O tipo de imagem do SO a usar nas instâncias do node pool. Pode não ser especificado ou ter um valor de ubuntu.

Quando não é especificado, o valor predefinido é ubuntu.

sshConfig

object (AzureSshConfig)

Obrigatório. Configuração do SSH para saber como aceder às máquinas do node pool.

proxyConfig

object (AzureProxyConfig)

Opcional. Configuração do proxy para tráfego HTTP(S) de saída.

configEncryption

object (AzureConfigEncryption)

Opcional. Configuração relacionada com a encriptação da configuração de VM.

taints[]

object (NodeTaint)

Opcional. As contaminações iniciais atribuídas aos nós deste conjunto de nós.

labels

map (key: string, value: string)

Opcional. As etiquetas iniciais atribuídas aos nós deste conjunto de nós. Um objeto que contém uma lista de pares "chave": valor. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Um objeto que contém uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

AzureNodePoolAutoscaling

Configuração relacionada com o redimensionador automático de cluster do Kubernetes.

O escalador automático do cluster Kubernetes ajusta automaticamente o tamanho do node pool com base na carga do cluster.

Representação JSON
{
  "minNodeCount": integer,
  "maxNodeCount": integer
}
Campos
minNodeCount

integer

Obrigatório. Número mínimo de nós no conjunto de nós. Tem de ser igual ou superior a 1 e igual ou inferior a maxNodeCount.

maxNodeCount

integer

Obrigatório. Número máximo de nós no conjunto de nós. Tem de ser igual ou superior a minNodeCount e igual ou inferior a 50.

Estado

O estado do ciclo de vida do node pool.

Enumerações
STATE_UNSPECIFIED Não definido.
PROVISIONING O estado PROVISIONING indica que o node pool está a ser criado.
RUNNING O estado RUNNING indica que o node pool foi criado e está totalmente utilizável.
RECONCILING O estado RECONCILING indica que o node pool está a ser reconciliado.
STOPPING O estado STOPPING indica que o node pool está a ser eliminado.
ERROR O estado ERROR indica que o conjunto de nós está num estado danificado irrecuperável.
DEGRADED O estado DEGRADED indica que o conjunto de nós requer a ação do utilizador para restaurar a funcionalidade completa.

AzureNodePoolError

AzureNodePoolError descreve os erros encontrados nos node pools do Azure.

Representação JSON
{
  "message": string
}
Campos
message

string

Descrição do erro de fácil compreensão.

AzureNodeManagement

AzureNodeManagement define o conjunto de funcionalidades de gestão de nós ativadas para um node pool do Azure.

Representação JSON
{
  "autoRepair": boolean
}
Campos
autoRepair

boolean

Opcional. Se os nós vão ser reparados automaticamente ou não. Quando definido como verdadeiro, os nós neste conjunto de nós são monitorizados e, se falharem as verificações de estado de funcionamento de forma consistente durante um período, é acionada uma ação de reparação automática para os substituir por novos nós.

Métodos

create
(deprecated)

Cria um novo AzureNodePool, anexado a um determinado AzureCluster.

delete
(deprecated)

Elimina um recurso AzureNodePool específico.

get
(deprecated)

Descreve um recurso AzureNodePool específico.

list
(deprecated)

Lista todos os recursos AzureNodePool num determinado AzureCluster.

patch
(deprecated)

Atualiza um AzureNodePool.