CreateClusterNodePool - ENS: Central de Documentação do Alibaba Cloud

Cria um node pool para um cluster. Um node pool é uma coleção lógica de nós que compartilham os mesmos atributos, permitindo gerenciamento unificado e operações de O&M, como atualizações de nós e escalonamento elástico. Você também pode utilizar os recursos de O&M automatizado dos node pools, incluindo correção automática de vulnerabilidades CVE do SO, recuperação automática de nós com falha e atualizações automáticas das versões do kubelet e containerd, para reduzir os custos de O&M.

Descrição da operação

Frequência de chamadas por usuário único: 10 chamadas por segundo.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

ens:CreateClusterNodePool

create

*Todos os recursos.

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ClusterId	string	Sim	O ID do cluster.	eck-xxxxxxxx
NodepoolInfo	object	Sim	A configuração do node pool.
Name	string	Sim	O nome do node pool.	test1
ScalingGroup	object	Sim	A configuração do grupo de escalonamento.
DesiredSize	integer	Não	O número desejado de instâncias.	3
KeyPairName	string	Não	O par de chaves da instância. Este parâmetro é mutuamente exclusivo com a senha.	key-pair-name
VswitchIds	array	Sim	Os vSwitches usados pelas instâncias.
	string	Não	O ID do vSwitch para os nós do cluster. A região ENS do vswitch_ids deve ser igual ao valor de ens_region_id.	vsw-58eu2p6v64qw8ihhit1wz7wgv
InstanceChargeType	string	Não	O tipo de cobrança da instância. Valores válidos: PostPaid : pago conforme o uso. PrePaid : assinatura.	PostPaid
InstanceTypes	array	Sim	A lista de tipos de instância para os nós no node pool.
	string	Não	O tipo de instância.	ens.sn1.small
SystemDiskCategory	string	Não	O tipo do disco em nuvem do sistema. Valores válidos: local_ssd, local_hdd, cloud_efficiency e cloud_ssd. Valores válidos: cloud_efficiency : disco em nuvem ultra. cloud_ssd : disco em nuvem SSD. local_hdd : HDD local. local_ssd : SSD local.	cloud_efficiency
SystemDiskSize	integer	Não	O tamanho do disco em nuvem do sistema. Unidade: GB. Valor mínimo: 20. O valor deve ser um múltiplo de 10.	80
ImageId	string	Sim	O ID da imagem da instância.	m-6734fzvcwcv2o8jj201cpa7ox
DataDisks	array<object>	Não	O tamanho dos discos em nuvem de dados.
	object	Não	O tipo de disco em nuvem.
Category	string	Não	O tipo de disco em nuvem. Valores válidos: cloud_efficiency : disco em nuvem ultra. cloud_ssd : disco em nuvem SSD. local_hdd : HDD local. local_ssd : SSD local.	cloud_efficiency
Size	integer	Não	O tamanho do disco em nuvem de dados. Unidade: GB. Valor mínimo: 20. O valor tem incrementos de 10.	80
Password	string	Não	A senha usada quando o node pool cria instâncias. Este parâmetro é mutuamente exclusivo com o par de chaves.	some-test-password
KubernetesConfig	object	Não	A configuração relacionada ao cluster.
PreUserData	string	Não	O script que é executado após a criação da máquina e antes de ela ingressar no cluster. O conteúdo deve ser codificado em Base64.	ZWNobyBvawo=
UserData	string	Não	O script que é executado após a criação da máquina e após ela ingressar no cluster. O conteúdo deve ser codificado em Base64.	ZWNobyBvawo=

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Esquema da resposta.
Nodepool	object	A configuração do node pool.
ClusterId	string	O ID da instância.	eck-d2666c5f
NodepoolInfo	object	As informações do pool de nós.
Name	string	O nome do pool de nós.	test1
EnsRegionId	string	O ID da região ENS onde o cluster está localizado.	cn-guiyang-14
NodepoolId	string	O ID do pool de nós.	np1176939548ac49e59febe82dcbf1ad56
ScalingGroup	object	O ID do grupo de recursos ao qual o novo grupo de escalonamento pertence. Nota O novo grupo de escalonamento é atribuído ao grupo de recursos especificado. Se esse parâmetro não for especificado, o grupo de escalonamento será atribuído ao grupo de recursos padrão.
VswitchIds	array	Os IDs dos VSwitches para os nós do cluster.
	string	O ID do VSwitch.	vsw-58eu2p6v64qw8ihhit1wz7wgv
