Cria um cluster ACK, incluindo clusters gerenciados ACK, clusters ACK Serverless, clusters ACK Edge e clusters registrados. Ao criar um cluster, você configura as informações do cluster, os componentes do cluster e os recursos de nuvem relacionados ao ACK.
Descrição da operação
Gerar parâmetros de solicitação do OpenAPI usando o console
Ao chamar a operação CreateCluster para criar um cluster, se a chamada falhar devido a combinações incorretas de parâmetros de solicitação, você pode usar o console para gerar as combinações de parâmetros de solicitação necessárias. Execute as seguintes etapas:
-
Faça login no console do Container Service for Kubernetes (ACK) e escolha Clusters no painel de navegação à esquerda.
-
Na página Clusters, clique em Modelo de cluster.
-
Na caixa de diálogo, selecione o tipo de cluster que deseja criar, clique em Criar e, em seguida, configure as informações do cluster na página de configuração do cluster.
-
Após concluir a configuração, na página Confirmar configuração, clique em Código equivalente no canto superior direito. A caixa de diálogo exibe as combinações de parâmetros necessárias para criar o cluster. Você pode copiá-las e usá-las.
Experimente agora
Testar
Autorização RAM
|
Ação |
Nível de acesso |
Tipo de recurso |
Chave de condição |
Ação dependente |
|
cs:CreateCluster |
create |
*Cluster
|
|
Nenhuma |
Sintaxe da solicitação
POST /clusters HTTP/1.1
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. |
cluster-demo |
access_control_list
deprecated
|
array |
Não |
[Descontinuado] A lista de controle de acesso (ACL) da instância SLB para o servidor de API de um cluster registrado. |
|
|
string |
Não |
A lista de controle de acesso (ACL) da instância SLB para o servidor de API de um cluster registrado. |
192.168.XX.XX/24 |
|
| addons |
array |
Não |
A lista de componentes do cluster. Ao criar um cluster, use addons para especificar os componentes que deseja instalar. Componente de rede: Obrigatório. Dois tipos de rede estão disponíveis: Flannel e Terway. Selecione um ao criar um cluster:
Componente de armazenamento: Opcional. Apenas o tipo csi é suportado: csi: [{"name":"csi-plugin","config": ""},{"name": "csi-provisioner","config": ""}]. Componente de log: Opcional. Recomendamos que você ative este componente. Se você não ativar o serviço de log, não poderá usar o recurso de auditoria do cluster.
Componente Ingress: Opcional. Por padrão, o componente Ingress nginx-ingress-controller é instalado para clusters dedicados ACK.
Event Center: Opcional. Ativado por padrão. O Event Center fornece recursos para armazenar, consultar e alertar sobre eventos do Kubernetes. O Logstore associado ao Kubernetes Event Center é gratuito por 90 dias. Para obter mais informações sobre a política de gratuidade, consulte Criar e usar o Kubernetes Event Center. Exemplo de ativação do Event Center: [{"name":"ack-node-problem-detector","config":"{"sls_project_name":"your_sls_project_name"}"}]. |
|
| addon |
Não |
A lista de componentes do cluster. Ao criar um cluster, use addons para especificar os componentes que deseja instalar. |
||
| api_audiences |
string |
Não |
Uma ServiceAccount é a credencial de acesso usada por um pod para se comunicar com o servidor de API do cluster. O parâmetro api-audiences especifica as identidades de token de solicitação válidas usadas pelo apiserver para autenticar se os tokens de solicitação são válidos. Você pode configurar vários audiences separados por vírgulas (,). Para obter mais informações sobre ServiceAccount, consulte Implantar projeção de volume de token de conta de serviço. |
kubernetes.default.svc |
| audit_log_config |
object |
Não |
A configuração do log de auditoria do cluster. |
|
| enabled |
boolean |
Não |
Especifica se o recurso de log de auditoria do cluster deve ser ativado. Valores válidos:
|
true |
| sls_project_name |
string |
Não |
O SLS Project que contém o Logstore para logs de auditoria do cluster.
|
k8s-log-c2345xxxxxxxxxxxx |
| auto_mode |
object |
Não |
A configuração do modo gerenciado inteligente. |
|
| enable |
boolean |
Não |
Especifica se o modo gerenciado inteligente deve ser ativado. Valores válidos:
|
true |
auto_renew
deprecated
|
boolean |
Não |
[Descontinuado] Especifica se a renovação automática deve ser ativada. Este parâmetro só tem efeito quando charge_type é definido como PrePaid. Valores válidos:
Valor padrão: false. Este parâmetro foi alterado em 15 de outubro de 2024. Para obter mais informações, consulte Aviso sobre alterações de comportamento do parâmetro CreateCluster. |
true |
auto_renew_period
deprecated
|
integer |
Não |
[Descontinuado] O período de renovação automática. Este parâmetro só tem efeito quando o método de cobrança é pré-pago e a renovação automática está ativada. Quando PeriodUnit=Month, valores válidos: {1, 2, 3, 6, 12}. Valor padrão: 1. Este parâmetro foi alterado em 15 de outubro de 2024. Para obter mais informações, consulte Aviso sobre alterações de comportamento do parâmetro CreateCluster. |
1 |
charge_type
deprecated
|
string |
Não |
[Descontinuado] O método de cobrança da instância CLB usada pelo servidor de API. Valor padrão: PostPaid. Valores válidos:
Importante
Para obter mais informações, consulte Aviso sobre alterações de cobrança do Classic Load Balancer (CLB). |
PostPaid |
cis_enabled
deprecated
|
boolean |
Não |
[Descontinuado] Para a configuração do plano de controle do cluster, use o parâmetro security_hardening_os em control_plane_config. Para a configuração do pool de nós, use o parâmetro security_hardening_os em scaling_group no nodepool. |
false |
| client_token |
string |
Não |
O token do cliente. |
0a287651-1277-4c0d-80d2-623a4***** |
cloud_monitor_flags
deprecated
|
boolean |
Não |
[Descontinuado] Para a configuração dos nós do plano de controle do cluster, use o parâmetro cloud_monitor_flags em control_plane_config. Para a configuração do pool de nós, use o parâmetro cms_enabled em kubernetes_config no nodepool. Especifica se o agente do CloudMonitor deve ser instalado no cluster. Valores válidos:
Valor padrão: false. |
false |
| cluster_domain |
string |
Não |
O nome de domínio local do cluster. Regras de nomenclatura: Um nome de domínio consiste em uma ou mais partes separadas por pontos (.). Cada parte pode ter até 63 caracteres e pode conter letras minúsculas, dígitos e hifens (-). Cada parte deve começar e terminar com uma letra minúscula ou dígito. |
cluster.local |
| cluster_spec |
string |
Não |
Após definir cluster_type como ManagedKubernetes e configurar profile, você pode especificar ainda mais a especificação do cluster. Valores válidos:
Pro XL, Pro 2XL e Pro 4XL são três níveis fornecidos pelo Plano de controle provisionado do ACK Pro. Ao pré-alocar e dedicar recursos do plano de controle, esses níveis garantem que a simultaneidade da API e os recursos de agendamento de pods permaneçam em um nível consistentemente alto. Eles são adequados para treinamento e inferência de IA, clusters de ultra grande escala e cargas de trabalho de missão crítica. Para obter informações sobre as taxas de gerenciamento de cluster para as edições Pro e Plano de controle provisionado, consulte Taxa de gerenciamento de cluster. |
ack.pro.small |
| cluster_type |
string |
Não |
Valores válidos:
|
Kubernetes |
| container_cidr |
string |
Não |
O bloco CIDR para pods. Este deve ser um bloco CIDR privado válido, especificamente os seguintes blocos CIDR e suas sub-redes: 10.0.0.0/8, 172.16-31.0.0/12-16 e 192.168.0.0/16. O bloco CIDR não pode se sobrepor ao bloco CIDR da VPC ou aos blocos CIDR usados por clusters Kubernetes existentes na VPC. Você não pode modificar este bloco CIDR após a criação do cluster. Para obter mais informações sobre o planejamento de rede do cluster, consulte Planejar a rede de um cluster gerenciado ACK. Nota
Este parâmetro é obrigatório para clusters Flannel. |
172.20.0.0/16 |
| control_plane_config |
object |
Não |
A configuração do plano de controle para clusters dedicados do ACK. |
|
| auto_renew |
boolean |
Não |
Especifica se a renovação automática deve ser ativada para os nós do plano de controle. Este parâmetro só entra em vigor quando o método de cobrança está definido como PrePaid. Valores válidos:
Valor padrão: true. |
true |
| auto_renew_period |
integer |
Não |
O período de renovação automática para os nós do plano de controle. Valores válidos: {1, 2, 3, 6, 12}. Unidade: meses. Valor padrão: 1. |
1 |
| charge_type |
string |
Não |
O método de cobrança para os nós do plano de controle.
Valor padrão: PostPaid. |
PostPaid |
| cloud_monitor_flags |
boolean |
Não |
Especifica se o CloudMonitor deve ser instalado nos nós.
Valor padrão: false. |
false |
| cpu_policy |
string |
Não |
A política de gerenciamento de CPU do nó.
Valor padrão: none. |
none |
| deploymentset_id |
string |
Não |
O ID do conjunto de implantação. |
ds-bp10b35imuam5amw**** |
| image_id |
string |
Não |
O ID da imagem. |
aliyun_3_x64_20G_alibase_20240819.vhd |
| image_type |
string |
Não |
O tipo de imagem do sistema operacional. |
AliyunLinux3 |
| instance_metadata_options | InstanceMetadataOptions |
Não |
A configuração de acesso aos metadados da instância ECS. |
|
| instance_types |
array |
Não |
Os tipos de instância do nó. |
|
|
string |
Não |
O tipo de instância do nó. |
ecs.g6.large |
|
| key_pair |
string |
Não |
O nome do par de chaves. Você deve definir um entre key_pair e login_password. |
ack |
| login_password |
string |
Não |
A senha de logon SSH. A senha deve ter de 8 a 30 caracteres e conter pelo menos três dos seguintes tipos de caracteres: letras maiúsculas, letras minúsculas, dígitos e caracteres especiais. Você deve definir um entre login_password e key_pair. |
******** |
| node_port_range |
string |
Não |
[Deprecated] O intervalo de portas de serviço do nó. |
30000-32767 |
| period |
integer |
Não |
A duração da assinatura para os nós do plano de controle. Este parâmetro é obrigatório e só entra em vigor quando o método de cobrança está definido como |
1 |
| period_unit |
string |
Não |
A unidade de duração da assinatura para os nós do plano de controle. Este parâmetro é obrigatório e só entra em vigor quando o método de cobrança está definido como |
Month |
| runtime |
string |
Não |
[Deprecated] O nome do runtime para os nós do plano de controle. Valores válidos:\n\ncontainerd: O runtime Containerd, que é suportado por todas as versões do cluster. |
containerd |
| security_hardening_os |
boolean |
Não |
Especifica se o endurecimento de segurança do Alibaba Cloud OS deve ser ativado.\n\n- true: Ativa o endurecimento de segurança do Alibaba Cloud OS.\n\n- false: Desativa o endurecimento de segurança do Alibaba Cloud OS.\n\nValor padrão: false. |
false |
| size |
integer |
Não |
O número de nós do plano de controle.\n\nValores válidos: |
3 |
| soc_enabled |
boolean |
Não |
Especifica se o endurecimento de segurança MLPS deve ser ativado.\n\n- true: Ativa o endurecimento de segurança MLPS 2.0.\n\n- false: Desativa o endurecimento de segurança MLPS 2.0.\n\nValor padrão: false. |
false |
| system_disk_bursting_enabled |
boolean |
Não |
Especifica se o desempenho de pico deve ser ativado para os discos em nuvem do sistema do nó.\n\n- true: Ativado.\n\n- false: Desativado.\n\nEste parâmetro é suportado apenas quando |
true |
| system_disk_category |
string |
Não |
O tipo de disco em nuvem do sistema do nó.\n\n- |
cloud_ssd |
| system_disk_performance_level |
string |
Não |
O nível de desempenho do disco em nuvem do sistema do nó. Este parâmetro só entra em vigor para discos em nuvem ESSD.\n\nO nível de desempenho varia com base no tamanho do disco em nuvem. Para mais informações, consulte Discos em nuvem ESSD. |
PL1 |
| system_disk_provisioned_iops |
integer |
Não |
Os IOPS de leitura/gravação provisionados para os discos em nuvem do sistema do nó.\n\nValores válidos: 0 a min{50.000, 1000 × capacidade - desempenho de linha de base}. Desempenho de linha de base = min{1.800 + 50 × capacidade, 50.000}.\n\nEste parâmetro é suportado apenas quando |
1000 |
| system_disk_size |
integer |
Não |
O tamanho do disco em nuvem do sistema do nó.\n\nValores válidos: [40, 500]. Unidade: GiB.\n\nValor padrão: |
120 |
| system_disk_snapshot_policy_id |
string |
Não |
A política de snapshot automático para os discos em nuvem do sistema do nó. |
sp-2zej1nogjvovnz4z**** |
| control_plane_endpoints_config |
object |
Não |
A configuração de endpoint do cluster. |
|
| internal_dns_config |
object |
Não |
A configuração de DNS interno para o cluster. Este parâmetro se aplica a clusters gerenciados pelo ACK. O nome de domínio interno é usado por componentes do sistema no lado do nó, como kubelet e kube-proxy, para acessar o servidor de API. Se o acesso por nome de domínio interno não estiver ativado, os componentes do sistema no lado do nó acessam o servidor de API por meio do endereço IP do CLB. |
|
| bind_vpcs |
array |
Não |
As VPCs nas quais os registros de DNS interno do cluster entram em vigor. |
|
|
string |
Não |
As VPCs nas quais os registros de DNS interno do cluster entram em vigor. |
vpc-xxxx |
|
| load_balancers_config |
array<object> |
Não |
A configuração de endpoint do cluster. Quando este parâmetro é especificado, os parâmetros endpoint_public_access e load_balancer_id não entram em vigor. O ACK suporta apenas a criação automática de instâncias NLB. Para especificar uma instância CLB ou NLB, use load_balancers_config para especificar o ID da instância correspondente. |
|
|
object |
Não |
A configuração de balanceamento de carga para acesso ao cluster. |
||
| endpoint_type |
string |
Não |
O tipo de endpoint. |
private |
| load_balancer_id |
string |
Não |
O ID da instância NLB. |
nlb-0ogk9aaxxxxxxx |
| controlplane_log_components |
array |
Não |
A lista de nomes de componentes que especifica de quais componentes do plano de controle os logs devem ser coletados.\n\nPor padrão, os logs são coletados do kube-apiserver, kube-controller-manager, kube-scheduler e cloud-controller-manager. |
|
|
string |
Não |
A lista de nomes de componentes que especifica de quais componentes do plano de controle os logs devem ser coletados.\n\nPor padrão, os logs são coletados do kube-apiserver, kube-controller-manager, kube-scheduler e cloud-controller-manager. |
["apiserver","kcm","scheduler"] |
|
| controlplane_log_project |
string |
Não |
O projeto do Simple Log Service para logs dos componentes do plano de controle. Você pode usar um projeto existente para armazenamento de logs, ou o sistema cria automaticamente um projeto. Se você escolher a criação automática, um projeto do Simple Log Service chamado |
k8s-log-xxx |
| controlplane_log_ttl |
string |
Não |
O período de retenção de logs para os logs dos componentes do plano de controle, em dias. |
30 |
cpu_policy
deprecated
|
string |
Não |
[Deprecated] Use o parâmetro |
none |
custom_san
deprecated
|
string |
Não |
[Deprecated] Use o parâmetro |
cs.aliyun.com |
| deletion_protection |
boolean |
Não |
Especifica se a proteção contra exclusão do cluster deve ser ativada, o que impede que o cluster seja excluído acidentalmente no console ou por meio de chamadas de operações de API. Valores válidos:\n\n- |
true |
disable_rollback
deprecated
|
boolean |
Não |
[Deprecated] Quando a criação do cluster falha, nenhuma reversão é executada por padrão. Você deve limpar manualmente o cluster com falha.\n\nEspecifica se o cluster deve ser revertido caso a criação do cluster falhe. Valores válidos:\n\n- |
true |
enable_rrsa
deprecated
|
boolean |
Não |
[Deprecated] Use o parâmetro |
false |
| encryption_provider_key |
string |
Não |
O ID da chave do Key Management Service (KMS) usada para criptografar discos em nuvem. Para obter mais informações, consulte Key Management Service.\n\n> Este recurso entra em vigor apenas em clusters ACK Pro. |
0fe64791-55eb-4fc7-84c5-c6c7cdca**** |
| endpoint_public_access |
boolean |
Não |
Especifica se o acesso à rede pública deve ser ativado. Um Elastic IP Address (EIP) é usado para expor o servidor de API para acesso à rede pública do cluster.\n\n- |
true |
| extra_sans |
array |
Não |
O Nome Alternativo da Entidade (SAN) personalizado para o certificado do servidor de API. |
|
|
string |
Não |
O SAN do certificado. Suporta endereços IP ou nomes de domínio personalizados. |
192.168.xx.xx |
|
format_disk
deprecated
|
boolean |
Não |
[Deprecated] A seleção de nós existentes durante a criação do cluster não é suportada. Para adicionar nós existentes a um cluster, crie primeiro um pool de nós e chame a operação AttachInstancesToNodePool.\n\nEspecifica se os discos de dados devem ser montados em instâncias existentes ao criar um cluster com instâncias existentes. Valores válidos:\n\n- |
false |
image_id
deprecated
|
string |
Não |
[Deprecated] Para a configuração do plano de controle do cluster, use o parâmetro |
m-bp16z7xko3vvv8gt**** |
image_type
deprecated
|
string |
Não |
[Deprecated] Para a configuração do plano de controle do cluster, use o parâmetro |
AliyunLinux |
instances
deprecated
|
array |
Não |
[Deprecated] A seleção de nós existentes durante a criação do cluster não é suportada. Para adicionar nós existentes a um cluster, crie primeiro um pool de nós e chame a operação AttachInstancesToNodePool.\n\n\nA lista de instâncias ECS a serem usadas ao criar um cluster com nós existentes. Essas instâncias são adicionadas ao cluster como nós de trabalho.\n\n> Este campo é obrigatório quando você cria um cluster usando instâncias existentes. |
|
|
string |
Não |
A lista de instâncias ECS a serem usadas ao criar um cluster com nós existentes. Essas instâncias são adicionadas ao cluster como nós de trabalho.\n\n> Este campo é obrigatório quando você cria um cluster usando instâncias existentes. |
i-2ze4zxnm36vq00xn**** |
|
| ip_stack |
string |
Não |
A pilha de protocolos IP do cluster. |
Valores válidos: ipv4 (pilha única) dual (pilha dupla). Valor padrão: ipv4 |
| is_enterprise_security_group |
boolean |
Não |
Especifica se a criação automática de um grupo de segurança avançado deve ser ativada. Este parâmetro entra em vigor quando |
true |
keep_instance_name
deprecated
|
boolean |
Não |
[Deprecated] A seleção de nós existentes durante a criação do cluster não é suportada. Para adicionar nós existentes a um cluster, crie primeiro um pool de nós e chame a operação AttachInstancesToNodePool.\n\nEspecifica se os nomes das instâncias devem ser mantidos ao criar um cluster com instâncias existentes.\n\n- |
true |
key_pair
deprecated
|
string |
Não |
[Deprecated] Para a configuração do plano de controle do cluster, use o parâmetro |
security-key |
| kubernetes_version |
string |
Não |
A versão do cluster, que é consistente com a versão de linha de base da comunidade Kubernetes. Use a versão mais recente. Se você não especificar este parâmetro, a versão mais recente será usada por padrão.\n\nVocê pode criar clusters das três versões mais recentes. Chame a operação DescribeKubernetesVersionMetadata para consultar as versões de cluster suportadas.\n\nPara obter mais informações sobre as versões do Kubernetes suportadas pelo ACK, consulte Visão geral do lançamento de versões do Kubernetes. |
1.32.1-aliyun.1 |
| load_balancer_id |
string |
Não |
O ID da instância do Classic Load Balancer (CLB) usado para acesso ao servidor de API. Se este parâmetro for especificado, a criação automática de um CLB do servidor de API será ignorada.\n> Certifique-se de que a instância do CLB não tenha outras dependências (como listeners ou servidores de backend). Instâncias de CLB compartilhadas e voltadas para a Internet não são suportadas. |
lb-wz9t256gqa3vbouk**** |
load_balancer_spec
deprecated
|
string |
Não |
[Deprecated] O CLB usa cobrança por uso. Este parâmetro não entra em vigor.\n\nA especificação de balanceamento de carga. Valores válidos:\n- slb.s1.small\n- slb.s2.small\n- slb.s2.medium\n- slb.s3.small\n- slb.s3.medium\n- slb.s3.large\n\nValor padrão: |
slb.s2.small |
logging_type
deprecated
|
string |
Não |
[Deprecated] Ativa o serviço de log para o cluster. Este parâmetro entra em vigor apenas para clusters ACK Serverless, e o valor deve ser |
SLS |
login_password
deprecated
|
string |
Não |
[Deprecated] Para a configuração do plano de controle do cluster, use o parâmetro |
null |
| maintenance_window | maintenance_window |
Não |
A janela de O&M do cluster. |
|
master_auto_renew
deprecated
|
boolean |
Não |
[Deprecated] Para a configuração do plano de controle do cluster, use o parâmetro |
true |
master_auto_renew_period
deprecated
|
integer |
Não |
[Deprecated] Para a configuração do plano de controle do cluster, use o parâmetro |
1 |
master_count
deprecated
|
integer |
Não |
[Deprecated] Para a configuração do plano de controle do cluster, use o parâmetro |
3 |
master_instance_charge_type
deprecated
|
string |
Não |
[Deprecated] Para a configuração do plano de controle do cluster, use o parâmetro |
PrePaid |
master_instance_types
deprecated
|
array |
Não |
[Deprecated] Para a configuração do plano de controle do cluster, use o parâmetro |
|
|
string |
Não |
O tipo de instância para um nó mestre. O número de tipos de instância especificados deve corresponder ao valor de |
ecs.n4.xlarge |
|
master_period
deprecated
|
integer |
Não |
[Deprecated] Para a configuração do plano de controle do cluster, use o parâmetro |
1 |
master_period_unit
deprecated
|
string |
Não |
[Deprecated] Para a configuração do plano de controle do cluster, use o parâmetro |
Month |
master_system_disk_category
deprecated
|
string |
Não |
[Deprecated] Para a configuração do plano de controle do cluster, use o parâmetro |
cloud_ssd |
master_system_disk_performance_level
deprecated
|
string |
Não |
[Deprecated] Para a configuração do plano de controle do cluster, use o parâmetro |
PL1 |
master_system_disk_size
deprecated
|
integer |
Não |
[Deprecated] Para a configuração do plano de controle do cluster, use o parâmetro |
120 |
master_system_disk_snapshot_policy_id
deprecated
|
string |
Não |
[Deprecated] Para a configuração do plano de controle do cluster, use o parâmetro |
sp-2zej1nogjvovnz4z**** |
master_vswitch_ids
deprecated
|
array |
Não |
[Deprecated] Use o parâmetro |
|
|
string |
Não |
A lista de IDs de vSwitch para nós mestres. O número de vSwitches deve estar no intervalo de [1, 3]. Para garantir alta disponibilidade, selecione três vSwitches distribuídos em zonas diferentes.\n\nO número de tipos de instância especificados deve corresponder ao valor de master_count e corresponder um a um com os elementos em master_vswitch_ids. |
vsw-2ze3ds0mdip0hdz8i**** |
|
| name |
string |
Sim |
O nome personalizado do cluster. O nome pode conter dígitos, caracteres chineses, letras e hifens (-). Deve ter de 1 a 63 caracteres e não pode começar com um hífen (-). |
cluster-demo |
nat_gateway
deprecated
|
boolean |
Não |
[Deprecated] Use o parâmetro snat_entry em seu lugar. |
true |
| node_cidr_mask |
string |
Não |
O número de endereços IP por nó, determinado pela especificação do bloco CIDR de rede. Este parâmetro entra em vigor apenas para clusters do tipo de rede Flannel.\n\nValor padrão: 26. |
25 |
node_name_mode
deprecated
|
string |
Não |
[Deprecated] Para a configuração do pool de nós, use o parâmetro node_name_mode em kubernetes_config no nodepool em seu lugar. |
null |
node_port_range
deprecated
|
string |
Não |
O intervalo de portas de serviço do nó. Intervalo de portas válido: [30000, 65535].\n\nValor padrão: 30000-32767. |
30000~32767 |
| nodepools |
array |
Não |
A lista de pools de nós. |
|
| nodepool |
Não |
A configuração do pool de nós. |
||
num_of_nodes
deprecated
|
integer |
Não |
[Deprecated] Use o parâmetro desired_size em scaling_group no nodepool em seu lugar.\n\nO número de nós de trabalho. Valores válidos: 0 a 100. |
3 |
| operation_policy |
object |
Não |
A política automática de O&M do cluster. |
|
| cluster_auto_upgrade |
object |
Não |
A configuração de atualização automática do cluster. |
|
| channel |
string |
Não |
A frequência de atualização automática do cluster. Valores válidos:\n- patch: Atualiza automaticamente para a versão de patch mais recente disponível na versão secundária atual. A nova versão do Kubernetes não contém alterações de quebra de compatibilidade.\n- stable: Atualiza automaticamente para a versão de patch mais recente da penúltima versão secundária. A nova versão do Kubernetes pode envolver alterações de API e recursos, mas sua estabilidade foi amplamente validada.\n- rapid: Atualiza automaticamente para a versão de patch mais recente da versão secundária mais recente, permitindo acesso mais rápido aos novos recursos da comunidade Kubernetes. |
stable |
| enabled |
boolean |
Não |
Especifica se a atualização automática do cluster deve ser ativada.\n\n- true: Ativado.\n\n- false: Não ativado. |
true |
os_type
deprecated
|
string |
Não |
[Deprecated] Para a configuração dos nós do plano de controle do cluster, use o parâmetro image_type em control_plane_config em seu lugar. Para a configuração do pool de nós, use o parâmetro image_type em scaling_group no nodepool em seu lugar.\n\nO tipo de plataforma do sistema operacional. Valores válidos:\n- Windows\n- Linux\n\nValor padrão: Linux. |
Linux |
period
deprecated
|
integer |
Não |
[Deprecated]\n\nA duração da assinatura. Este parâmetro entra em vigor e é obrigatório apenas quando charge_type é definido como PrePaid.\n\nValores válidos: 1, 2, 3, 6, 12, 24, 36, 48 e 60.\n\nValor padrão: 1.\n\nEste parâmetro foi alterado em 15 de outubro de 2024. Para mais informações, consulte Aviso sobre alterações de comportamento dos parâmetros da API CreateCluster. |
1 |
period_unit
deprecated
|
string |
Não |
[Deprecated]\n\nO ciclo de cobrança. Este parâmetro é obrigatório quando o método de cobrança é definido como PrePaid.\n\nValores válidos: Month. Atualmente, apenas ciclos de cobrança mensais são suportados.\n\nEste parâmetro foi alterado em 15 de outubro de 2024. Para mais informações, consulte Aviso sobre alterações de comportamento dos parâmetros da API CreateCluster. |
Month |
platform
deprecated
|
string |
Não |
[Deprecated] Para a configuração do pool de nós, use o parâmetro platform em scaling_group no nodepool em seu lugar.\n\nA distribuição do sistema operacional. Valores válidos:\n\n- CentOS\n- AliyunLinux\n- QbootAliyunLinux\n- Qboot\n- Windows\n- WindowsCore\n\nValor padrão: CentOS. |
CentOS |
pod_vswitch_ids
deprecated
|
array |
Não |
[Deprecated] Quando o plugin de rede Terway é selecionado, você deve especificar vSwitches para alocação de endereços IP de Pod. Cada vSwitch de Pod corresponde a um vSwitch de nó de trabalho, e as zonas dos vSwitches de Pod e dos vSwitches de nó de trabalho devem ser as mesmas.\n> A máscara do bloco CIDR do vSwitch de Pod não deve exceder 19 e não deve exceder 25. Caso contrário, o número de endereços IP de Pod disponíveis na rede do cluster será muito limitado, o que afeta as operações normais do cluster. |
|
|
string |
Não |
Quando o plugin de rede Terway é selecionado, você deve especificar vSwitches para alocação de endereços IP de Pod. Cada vSwitch de Pod corresponde a um vSwitch de nó de trabalho, e as zonas dos vSwitches de Pod e dos vSwitches de nó de trabalho devem ser as mesmas.\n> A máscara do bloco CIDR do vSwitch de Pod não deve exceder 19 e não deve exceder 25. Caso contrário, o número de endereços IP de Pod disponíveis na rede do cluster será muito limitado, o que afeta as operações normais do cluster. |
vsw-2ze97jwri7cei0mpw**** |
|
| profile |
string |
Não |
Quando você define cluster_type como ManagedKubernetes para clusters gerenciados ACK, é possível especificar ainda o subtipo do cluster.\n- Default: Cluster gerenciado ACK, incluindo clusters ACK (edições Pro e Basic).\n- Edge: Cluster ACK Edge, incluindo clusters ACK Edge (edições Pro e Basic).\n- Serverless: Cluster ACK Serverless, incluindo clusters ACK Serverless (edições Pro e Basic).\n- Lingjun: Cluster ACK Lingjun, disponível na edição Pro. |
Default |
| proxy_mode |
string |
Não |
O modo kube-proxy.\n\n- iptables: Um modo kube-proxy maduro e estável. A descoberta de serviços e o balanceamento de carga para Serviços do Kubernetes são configurados usando regras iptables. O desempenho é moderado e afetado pela escala. Este modo é adequado para clusters com um pequeno número de Serviços.\n- ipvs: Um modo kube-proxy de alto desempenho. A descoberta de serviços e o balanceamento de carga para Serviços do Kubernetes são configurados usando o módulo IPVS do Linux. Este modo é adequado para clusters com um grande número de Serviços que exigem alto desempenho de balanceamento de carga.\n- nftables: Um modo kube-proxy de última geração que implementa a descoberta de serviços e o balanceamento de carga com base no nftables do Linux. É uma substituição moderna para o iptables. Em comparação com o iptables, o nftables oferece melhor desempenho de rede, atualizações de regras mais eficientes e comportamento aprimorado em cenários de Serviços em grande escala. \nSuportado apenas para clusters executando a versão 1.35 ou posterior. A comunidade Kubernetes descontinuou o IPVS a partir da versão 1.35. Para novos clusters, use nftables para suporte da comunidade a longo prazo.\n\nValor padrão: ipvs. |
ipvs |
rds_instances
deprecated
|
array |
Não |
[Deprecated] Para a configuração do pool de nós, use o parâmetro rds_instances em scaling_group no nodepool em seu lugar.\n\nA lista de instâncias do ApsaraDB RDS às quais você deseja adicionar os nós do cluster à lista de permissões. Adicione o bloco CIDR do Pod do contêiner e o bloco CIDR do nó diretamente à lista de permissões do RDS. A configuração das instâncias do RDS pode falhar se as instâncias não estiverem em estado de execução. |
|
|
string |
Não |
A lista de instâncias do ApsaraDB RDS às quais você deseja adicionar os nós do cluster à lista de permissões. Adicione o bloco CIDR do Pod do contêiner e o bloco CIDR do nó diretamente à lista de permissões do RDS. A configuração das instâncias do RDS pode falhar se as instâncias não estiverem em estado de execução. |
rm-2zev748xi27xc**** |
|
| region_id |
string |
Sim |
O ID da região onde o cluster está implantado. Para mais detalhes, consulte Regiões suportadas pelo serviço de contêiner. |
cn-beijing |
| resource_group_id |
string |
Não |
O ID do grupo de recursos ao qual o cluster pertence. Use este parâmetro para isolar diferentes recursos. |
rg-acfm3mkrure**** |
| rrsa_config |
object |
Não |
A configuração do recurso RAM Roles for Service Accounts (RRSA). |
|
| enabled |
boolean |
Não |
Especifica se o recurso RRSA deve ser ativado.\n\n- true: Ativado.\n\n- false: Não ativado. |
true |
runtime
deprecated
|
runtime |
Não |
O runtime de contêiner usado no cluster. Os runtimes suportados incluem containerd, contêineres em sandbox e Docker.\n> O Kubernetes 1.24 não suporta mais o Docker como um runtime de contêiner integrado.\n\nPara mais informações, consulte Comparação dos runtimes de contêiner Docker, containerd e contêiner em sandbox. |
|
| security_group_id |
string |
Não |
O ID de um grupo de segurança existente. Este parâmetro é mutuamente exclusivo com is_enterprise_security_group. Os nós do cluster são adicionados automaticamente a este grupo de segurança. |
sg-bp1bdue0qc1g7k**** |
security_hardening_os
deprecated
|
boolean |
Não |
[Deprecated] Para a configuração do plano de controle do cluster, use o parâmetro security_hardening_os em control_plane_config em seu lugar. Para a configuração do pool de nós, use o parâmetro security_hardening_os em scaling_group no nodepool em seu lugar.\n\nEspecifica se o endurecimento de segurança do Alibaba Cloud OS deve ser ativado. Valores válidos:\n\n- true: Ativa o endurecimento de segurança do Alibaba Cloud OS.\n- false: Não ativa o endurecimento de segurança do Alibaba Cloud OS.\n\nValor padrão: false. |
false |
| service_account_issuer |
string |
Não |
Uma ServiceAccount é a credencial de acesso usada para comunicação entre um Pod e o API Server do cluster. O service-account-issuer é a identidade do emissor no serviceaccount token, que é o campo iss na token payload.\n\nPara mais informações sobre ServiceAccount, consulte Implantar projeção de volume de token de conta de serviço. |
kubernetes.default.svc |
| service_cidr |
string |
Não |
O bloco CIDR para Serviços. Intervalos válidos: 10.0.0.0/16-24, 172.16-31.0.0/16-24 e 192.168.0.0/16-24. O bloco CIDR não pode se sobrepor ao bloco CIDR da VPC 10.1.0.0/21 ou a blocos CIDR usados por clusters Kubernetes existentes na VPC. Este valor não pode ser modificado após a criação do cluster.\n\nValor padrão: 172.19.0.0/20. |
172.21.0.0/20 |
service_discovery_types
deprecated
|
array |
Não |
[Deprecated] O tipo de descoberta de serviço dentro do cluster, usado para especificar o método de descoberta de serviço em clusters ACK Serverless.\n\n- CoreDNS: Usa o componente padrão de descoberta de serviço nativo do Kubernetes, CoreDNS. Um conjunto de contêineres deve ser implantado no cluster para resolução de DNS. Por padrão, são usadas duas instâncias ECI com especificações de 0,25 Core e 512 MiB.\n- PrivateZone: Usa o Alibaba Cloud PrivateZone para fornecer recursos de descoberta de serviço. O serviço PrivateZone deve ser ativado.\n\nValor padrão: não ativado. |
|
|
string |
Não |
O tipo de descoberta de serviço dentro do cluster, usado para especificar o método de descoberta de serviço em clusters ACK Serverless.
Valor padrão: não ativado. |
PrivateZone |
|
| snat_entry |
boolean |
Não |
As configurações de SNAT para a VPC. Valores válidos:
Nota
Se isso não for ativado durante a criação do cluster e o acesso à Internet for necessário posteriormente, você pode ativá-lo manualmente. Valor padrão: |
false |
soc_enabled
deprecated
|
boolean |
Não |
[Deprecated] Para a configuração dos nós do plano de controle do cluster, use o parâmetro soc_enabled em control_plane_config em vez disso. Para a configuração do pool de nós, use o parâmetro soc_enabled em scaling_group no pool de nós em vez disso. Especifica se o reforço de segurança MLPS 2.0 deve ser ativado. Para mais informações, consulte Conformidade de proteção classificada da China para ACK. Valores válidos:
Valor padrão: |
false |
| ssh_flags |
boolean |
Não |
Especifica se o login SSH público deve ser ativado. Isso é usado para fazer login nos nós mestres de clusters dedicados do ACK. Este parâmetro não entra em vigor para clusters gerenciados.
Valor padrão: |
true |
| tags |
array |
Não |
As tags do nó. Regras de definição de tags:
|
|
| tag |
Não |
As tags do nó. Regras de definição de tags:
|
||
taints
deprecated
|
array |
Não |
[Deprecated] Para a configuração do pool de nós, use o parâmetro taints em kubernetes_config no pool de nós em vez disso. As informações de taint do nó. Taints e tolerâncias trabalham juntos para evitar que os Pods sejam agendados para nós inadequados. Para mais informações, consulte taint-and-toleration. |
|
| taint |
Não |
As informações de taint do nó. Taints e tolerâncias trabalham juntos para evitar que os Pods sejam agendados para nós inadequados. Para mais informações, consulte taint-and-toleration. |
||
timeout_mins
deprecated
|
integer |
Não |
[Deprecated] Por padrão, o sistema não reverte quando a criação do cluster falha. Você deve limpar manualmente o cluster com falha. O período de tempo limite de criação do cluster, em minutos. Valor padrão: |
60 |
| timezone |
string |
Não |
O fuso horário usado pelo cluster. Para mais informações, consulte Fusos horários suportados. |
Asia/Shanghai |
| user_ca |
string |
Não |
A Autoridade de Certificação (CA) personalizada do cluster. |
-----BEGIN CERTIFICATE-----**** |
user_data
deprecated
|
string |
Não |
[Deprecated] Os dados personalizados do nó. |
IyEvdXNyL2Jpbi9iYXNoCmVjaG8gIkhlbGxvIEFD**** |
| vpcid |
string |
Não |
A VPC usada pelo cluster. Você deve fornecer uma VPC ao criar um cluster. |
vpc-2zeik9h3ahvv2zz95**** |
| vswitch_ids |
array |
Não |
Os vSwitches para os nós do cluster. Este parâmetro é obrigatório ao criar um cluster gerenciado com zero nós. |
|
|
string |
Não |
Os vSwitches para os nós do cluster. Este parâmetro é obrigatório ao criar um cluster gerenciado com zero nós. |
vsw-2ze3ds0mdip0hdz8i**** |
|
worker_auto_renew
deprecated
|
boolean |
Não |
[Deprecated] Para a configuração do pool de nós, use o parâmetro auto_renew em scaling_group no pool de nós em vez disso. Especifica se a renovação automática para nós de trabalho deve ser ativada. Este parâmetro entra em vigor apenas quando
Valor padrão: |
true |
worker_auto_renew_period
deprecated
|
integer |
Não |
[Deprecated] Para a configuração do pool de nós, use o parâmetro auto_renew_period em scaling_group no pool de nós em vez disso. O ciclo de renovação automática para nós de trabalho. Este parâmetro entra em vigor e é obrigatório apenas quando o método de cobrança por assinatura é selecionado. Valores válidos: 1, 2, 3, 6 e 12. |
1 |
worker_data_disks
deprecated
|
array<object> |
Não |
[Deprecated] Use o parâmetro data_disks em scaling_group do pool de nós. A combinação de tipo, tamanho e outras configurações de discos em nuvem de dados para nós de trabalho. |
|
|
object |
Não |
O conjunto de configurações de discos em nuvem de dados. |
||
| category |
string |
Sim |
O tipo de disco em nuvem de dados. |
cloud_essd |
| encrypted |
string |
Não |
Especifica se os discos em nuvem de dados devem ser criptografados. Valores válidos:
Valor padrão: |
true |
| performance_level |
string |
Não |
O nível de desempenho dos discos em nuvem de dados do nó. Este parâmetro entra em vigor apenas para discos em nuvem ESSD. |
PL1 |
| size |
string |
Sim |
O tamanho do disco em nuvem de dados. Valores válidos: 40 a 32767. Unidade: GiB. |
120 |
worker_instance_charge_type
deprecated
|
string |
Não |
[Deprecated] Use o parâmetro instance_charge_type em scaling_group do pool de nós. O método de cobrança para nós de trabalho. Valores válidos:
Valor padrão: pós-pago. |
PrePaid |
worker_instance_types
deprecated
|
array |
Não |
[Deprecated] Use o parâmetro instance_types em scaling_group do pool de nós. As configurações de instância para nós de trabalho. |
|
|
string |
Não |
O tipo de instância para nós de trabalho. Especifique pelo menos um tipo de instância. Para mais informações, consulte Famílias de instâncias. Nota
A prioridade de um tipo de instância diminui à medida que sua posição na matriz aumenta. Se uma instância não puder ser criada com base em um tipo de instância de maior prioridade, o sistema usará automaticamente o próximo tipo de instância por ordem de prioridade. |
ecs.n4.large |
|
worker_period
deprecated
|
integer |
Não |
[Deprecated] Use o parâmetro period em scaling_group do pool de nós. A duração da assinatura para nós de trabalho. Este parâmetro entra em vigor e é obrigatório apenas quando Valores válidos: {1, 2, 3, 6, 12, 24, 36, 48, 60}. Valor padrão: 1. |
1 |
worker_period_unit
deprecated
|
string |
Não |
[Deprecated] Use o parâmetro period_unit em scaling_group do pool de nós. O ciclo de cobrança para nós de trabalho. Este parâmetro é obrigatório quando o método de cobrança é Valores válidos: |
Month |
worker_system_disk_category
deprecated
|
string |
Não |
[Deprecated] Use o parâmetro system_disk_category em scaling_group do pool de nós. O tipo de disco em nuvem do sistema para nós de trabalho. Para mais informações, consulte Visão geral do armazenamento em bloco. Valores válidos:
Valor padrão: |
cloud_efficiency |
worker_system_disk_performance_level
deprecated
|
string |
Não |
[Deprecated] Use o parâmetro system_disk_performance_level em scaling_group do pool de nós. Quando o disco em nuvem do sistema é um ESSD, você pode configurar o nível de desempenho (PL) do ESSD. Para mais informações, consulte Discos em nuvem ESSD. Valores válidos:
|
PL1 |
worker_system_disk_size
deprecated
|
integer |
Não |
[Deprecated] Use o parâmetro system_disk_size em scaling_group do pool de nós. O tamanho do disco em nuvem do sistema para nós de trabalho. Unidade: GiB. Valores válidos: [40,500]. O valor deste parâmetro deve ser maior ou igual a max{40, ImageSize}. Valor padrão: |
120 |
worker_system_disk_snapshot_policy_id
deprecated
|
string |
Não |
[Deprecated] Use o parâmetro system_disk_snapshot_policy_id em scaling_group do pool de nós. O ID da política de snapshot automático usada pelos discos em nuvem do sistema dos nós de trabalho. |
sp-2zej1nogjvovnz4z**** |
worker_vswitch_ids
deprecated
|
array |
Não |
[Deprecated] Use o parâmetro vswitch_ids em scaling_group do pool de nós. A lista de vSwitches usados pelos nós do cluster. Cada nó corresponde a um valor. Ao criar um cluster gerenciado com zero nós, o campo |
|
|
string |
Não |
A lista de vSwitches para nós de trabalho. Valores válidos: [1,20]. Para garantir alta disponibilidade, selecione vSwitches em zonas diferentes. Ao criar um cluster gerenciado com zero nós, o campo |
vsw-2ze3ds0mdip0hdz8i**** |
|
zone_id
deprecated
|
string |
Não |
[Deprecated] Use o parâmetro zone_ids. O ID da zona ativa da região à qual o cluster pertence. Este parâmetro é específico para clusters gerenciados do ACK. Ao criar um cluster gerenciado do ACK, se vpc_id e vswitch_ids não forem especificados, você deverá especificar zone_id para que o cluster crie automaticamente uma VPC e recursos de rede relacionados nesta zona. Se vpc_id e vswitch_ids forem especificados, este parâmetro não entrará em vigor. |
cn-beiji**** |
| zone_ids |
array |
Não |
Os IDs de várias zonas na região à qual o cluster pertence. Este parâmetro é específico para clusters gerenciados do ACK. |
|
|
string |
Não |
O ID da zona ativa da região à qual o cluster pertence. Os vSwitches estão sujeitos à criação automática nesta zona. Ao criar um cluster gerenciado do ACK, se vpc_id e vswitch_ids não forem especificados, especifique zone_ids para que o cluster crie automaticamente uma VPC e recursos de rede relacionados em várias zonas ativas. Se vpc_id e vswitch_ids forem especificados, este parâmetro não entrará em vigor. |
cn-beijing-h |
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
O corpo da resposta. |
||
| cluster_id |
string |
O ID do cluster. |
cb95aa626a47740afbf6aa099b650**** |
| request_id |
string |
O ID da solicitação. |
687C5BAA-D103-4993-884B-C35E4314**** |
| task_id |
string |
O ID da tarefa. |
T-5a54309c80282e39ea**** |
Exemplos
Resposta de sucesso
JSON formato
{
"cluster_id": "cb95aa626a47740afbf6aa099b650****",
"request_id": "687C5BAA-D103-4993-884B-C35E4314****",
"task_id": "T-5a54309c80282e39ea****"
}
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.