Atualiza a configuração de um pool de nós com base no ID do pool de nós chamando a operação ModifyClusterNodePool.
Descrição da operação
Experimente agora
Testar
Autorização RAM
|
Ação |
Nível de acesso |
Tipo de recurso |
Chave de condição |
Ação dependente |
|
cs:ModifyClusterNodePool |
update |
*Cluster
|
Nenhuma | Nenhuma |
Sintaxe da solicitação
PUT /clusters/{ClusterId}/nodepools/{NodepoolId} HTTP/1.1
Parâmetros de caminho
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| ClusterId |
string |
Sim |
O ID do cluster. |
c23421cfa74454bc8b37163fd19af**** |
| NodepoolId |
string |
Sim |
O ID do pool de nós. |
p31da1b38983f4511b490fc62108a**** |
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| body |
object |
Não |
Os parâmetros do corpo da solicitação. |
|
| nodepool_info |
object |
Não |
A configuração do pool de nós. |
|
| name |
string |
Não |
O nome do pool de nós. Regras de nomenclatura: O nome deve ter de 1 a 63 caracteres e pode conter dígitos, caracteres chineses, letras e hifens (-). Não pode começar com um hífen (-). |
default-nodepool |
| resource_group_id |
string |
Não |
O ID do grupo de recursos do pool de nós. As instâncias expandidas pelo pool de nós pertencem a este grupo de recursos. |
rg-acfmyvw3wjm**** |
| auto_scaling |
object |
Não |
A configuração de auto scaling. |
|
| enable |
boolean |
Não |
Especifica se o auto scaling deve ser ativado. Valores válidos: |
true |
type
deprecated
|
string |
Não |
O tipo de auto scaling, classificado pelo tipo de instância para auto scaling. Valores válidos: |
cpu |
| max_instances |
integer |
Não |
O número máximo de instâncias que podem ser expandidas no pool de nós, excluindo suas instâncias existentes. Este parâmetro entra em vigor apenas quando |
10 |
| min_instances |
integer |
Não |
O número mínimo de instâncias escaláveis no pool de nós, excluindo suas instâncias existentes. Este parâmetro entra em vigor apenas quando Valores válidos: [0, max_instances]. Valor padrão: 0. Nota
|
2 |
is_bond_eip
deprecated
|
boolean |
Não |
[Descontinuado] Este parâmetro foi descontinuado. Use internet_charge_type e internet_max_bandwidth_out em seu lugar. |
null |
eip_internet_charge_type
deprecated
|
string |
Não |
[Descontinuado] Use internet_charge_type e internet_max_bandwidth_out em seu lugar. |
null |
eip_bandwidth
deprecated
|
integer |
Não |
[Descontinuado] Use internet_charge_type e internet_max_bandwidth_out em vez disso. A largura de banda máxima do EIP. Valores válidos: [1,100]. Unidade: Mbit/s. |
null |
| management |
object |
Não |
A configuração do pool de nós gerenciado. |
|
| enable |
boolean |
Não |
Especifica se o pool de nós gerenciado deve ser ativado. Valores válidos: |
true |
| auto_repair |
boolean |
Não |
Especifica se os nós devem ser reparados automaticamente. Este parâmetro tem efeito apenas quando
Valor padrão: |
true |
| auto_repair_policy |
object |
Não |
A política de reparo automático de nós. |
|
| restart_node |
boolean |
Não |
Especifica se a reinicialização do nó é permitida. Este parâmetro entra em vigor apenas quando |
true |
| approval_required |
boolean |
Não |
Especifica se o reparo do nó requer aprovação manual. |
|
| auto_repair_policy_id |
string |
Não |
O ID da política de reparo automático. |
r-xxxxxxxxxx |
| max_parallel_repairing_nodes |
string |
Não |
O número máximo de nós que podem ser reparados em paralelo. Quando existe um grande número de nós anormais no pool de nós, este parâmetro especifica o número máximo ou a porcentagem de nós que podem ser reparados simultaneamente. Você pode especificar um número (como 5, intervalo válido: 1 a 100000) ou uma porcentagem (como 10%, intervalo válido: 1% a 100%). Valor padrão: 1. |
5 |
| max_unhealthy_nodes_threshold |
string |
Não |
A condição de disjuntor para autorrecuperação. Quando o número ou a porcentagem de nós com falha excede esse limite, a autorrecuperação entra em estado de disjuntor e para de iniciar novas ações de reparo. Você pode especificar um número (como 10, intervalo válido: 1 a 100000) ou uma porcentagem (como 20%, intervalo válido: 1% a 100%). Valor padrão: 100%. |
20% |
| auto_vul_fix |
boolean |
Não |
Especifica se as vulnerabilidades CVE devem ser corrigidas automaticamente. Este parâmetro entra em vigor apenas quando |
true |
| auto_vul_fix_policy |
object |
Não |
A política de correção automática de CVE. |
|
| restart_node |
boolean |
Não |
Especifica se é permitido reiniciar nós. Este parâmetro entra em vigor apenas quando
Valor padrão: |
true |
| vul_level |
string |
Não |
Os níveis de vulnerabilidade permitidos para correção automática, separados por vírgulas. Exemplo: |
asap,nntf |
| exclude_packages |
string |
Não |
Os pacotes a serem excluídos durante a correção de vulnerabilidades. |
kernel |
| auto_upgrade |
boolean |
Não |
Especifica se os nós devem ser atualizados automaticamente. Este parâmetro entra em vigor apenas quando |
true |
| auto_upgrade_policy |
object |
Não |
A política de atualização automática. |
|
| auto_upgrade_kubelet |
boolean |
Não |
Especifica se a atualização automática do kubelet é permitida. Este parâmetro entra em vigor apenas quando |
true |
| auto_upgrade_runtime |
boolean |
Não |
Especifica se a atualização automática do runtime é permitida. Este parâmetro entra em vigor apenas quando |
false |
| auto_upgrade_os |
boolean |
Não |
Especifica se a atualização automática do sistema operacional é permitida. Este parâmetro entra em vigor apenas quando |
false |
upgrade_config
deprecated
|
object |
Não |
[Descontinuado] Use o parâmetro A configuração de atualização automática. Este parâmetro entra em vigor apenas quando |
|
auto_upgrade
deprecated
|
boolean |
Não |
[Descontinuado] Use o parâmetro |
true |
| surge |
integer |
Não |
O número de nós extras. Você pode especificar este parâmetro ou |
5 |
| surge_percentage |
integer |
Não |
A porcentagem de nós extras. Você pode especificar este parâmetro ou |
0 |
| max_unavailable |
integer |
Não |
O número máximo de nós indisponíveis. |
1 |
| auto_fault_diagnosis |
boolean |
Não |
Especifica se a detecção de falhas ECS para autorrecuperação de nós deve ser ativada. |
|
| drift_enabled |
boolean |
Não |
Especifica se a rotação de nós deve ser ativada. Apenas pools de nós gerenciados inteligentes suportam este recurso, e ele está ativado por padrão. Pools de nós comuns não suportam este recurso. |
|
| scaling_group |
object |
Não |
A configuração do grupo de escalonamento do pool de nós. |
|
| vswitch_ids |
array |
Não |
A lista de IDs de vSwitch. Valores válidos: 1 a 8. Nota
Para garantir alta disponibilidade, selecione vSwitches em zonas diferentes. |
|
|
string |
Não |
O ID da vSwitch. |
vsw-wz9uwxhawmtzg7u9h**** |
|
| instance_types |
array |
Não |
A lista de tipos de instância de nó. Você pode selecionar vários tipos de instância como alternativas. Quando cada nó é criado, o sistema tenta adquirir instâncias começando pela primeira especificação até que a criação seja bem-sucedida. O tipo de instância adquirido final pode variar dependendo da disponibilidade de estoque. |
|
|
string |
Não |
O tipo de instância. Para mais informações, consulte Família de instâncias. |
ecs.c6.large |
|
| instance_charge_type |
string |
Não |
O método de cobrança dos nós no pool de nós. Valores válidos: |
PostPaid |
| period |
integer |
Não |
A duração da assinatura dos nós no pool de nós. Este parâmetro entra em vigor e é obrigatório apenas quando |
1 |
| period_unit |
string |
Não |
O ciclo de cobrança dos nós no pool de nós. Este parâmetro entra em vigor e é obrigatório apenas quando |
Month |
| auto_renew |
boolean |
Não |
Especifica se a renovação automática deve ser ativada para os nós. Este parâmetro entra em vigor apenas quando |
true |
| auto_renew_period |
integer |
Não |
A duração de cada ciclo de renovação automática. Valores válidos: |
1 |
| spot_strategy |
string |
Não |
O tipo de instância spot. Valores válidos: |
SpotWithPriceLimit |
| spot_price_limit |
array<object> |
Não |
As configurações de limite de preço para instâncias spot. |
|
|
object |
Não |
As configurações de limite de preço para instâncias spot. |
||
| instance_type |
string |
Não |
O tipo de instância da instância spot. |
ecs.c6.large |
| price_limit |
string |
Não |
O preço máximo de uma única instância. Unidade: USD/hora. |
0.39 |
| image_type |
string |
Não |
O tipo de distribuição do sistema operacional. Recomendamos que você use este parâmetro para especificar o sistema operacional do nó. Valores válidos: |
AliyunLinux3 |
| image_id |
string |
Não |
O ID da imagem personalizada. Você pode chamar |
|
| system_disk_category |
string |
Não |
O tipo do disco em nuvem do sistema do nó. Valores válidos: |
cloud_efficiency |
| system_disk_categories |
array |
Não |
Os vários tipos de disco em nuvem para o disco em nuvem do sistema. Se um tipo de disco em nuvem de maior prioridade estiver indisponível, o sistema tentará automaticamente o próximo tipo de disco em nuvem prioritário para criar o disco em nuvem do sistema. |
|
|
string |
Não |
Os vários tipos de disco em nuvem do sistema para o nó. |
cloud_essd |
|
| system_disk_size |
integer |
Não |
O tamanho do disco em nuvem do sistema do nó. Unidade: GiB. |
120 |
| system_disk_performance_level |
string |
Não |
O nível de desempenho do disco em nuvem do sistema do nó. Este parâmetro entra em vigor apenas para discos em nuvem ESSD. O nível de desempenho está relacionado ao tamanho do disco em nuvem. Para mais informações, consulte Discos em nuvem ESSD. |
PL1 |
| system_disk_encrypted |
boolean |
Não |
Especifica se o disco em nuvem do sistema deve ser criptografado. Valores válidos: |
false |
| system_disk_kms_key_id |
string |
Não |
O ID da chave KMS usado pelo disco em nuvem do sistema. |
0e478b7a-4262-4802-b8cb-00d3fb40**** |
| system_disk_encrypt_algorithm |
string |
Não |
O algoritmo de criptografia usado pelo disco em nuvem do sistema. Valores válidos: aes-256. |
aes-256 |
| system_disk_provisioned_iops |
integer |
Não |
Os IOPS de leitura/gravação provisionados para o disco em nuvem do sistema do nó. |
1000 |
| system_disk_bursting_enabled |
boolean |
Não |
Especifica se o burst (burst de desempenho de E/S) deve ser ativado para o disco em nuvem do sistema do nó. Valores válidos: |
true |
| data_disks |
array |
Não |
As configurações de disco em nuvem de dados para os nós. Valores válidos: 0 a 10. Você pode adicionar até 10 discos em nuvem de dados. |
|
| data_disk |
Não |
A configuração do disco em nuvem de dados para o nó. |
||
| disk_init |
array |
Não |
A configuração de inicialização do dispositivo de bloco. |
|
|
DiskInit |
Não |
A configuração de inicialização do dispositivo de bloco. |
||
| key_pair |
string |
Não |
O nome do par de chaves. Especifique este parâmetro ou |
pro-nodepool |
| login_password |
string |
Não |
A senha de logon SSH. Especifique este parâmetro ou |
Hello1234 |
| internet_charge_type |
string |
Não |
O método de cobrança para endereços IP públicos. Valores válidos: |
PayByBandwidth |
| internet_max_bandwidth_out |
integer |
Não |
A largura de banda de saída máxima para o endereço IP público do nó. Unidade: Mbps (Megabit por segundo). Valores válidos: [1,100]. |
5 |
| tags |
array |
Não |
As tags que são adicionadas apenas às instâncias ECS. |
|
| tag |
Não |
A tag da instância ECS. |
||
| desired_size |
integer |
Não |
O número desejado de nós no pool de nós. |
2 |
| multi_az_policy |
string |
Não |
A política de escalonamento multizona para instâncias ECS no grupo de escalonamento. Valores válidos: |
BALANCE |
| scaling_policy |
string |
Não |
O modo do grupo de escalonamento. Valores válidos: |
release |
| on_demand_base_capacity |
integer |
Não |
O número mínimo de instâncias pay-as-you-go exigidas pelo grupo de escalonamento. Valores válidos: [0,1000]. Instâncias pay-as-you-go são criadas com prioridade quando o número de instâncias pay-as-you-go é menor que este valor. |
0 |
| on_demand_percentage_above_base_capacity |
integer |
Não |
A porcentagem de instâncias pay-as-you-go entre as instâncias que excedem o número mínimo de instâncias pay-as-you-go ( |
20 |
| spot_instance_pools |
integer |
Não |
O número de tipos de instância disponíveis. O grupo de escalonamento cria instâncias spot de maneira otimizada em termos de custos em vários tipos de instância. Valores válidos: [1,10]. |
5 |
| spot_instance_remedy |
boolean |
Não |
Especifica se a suplementação de instâncias spot deve ser ativada. Se ativado, quando uma mensagem do sistema indicando que uma instância spot será recuperada for recebida, o grupo de escalonamento tentará criar uma nova instância para substituir a instância spot prestes a ser recuperada. Valores válidos: |
false |
| compensate_with_on_demand |
boolean |
Não |
Especifica se deve ser permitida a criação automática de instâncias pay-as-you-go para atender ao número necessário de instâncias ECS quando as instâncias spot especificadas não puderem ser criadas devido a motivos como custo ou estoque insuficiente. Este parâmetro entra em vigor apenas quando
|
true |
| enable_high_density_mode |
boolean |
Não |
Especifica se o modo de disco em nuvem de alta densidade deve ser ativado. Isso é suportado apenas quando o pool de nós utiliza tipos de instância. Quando ativado, o número total de discos em nuvem do sistema e discos em nuvem de dados não excede a contagem de discos em nuvem de alta densidade suportada pelo tipo de instância. |
false |
| rds_instances |
array |
Não |
A lista de instâncias RDS. |
|
|
string |
Não |
O ID da instância RDS. Se uma lista de instâncias RDS for especificada, as instâncias ECS dos nós do cluster serão adicionadas automaticamente à lista de permissões do RDS. |
rds-xxx |
|
| private_pool_options |
object |
Não |
A configuração do pool de nós privado. |
|
| id |
string |
Não |
O ID do pool de nós privado. Quando |
eap-bp67acfmxazb4**** |
| match_criteria |
string |
Não |
O tipo do pool de nós privado. A opção de pool privado para o lançamento de instâncias. Após uma garantia de elasticidade ou reserva de capacidade entrar em vigor, um pool privado é gerado para a capacidade reservada, que pode ser selecionado quando as instâncias são lançadas. Valores válidos:
|
Open |
platform
deprecated
|
string |
Não |
[Deprecated] Use o parâmetro |
AliyunLinux |
| instance_patterns |
array |
Não |
As configurações de atributos da instância. |
|
| instance_patterns |
Não |
Os atributos da instância. |
||
| deploymentset_id |
string |
Não |
O conjunto de implantação ao qual as instâncias ECS criadas pelo pool de nós pertencem. Esta configuração entra em vigor apenas para novos nós. O conjunto de implantação dos nós existentes não é alterado. |
ds-bp1d19mmbsv3jf6xxxxx |
| security_group_ids |
array |
Não |
A lista de IDs de grupos de segurança. |
|
|
string |
Não |
O ID do grupo de segurança. |
sg-wz9a8g2mt6x5ll****** |
|
| resource_pool_options |
object |
Não |
O pool de recursos e a estratégia de pool de recursos usados ao criar instâncias. Após definir este parâmetro, observe o seguinte: |
|
| strategy |
string |
Não |
A estratégia de pool de recursos usada quando as instâncias são criadas. Os pools de recursos incluem pools privados gerados após a garantia de elasticidade ou reserva de capacidade entrar em vigor, e pools públicos, que estão disponíveis para a inicialização de instâncias. Valores válidos:
Valor padrão: None. |
PrivatePoolFirst |
| private_pool_ids |
array |
Não |
A lista de IDs de pool privado, que são IDs de garantia de elasticidade ou IDs de reserva de capacidade. Apenas IDs de pool privado no modo Target podem ser especificados para este parâmetro. Valores válidos de N: 1 a 20. |
|
|
string |
Não |
O ID do pool privado, que é o ID de garantia de elasticidade ou o ID de reserva de capacidade. Apenas IDs de pool privado no modo Target podem ser especificados para este parâmetro. |
eap-bp67acfmxazb4**** |
|
| system_disk_snapshot_policy_id |
string |
Não |
A política de snapshot para o disco em nuvem do sistema. |
sp-0jl6xnmme8v7o935**** |
| kubernetes_config |
object |
Não |
A configuração relacionada ao cluster. |
|
| labels |
array |
Não |
Os labels de nó. Você pode adicionar labels aos nós no cluster Kubernetes. Regras de definição de label: |
|
| tag |
Não |
O label de nó. |
||
| taints |
array |
Não |
A configuração de taint do nó. |
|
| taint |
Não |
A configuração de taint do nó. |
||
| runtime |
string |
Não |
O nome do runtime de contêiner. O ACK oferece suporte aos três runtimes de contêiner a seguir.
Valor padrão: containerd. |
containerd |
| runtime_version |
string |
Não |
A versão do runtime de contêiner. |
1.6.38 |
| cpu_policy |
string |
Não |
A política de gerenciamento de CPU para nós. As duas políticas a seguir são suportadas para clusters da versão 1.12.6 ou posterior: |
none |
| unschedulable |
boolean |
Não |
Especifica se os nós adicionados durante o scale-out não são agendáveis. |
false |
| user_data |
string |
Não |
Os dados de usuário da instância. Depois que um nó entra no cluster, o script de dados de usuário especificado é executado. Para mais informações, consulte Scripts de dados de usuário. |
IyEvdXNyL2Jpbi9iYXNoCmVjaG8gIkhlbGxvIEFDSyEi |
| cms_enabled |
boolean |
Não |
Especifica se o agente do CloudMonitor deve ser instalado nos nós ECS. Após a instalação, você pode visualizar informações de monitoramento das instâncias ECS criadas no console do CloudMonitor. Recomendamos que você ative esse recurso. Valores válidos:
Valor padrão: |
true |
| pre_user_data |
string |
Não |
Os pré-dados de usuário da instância. Antes de um nó entrar no cluster, o script de pré-dados de usuário especificado é executado. Para mais informações, consulte Scripts de dados de usuário. |
IyEvdXNyL2Jpbi9iYXNoCmVjaG8gIkhlbGxvIEFDSyEi |
| node_name_mode |
string |
Não |
O parâmetro de nome de nó personalizado. Um nome de nó consiste em três partes: prefixo + endereço IP do nó + sufixo. |
customized,aliyun,ip,com |
| tee_config |
object |
Não |
A configuração do cluster de computação confidencial. |
|
| tee_enable |
boolean |
Não |
Especifica se o cluster de computação confidencial deve ser ativado. Valores válidos:
Valor padrão: |
false |
| update_nodes |
boolean |
Não |
Especifica se os labels e taints de nó devem ser atualizados sincronizadamente. |
true |
| concurrency |
boolean |
Não |
Especifica se a concorrência deve ser ativada. |
true |
| eflo_node_group |
object |
Não |
A configuração do pool de nós Lingjun. (Não efetivo) |
|
| auto_attach_enabled |
string |
Não |
Especifica se a adição automática para o pool de nós Lingjun deve ser ativada. (Não efetivo) |
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
Os dados do corpo da resposta. |
||
| task_id |
string |
O ID da tarefa. |
T-5fd211e924e1d00787000293 |
| nodepool_id |
string |
O ID do pool de nós. |
np737c3ac1ac684703b9e10673aa2c**** |
| request_id |
string |
O ID da solicitação. |
687C5BAA-D103-4993-884B-C35E4314**** |
Exemplos
Resposta de sucesso
JSON formato
{
"task_id": "T-5fd211e924e1d00787000293",
"nodepool_id": "np737c3ac1ac684703b9e10673aa2c****",
"request_id": "687C5BAA-D103-4993-884B-C35E4314****"
}
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.