DataDisks	array<object>	Informações sobre os discos de dados para os nós.
	object	Informações sobre um disco de dados.
Category	string	A categoria do disco de dados.	cloud_efficiency
Size	integer	O tamanho do disco de dados, em GB.	80
InstanceChargeType	string	O método de cobrança das instâncias.	PrePaid
InstanceTypes	array	Os tipos de instância para os nós no pool de nós.
	string	Um tipo de instância.	ens.sn1.small
SystemDiskCategory	string	A categoria do disco do sistema.	cloud_efficiency
SystemDiskSize	integer	O tamanho do disco do sistema, em GB.	80
ImageId	string	O ID da imagem usada para os nós.	m-67bdk1kpu1ylmt7k33h5dbiov
KeyPairName	string	O nome do par de chaves.	key-pair-name
Password	string	A senha de login para as instâncias.	**********
KubernetesConfig	object	A configuração relacionada ao Kubernetes.
PreUserData	string	Um script codificado em Base64 que é executado em uma instância após a criação, mas antes de o nó ingressar no cluster.	ZWNobyBvawo=
UserData	string	Um script codificado em Base64 que é executado em uma instância após ela ingressar no cluster.	ZWNobyBvawo=
Status	object	As informações de status do pool de nós.
State	string	O estado do pool de nós. Valores válidos: active: O pool de nós está ativo. scaling: O pool de nós está escalando para fora. removing_nodes: O pool de nós está escalando para dentro.	active
TotalNodes	integer	O número total de instâncias no pool de nós. Isso inclui instâncias que estão sendo criadas, estão em serviço ou estão sendo removidas.	10
DesiredNodes	integer	O número desejado de instâncias.	10
ServingNodes	integer	O número de instâncias que estão em serviço.	10
InitialNodes	integer	O número de instâncias que estão sendo criadas.	0
RemovingNodes	integer	O número de instâncias que estão sendo removidas.	0
FailedNodes	integer	O número de instâncias com falha.	0
RequestId	string	O ID da solicitação.	C0003E8B-B930-4F59-ADC0-0E209A9012A8

Exemplos

Resposta de sucesso

JSON formato

{
  "Nodepool": {
    "ClusterId": "eck-d2666c5f",
    "NodepoolInfo": {
      "Name": "test1",
      "EnsRegionId": "cn-guiyang-14",
      "NodepoolId": "np1176939548ac49e59febe82dcbf1ad56"
    },
    "ScalingGroup": {
      "VswitchIds": [
        "vsw-58eu2p6v64qw8ihhit1wz7wgv"
      ],
      "DataDisks": [
        {
          "Category": "cloud_efficiency",
          "Size": 80
        }
      ],
      "InstanceChargeType": "PrePaid",
      "InstanceTypes": [
        "ens.sn1.small"
      ],
      "SystemDiskCategory": "cloud_efficiency",
      "SystemDiskSize": 80,
      "ImageId": "m-67bdk1kpu1ylmt7k33h5dbiov",
      "KeyPairName": "key-pair-name",
      "Password": "**********"
    },
    "KubernetesConfig": {
      "PreUserData": "ZWNobyBvawo=",
      "UserData": "ZWNobyBvawo="
    },
    "Status": {
      "State": "active",
      "TotalNodes": 10,
      "DesiredNodes": 10,
      "ServingNodes": 10,
      "InitialNodes": 0,
      "RemovingNodes": 0,
      "FailedNodes": 0
    }
  },
  "RequestId": "C0003E8B-B930-4F59-ADC0-0E209A9012A8"
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.