REST Resource: projects.locations.awsClusters.awsNodePools

{
  "name": string,
  "version": string,
  "config": {
    object (AwsNodeConfig)
  },
  "autoscaling": {
    object (AwsNodePoolAutoscaling)
  },
  "subnetId": string,
  "state": enum (State),
  "uid": string,
  "reconciling": boolean,
  "createTime": string,
  "updateTime": string,
  "etag": string,
  "annotations": {
    string: string,
    ...
  },
  "maxPodsConstraint": {
    object (MaxPodsConstraint)
  },
  "errors": [
    {
      object (AwsNodePoolError)
    }
  ],
  "management": {
    object (AwsNodeManagement)
  },
  "updateSettings": {
    object (UpdateSettings)
  }
}

string

O nome desse recurso.

Os nomes dos pools de nós são formatados como projects/<project-number>/locations/<region>/awsClusters/<cluster-id>/awsNodePools/<node-pool-id>.

Para mais detalhes sobre nomes de recursos do Google Cloud, consulte este link.

string

Obrigatório. A versão do Kubernetes a ser executada nesse pool de nós (por exemplo, 1.19.10-gke.1000).

É possível listar todas as versões compatíveis em uma determinada região do Google Cloud chamando locations.getAwsServerConfig.

object (AwsNodeConfig)

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

object (AwsNodePoolAutoscaling)

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

string

Obrigatório. A sub-rede em que o nó do pool de nós é executado.

enum (State)

Apenas saída. O ciclo de vida atual do pool de nós.

string

Apenas saída. Um identificador globalmente exclusivo para o pool de nós.

boolean

Apenas saída. Se definido, há mudanças em andamento no pool de nós.

string (Timestamp format)

Apenas saída. A hora em que este pool de nós foi criado.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

Apenas saída. A hora em que este pool de nós foi atualizado pela última vez.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

string

Permite que os clientes realizem leituras e modificações da gravação consistentes por meio do controle otimista de simultaneidade.

Pode ser enviado em solicitações de atualização e exclusão para garantir que o cliente tenha um valor atualizado antes de prosseguir.

map (key: string, value: string)

Opcional. Anotações no pool de nós.

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

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

object (MaxPodsConstraint)

Obrigatório. A restrição sobre o número máximo de pods que podem ser executados simultaneamente em um nó no pool de nós.

object (AwsNodePoolError)

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

object (AwsNodeManagement)

Opcional. A configuração de gerenciamento desse pool de nós.

object (UpdateSettings)

Opcional. As configurações de atualização controlam a velocidade e a interrupção da atualização.

{
  "instanceType": string,
  "rootVolume": {
    object (AwsVolumeTemplate)
  },
  "taints": [
    {
      object (NodeTaint)
    }
  ],
  "labels": {
    string: string,
    ...
  },
  "tags": {
    string: string,
    ...
  },
  "iamInstanceProfile": string,
  "imageType": string,
  "sshConfig": {
    object (AwsSshConfig)
  },
  "securityGroupIds": [
    string
  ],
  "proxyConfig": {
    object (AwsProxyConfig)
  },
  "configEncryption": {
    object (AwsConfigEncryption)
  },
  "instancePlacement": {
    object (AwsInstancePlacement)
  },
  "autoscalingMetricsCollection": {
    object (AwsAutoscalingGroupMetricsCollection)
  },
  "spotConfig": {
    object (SpotConfig)
  }
}

string

Opcional. O tipo de instância EC2 ao criar instâncias por demanda.

Se não for especificado durante a criação do pool de nós, um padrão será escolhido com base na versão do pool de nós e atribuído a esse campo.

object (AwsVolumeTemplate)

Opcional. Modelo do volume raiz provisionado para os nós do pool de nós. Os volumes serão provisionados na zona de disponibilidade atribuída à sub-rede do pool de nós.

Quando não especificado, o padrão é 32 GiB com o tipo de volume GP2.

object (NodeTaint)

Opcional. Os taints iniciais atribuídos aos nós deste pool.

map (key: string, value: string)

Opcional. Os identificadores iniciais atribuídos aos nós deste pool. Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

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

map (key: string, value: string)

Opcional. Metadados de chave-valor a serem atribuídos a cada recurso subjacente da AWS. Especifique no máximo 50 pares contendo caracteres alfanuméricos, espaços e símbolos (.+-=_:@/). As chaves podem ter até 127 caracteres Unicode. Os valores podem ter até 255 caracteres Unicode.

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

string

Obrigatório. O nome ou ARN do perfil da instância do IAM da AWS a ser atribuído aos nós no pool.

string

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

Quando não especificado, o padrão é ubuntu.

object (AwsSshConfig)

Opcional. A configuração do SSH.

string

Opcional. Os códigos de grupos de segurança extras a serem adicionados aos nós neste pool. O gerente vai criar automaticamente grupos de segurança com regras mínimas necessárias para um cluster em funcionamento.

object (AwsProxyConfig)

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

object (AwsConfigEncryption)

Obrigatório. Criptografia de configuração para dados do usuário.

object (AwsInstancePlacement)

Opcional. Informações relacionadas ao posicionamento desse nó. Quando não especificado, o locatário padrão da VPC será usado.

object (AwsAutoscalingGroupMetricsCollection)

Opcional. Configuração relacionada à coleta de métricas do CloudWatch no grupo de escalonamento automático do pool de nós.

Quando não for especificada, a coleta de métricas será desativada.

object (SpotConfig)

Opcional. Configuração para provisionar instâncias spot do EC2

Quando especificado, o pool de nós provisionará instâncias spot do conjunto de spotConfig.instance_types. Esse campo é mutuamente exclusivo com instanceType.

{
  "granularity": string,
  "metrics": [
    string
  ]
}

string

Obrigatório. A frequência com que o EC2 Auto Scaling envia dados agregados para o AWS CloudWatch. O único valor válido é "1Minute".

string

Opcional. As métricas a serem ativadas. Para ver uma lista de métricas válidas, consulte https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_EnableMetricsCollection.html (em inglês). Se você especificar a granularidade e não especificar alguma métrica, todas as métricas serão ativadas.

{
  "instanceTypes": [
    string
  ]
}

string

Obrigatório. Uma lista de tipos de instância para criar um pool de nós spot.

{
  "minNodeCount": integer,
  "maxNodeCount": integer
}

integer

Obrigatório. O número mínimo de nós no pool. Precisa ser maior ou igual a 1 e menor ou igual a maxNodeCount.

integer

Obrigatório. O número máximo de nós no pool. Precisa ser maior ou igual a minNodeCount e menor ou igual a 50.

{
  "message": string
}

string

Descrição do erro legível por humanos.

{
  "autoRepair": boolean
}

boolean

Opcional. Define se os nós serão ou não reparados automaticamente. Quando está definido como verdadeiro, os nós nesse pool de nós são monitorados. Se eles falharem de forma consistente nas verificações de integridade durante um período, uma ação de reparo automático será acionada para substituí-los por novos nós.

{
  "surgeSettings": {
    object (SurgeSettings)
  }
}

object (SurgeSettings)

Opcional. Configurações para atualização súbita.

{
  "maxSurge": integer,
  "maxUnavailable": integer
}

integer

Opcional. O número máximo de nós que podem ser criados além do tamanho atual do pool de nós durante o processo de atualização.

integer

Opcional. O número máximo de nós que podem estar indisponíveis simultaneamente durante o processo de atualização. Um nó é considerado indisponível quando o status não é "Ready".