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 de API 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 de 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 configurar alertas para 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 legítimos. Você pode configurar múltiplos 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.
|
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.
|
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 a assinatura e a renovação automática são selecionadas. 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 para o 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 |
|
Kubernetes |
| container_cidr |
string |
Não |
O bloco CIDR da rede do pod. 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. Ele não pode se sobrepor aos blocos CIDR usados pela VPC ou clusters Kubernetes existentes na VPC. Este valor não pode ser modificado após a criação do cluster. Para obter mais informações sobre o planejamento de rede do cluster, consulte Planejamento de rede do 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 especificar este parâmetro ou login_password. |
ack |
| login_password |
string |
Não |
A senha de login 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 especificar este parâmetro ou 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 PrePaid. Valores válidos: {1, 2, 3, 6, 12, 24, 36, 48, 60}. Unidade: meses. Valor padrão: 1. |
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 PrePaid. Valor válido: Month. Atualmente, apenas ciclos de cobrança mensais são suportados. |
Month |
| runtime |
string |
Não |
[Deprecated] O nome do runtime para os nós do plano de controle. Valores válidos: containerd: O runtime Containerd, que suporta todas as versões do cluster. |
containerd |
| security_hardening_os |
boolean |
Não |
Especifica se o reforço de segurança do Alibaba Cloud OS deve ser ativado.
Valor padrão: false. |
false |
| size |
integer |
Não |
O número de nós do plano de controle. Valores válidos: 3 ou 5. |
3 |
| soc_enabled |
boolean |
Não |
Especifica se o reforço de segurança MLPS deve ser ativado.
Valor 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ó.
Este parâmetro é suportado apenas quando system_disk_category está definido como cloud_auto. |
true |
| system_disk_category |
string |
Não |
O tipo de disco em nuvem do sistema do nó.
Valor padrão: cloud_ssd. O valor padrão pode variar de acordo com a zona. |
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. O 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ó. Valores válidos: 0 a min{50.000, 1000 × capacidade - desempenho de linha de base}. Desempenho de linha de base = min{1.800 + 50 × capacidade, 50000}. Este parâmetro é suportado apenas quando system_disk_category está definido como cloud_auto. |
1000 |
| system_disk_size |
integer |
Não |
O tamanho do disco em nuvem do sistema do nó. Valores válidos: [40, 500]. Unidade: GiB. Valor padrão: 120. |
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. Por 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. Por 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 permitir que o sistema crie um projeto automaticamente. Se você escolher a criação automática, um projeto do Simple Log Service chamado k8s-log-{ClusterID} será criado. |
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 cpu_policy em control_plane_config para a configuração do plano de controle do cluster, ou use o parâmetro cpu_policy em kubernetes_config no nodepool para a configuração do pool de nós. A política de gerenciamento de CPU do nó. As seguintes políticas são suportadas para clusters executando a versão 1.12.6 ou posterior:
Valor padrão: none. |
none |
custom_san
deprecated
|
string |
Não |
[Deprecated] Use o parâmetro extra_sans em seu lugar. O Nome Alternativo do Assunto (SAN) do certificado personalizado. Separe vários endereços IP ou nomes de domínio com vírgulas (,). |
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:
Valor padrão: false. |
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. Especifica se o cluster deve ser revertido caso a criação do cluster falhe. Valores válidos:
Valor padrão: true. |
true |
enable_rrsa
deprecated
|
boolean |
Não |
[Deprecated] Use o parâmetro rrsa_config em seu lugar. Especifica se o recurso RRSA deve ser ativado.
|
false |
| encryption_provider_key |
string |
Não |
O ID da chave do Key Management Service (KMS) usada para criptografar discos em nuvem. Para mais informações, consulte Key Management Service. Nota
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 público ao 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 image_id em control_plane_config em seu lugar. Para a configuração do pool de nós, use o parâmetro image_id em scaling_group em nodepool em seu lugar.\n\nA imagem personalizada para os nós. A imagem do sistema é usada por padrão. Quando uma imagem personalizada é selecionada, ela substitui a imagem padrão do sistema. Para mais informações, consulte Imagens personalizadas. |
m-bp16z7xko3vvv8gt**** |
image_type
deprecated
|
string |
Não |
[Deprecated] Para a configuração 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 em nodepool em seu lugar.\n\nO tipo de distribuição do sistema operacional. Recomendamos que você use este campo para especificar o sistema operacional do nó. Valores válidos:\n\n- CentOS\n- AliyunLinux\n- AliyunLinux Qboot\n- AliyunLinuxUEFI\n- AliyunLinux3\n- Windows\n- WindowsCore\n- AliyunLinux3Arm64\n- ContainerOS\n\nValor padrão: |
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 com 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 com instâncias existentes. |
i-2ze4zxnm36vq00xn**** |
|
| ip_stack |
string |
Não |
A pilha de protocolos IP do cluster. |
Valores válidos:\nipv4 (pilha única)\ndual (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 security_group_id está vazio.\n\n> Quando um grupo de segurança básico é usado, o número total de nós e pods Terway no cluster não pode exceder 2.000. Portanto, ao criar um cluster do tipo de rede Terway, use um grupo de segurança avançado.\n\n- |
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 key_pair em control_plane_config em seu lugar. Para a configuração do pool de nós, use o parâmetro key_pair em scaling_group em nodepool em seu lugar.\n\nO nome do par de chaves. Mutuamente exclusivo com login_password. |
security-key |
| kubernetes_version |
string |
Não |
A versão do cluster, que está alinhada 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 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) usada para acesso ao servidor de API. Se este parâmetro for especificado, a criação automática de uma instância CLB do servidor de API será ignorada.\n> Certifique-se de que a instância CLB não tenha outras dependências (como listeners ou servidores de backend). Instâncias 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 login_password em control_plane_config em seu lugar. Para a configuração do pool de nós, use o parâmetro login_password em scaling_group em nodepool em seu lugar.\n\nA senha de logon SSH. Mutuamente exclusiva com key_pair. 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. |
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 auto_renew em control_plane_config em seu lugar.\n\nEspecifica se a renovação automática para nós mestres deve ser ativada. Este parâmetro entra em vigor apenas quando master_instance_charge_type é definido como |
true |
master_auto_renew_period
deprecated
|
integer |
Não |
[Deprecated] Para a configuração do plano de controle do cluster, use o parâmetro auto_renew_period em control_plane_config em seu lugar.\n\nA época de renovação automática para nós mestres. Este parâmetro entra em vigor e é obrigatório apenas quando o método de cobrança por assinatura é selecionado.\n\nValores válidos: {1, 2, 3, 6, 12}.\n\nValor padrão: 1. |
1 |
master_count
deprecated
|
integer |
Não |
[Deprecated] Para a configuração do plano de controle do cluster, use o parâmetro size em control_plane_config em seu lugar.\n\nO número de nós mestres. Valores válidos: |
3 |
master_instance_charge_type
deprecated
|
string |
Não |
[Deprecated] Para a configuração do plano de controle do cluster, use o parâmetro instance_charge_type em control_plane_config em seu lugar.\n\nO método de cobrança para nós mestres. Valores válidos:\n\n- |
PrePaid |
master_instance_types
deprecated
|
array |
Não |
[Deprecated] Para a configuração do plano de controle do cluster, use o parâmetro instance_types em control_plane_config em seu lugar.\n\nOs tipos de instância para nós mestres. Para mais informações, consulte Famílias de instâncias. |
|
|
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 master_count e corresponder um a um com os elementos em master_instance_types. Para mais informações, consulte Famílias de instâncias. |
ecs.n4.xlarge |
|
master_period
deprecated
|
integer |
Não |
[Deprecated] Para a configuração do plano de controle do cluster, use o parâmetro unit em control_plane_config em seu lugar.\n\nA duração da assinatura para nós mestres. Este parâmetro entra em vigor e é obrigatório apenas quando master_instance_charge_type é definido como |
1 |
master_period_unit
deprecated
|
string |
Não |
[Deprecated] Para a configuração do plano de controle do cluster, use o parâmetro period_unit em control_plane_config em seu lugar.\n\nA unidade do período de cobrança para nós mestres. Este parâmetro é obrigatório quando o método de cobrança é |
Month |
master_system_disk_category
deprecated
|
string |
Não |
[Deprecated] Para a configuração do plano de controle do cluster, use o parâmetro system_disk_category em control_plane_config em seu lugar.\n\nO tipo de disco em nuvem do sistema para nós mestres. Valores válidos:\n\n- |
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 system_disk_performance_level em control_plane_config em seu lugar.\n\nO nível de desempenho do disco em nuvem do sistema para nós mestres. Este parâmetro entra em vigor apenas para discos em nuvem ESSD. O nível de desempenho está relacionado ao tamanho do disco. Para mais informações, consulte Discos em nuvem ESSD. |
PL1 |
master_system_disk_size
deprecated
|
integer |
Não |
[Deprecated] Para a configuração do plano de controle do cluster, use o parâmetro system_disk_size em control_plane_config em seu lugar.\n\nO tamanho do disco em nuvem do sistema para nós mestres. Valores válidos: [40,500]. Unidade: GiB.\n\nValor padrão: |
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 system_disk_snapshot_policy_id em control_plane_config em seu lugar.\n\nO ID da política de snapshot automático para discos em nuvem do sistema de nós mestres. |
sp-2zej1nogjvovnz4z**** |
master_vswitch_ids
deprecated
|
array |
Não |
[Deprecated] Use o parâmetro vswitch_ids em seu lugar.\n\nA 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. |
|
|
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 (-). O nome 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 |
[Descontinuado] 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: |
25 |
node_name_mode
deprecated
|
string |
Não |
[Descontinuado] Para a configuração do pool de nós, use o parâmetro node_name_mode em kubernetes_config em 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 |
| 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 |
[Descontinuado] 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 disruptivas.\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 |
[Descontinuado] 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 |
period
deprecated
|
integer |
Não |
[Descontinuado]\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 |
[Descontinuado]\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 |
[Descontinuado] 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 |
pod_vswitch_ids
deprecated
|
array |
Não |
[Descontinuado] Quando você seleciona o Terway como plugin de rede, é necessário atribuir vSwitches para alocar endereços IP aos pods. Cada vSwitch de pod corresponde a um vSwitch de nó de trabalho, e o vSwitch de pod deve estar na mesma zona que o vSwitch do nó de trabalho correspondente.\n> A máscara do bloco CIDR do vSwitch de pod não deve exceder 19 e não deve ultrapassar 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 você seleciona o Terway como plugin de rede, é necessário atribuir vSwitches para alocar endereços IP aos pods. Cada vSwitch de pod corresponde a um vSwitch de nó de trabalho, e o vSwitch de pod deve estar na mesma zona que o vSwitch do nó de trabalho correspondente.\n> A máscara do bloco CIDR do vSwitch de pod não deve exceder 19 e não deve ultrapassar 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 |
Default |
| proxy_mode |
string |
Não |
O modo do kube-proxy.\n\n- |
ipvs |
rds_instances
deprecated
|
array |
Não |
[Descontinuado] 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. Selecione as instâncias do RDS que deseja adicionar à 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. Selecione as instâncias do RDS que deseja adicionar à 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 obter 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 |
sg-bp1bdue0qc1g7k**** |
security_hardening_os
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 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 SO do Alibaba Cloud deve ser ativado. Valores válidos:\n\n- |
false |
| service_account_issuer |
string |
Não |
Uma ServiceAccount é a credencial de acesso usada por um pod para se comunicar com o servidor de API do cluster. O |
kubernetes.default.svc |
| service_cidr |
string |
Não |
O bloco CIDR para a rede do serviço. 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 aos 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 |
[Descontinuado] O tipo de descoberta de serviço dentro do cluster. Este parâmetro especifica o método de descoberta de serviço em clusters |
|
|
string |
Não |
O tipo de descoberta de serviço dentro do cluster. Este parâmetro especifica o método de descoberta de serviço em clusters ACK Serverless.
Valor padrão: não ativado. |
PrivateZone |
|
| snat_entry |
boolean |
Não |
Configurações de SNAT para a VPC. Valores válidos:
Nota
Se você não ativar esta opção durante a criação do cluster e posteriormente precisar de acesso à Internet, poderá ativá-la manualmente. Valor padrão: false. |
false |
soc_enabled
deprecated
|
boolean |
Não |
[Descontinuado] 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 nodepool 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. |
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: false. |
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 |
[Descontinuado] Para a configuração do pool de nós, use o parâmetro taints em kubernetes_config no nodepool em vez disso. As informações de taint do nó. Taints e tolerâncias trabalham juntos para evitar que os pods sejam agendados em 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 em nós inadequados. Para mais informações, consulte taint-and-toleration. |
||
timeout_mins
deprecated
|
integer |
Não |
[Descontinuado] Por padrão, o cluster não é revertido quando a criação 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. |
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 |
[Descontinuado] 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 quando você cria um cluster gerenciado com zero nós. |
|
|
string |
Não |
Os vSwitches para os nós do cluster. Este parâmetro é obrigatório quando você cria um cluster gerenciado com zero nós. |
vsw-2ze3ds0mdip0hdz8i**** |
|
worker_auto_renew
deprecated
|
boolean |
Não |
[Descontinuado] Para a configuração do pool de nós, use o parâmetro auto_renew em scaling_group no nodepool 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 worker_instance_charge_type é definido como PrePaid. Valores válidos:
Valor padrão: true. |
true |
worker_auto_renew_period
deprecated
|
integer |
Não |
[Descontinuado] Para a configuração do pool de nós, use o parâmetro auto_renew_period em scaling_group no nodepool em vez disso. O ciclo unificado 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 |
[Descontinuado] Use o parâmetro data_disks em scaling_group do nodepool para configurações de pool de nós. A combinação de tipo, tamanho e outras configurações de discos de dados em nuvem para nós de trabalho. |
|
|
object |
Não |
O conjunto de configurações de disco de dados em nuvem. |
||
| category |
string |
Sim |
O tipo de disco de dados em nuvem. |
cloud_essd |
| encrypted |
string |
Não |
Especifica se os discos de dados em nuvem devem ser criptografados. Valores válidos:
Valor padrão: false. |
true |
| performance_level |
string |
Não |
O nível de desempenho dos discos de dados em nuvem do nó. Este parâmetro entra em vigor apenas para discos em nuvem ESSD. |
PL1 |
| size |
string |
Sim |
O tamanho do disco de dados em nuvem. Valores válidos: 40 a 32767. Unidade: GiB. |
120 |
worker_instance_charge_type
deprecated
|
string |
Não |
[Descontinuado] Use o parâmetro instance_charge_type em scaling_group do nodepool para configurações de 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 |
[Descontinuado] Use o parâmetro instance_types em scaling_group do nodepool para configurações de 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 prioridade. |
ecs.n4.large |
|
worker_period
deprecated
|
integer |
Não |
[Descontinuado] Use o parâmetro period em scaling_group do nodepool para configurações de 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 worker_instance_charge_type está definido como PrePaid. Valores válidos: {1, 2, 3, 6, 12, 24, 36, 48, 60}. Valor padrão: 1. |
1 |
worker_period_unit
deprecated
|
string |
Não |
[Descontinuado] Use o parâmetro period_unit em scaling_group do nodepool para configurações de 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 é PrePaid. Valores válidos: Month. Atualmente, apenas ciclos de cobrança mensais são suportados. |
Month |
worker_system_disk_category
deprecated
|
string |
Não |
[Descontinuado] Use o parâmetro system_disk_category em scaling_group do nodepool para configurações de pool de nós. O tipo de disco de sistema em nuvem para nós de trabalho. Para mais informações, consulte Visão geral do armazenamento em bloco. Valores válidos:
Valor padrão: cloud_ssd. |
cloud_efficiency |
worker_system_disk_performance_level
deprecated
|
string |
Não |
[Descontinuado] Use o parâmetro system_disk_performance_level em scaling_group do nodepool para configurações de pool de nós. Define o nível de desempenho (PL) do disco de sistema em nuvem quando o disco de sistema em nuvem é um ESSD. Para mais informações, consulte Discos em nuvem ESSD. Valores válidos:
|
PL1 |
worker_system_disk_size
deprecated
|
integer |
Não |
[Descontinuado] Use o parâmetro system_disk_size em scaling_group do nodepool para configurações de pool de nós. O tamanho do disco de sistema em nuvem 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. |
120 |
worker_system_disk_snapshot_policy_id
deprecated
|
string |
Não |
[Descontinuado] Use o parâmetro system_disk_snapshot_policy_id em scaling_group do nodepool para configurações de pool de nós. O ID da política de snapshot automático usada pelos discos de sistema em nuvem dos nós de trabalho. |
sp-2zej1nogjvovnz4z**** |
worker_vswitch_ids
deprecated
|
array |
Não |
[Descontinuado] Use o parâmetro vswitch_ids em scaling_group do nodepool para configurações de 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 worker_vswitch_ids não é obrigatório, mas você deve fornecer vswitch_ids. |
|
|
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 worker_vswitch_ids não é obrigatório, mas você deve fornecer vswitch_ids. |
vsw-2ze3ds0mdip0hdz8i**** |
|
zone_id
deprecated
|
string |
Não |
[Descontinuado] Use o parâmetro zone_ids em vez disso.\n\nO ID da zona ativa da região à qual o cluster pertence. Este parâmetro é específico para clusters gerenciados ACK.\n\nAo criar um cluster gerenciado ACK sem especificar vpc_id e vswitch_ids, você deve especificar zone_id para que o cluster crie automaticamente uma VPC e recursos de rede relacionados na zona especificada. Este parâmetro é ignorado se vpc_id e vswitch_ids forem especificados. |
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 ACK. |
|
|
string |
Não |
O ID da zona ativa da região à qual o cluster pertence. Um vSwitch está sujeito à criação automática nesta zona.\n\nAo criar um cluster gerenciado ACK sem especificar vpc_id e vswitch_ids, especifique zone_ids para que o cluster crie automaticamente uma VPC e recursos de rede relacionados em várias zonas. Este parâmetro é ignorado se vpc_id e vswitch_ids forem especificados. |
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.