Todos os produtos
Search
Central de documentação

Container Service for Kubernetes:CreateCluster

Última atualização: Sep 10, 2026

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:

  1. Faça login no console do Container Service for Kubernetes (ACK) e escolha Clusters no painel de navegação à esquerda.

  2. Na página Clusters, clique em Modelo de cluster.

  3. 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.

  4. 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.

Importante A partir de 4 de julho de 2026, alguns parâmetros de solicitação não terão mais efeito. Para obter detalhes sobre as alterações e descrições dos parâmetros de substituição, consulte Aviso sobre alterações nos parâmetros de solicitação e resposta do OpenAPI para gerenciamento de clusters ACK e OpenAPI offline.

Experimente agora

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

Testar

Autorização RAM

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

  • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

  • API: A API que você pode chamar para executar a ação.

  • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

  • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

    • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

    • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

  • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

  • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

cs:CreateCluster

create

*Cluster

acs:cs:{#regionId}:{#accountId}:cluster/*

  • cs:ClusterType
  • cs:ClusterSpec
  • cs:ClusterProfile
  • cs:EnableSecretEncryption
  • cs:EnableApiServerEip
  • cs:EnableAddonLogtailDs
  • cs:EnableCoreControlPlaneComponentsLog
  • cs:AddonNames
  • cs:EnableSNAT
  • cs:EnableNodePoolPublicIP
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:

  • Flannel: [{"name":"flannel","config":""}].

  • Terway: [{"name": "terway-eniip","config": ""}].

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.

  • Usar um SLS Project existente: [{"name": "loongcollector","config": "{"IngressDashboardEnabled":"true","sls_project_name":"your_sls_project_name"}"}].

  • Criar um novo SLS Project: [{"name": "loongcollector","config": "{"IngressDashboardEnabled":"true"}"}].

Componente Ingress: Opcional. Por padrão, o componente Ingress nginx-ingress-controller é instalado para clusters dedicados ACK.

  • Instalar o Ingress e ativar o acesso à Internet: [{"name":"nginx-ingress-controller","config":"{"IngressSlbNetworkType":"internet"}"}].

  • Não instalar o Ingress por padrão: [{"name": "nginx-ingress-controller","config": "","disabled": true}].

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: Ativa o recurso.

  • false: Desativa o recurso.

true

sls_project_name

string

Não

O SLS Project que contém o Logstore para logs de auditoria do cluster.

  • Valor padrão: k8s-log-{clusterid}.

  • Após a ativação do recurso de log de auditoria do cluster, um Logstore para logs de auditoria do cluster é criado no SLS Project especificado.

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: Ativa o modo.

  • false: Desativa o modo.

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:

  • true: Ativa a renovação automática.

  • false: Desativa a renovação automática.

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:

  • PostPaid: pós-pago.

  • PrePaid: assinatura. O método de cobrança por assinatura não é mais suportado para instâncias CLB recém-criadas. As instâncias existentes não são afetadas.

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:

  • true: Instala o agente do CloudMonitor.

  • false: Não instala o agente do CloudMonitor.

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:

  • ack.standard: Edição Básica (selecionada por padrão se o valor estiver vazio)

  • ack.pro.small: Edição Pro

  • ack.pro.xlarge: Pro XL

  • ack.pro.2xlarge: Pro 2XL

  • ack.pro.4xlarge: Pro 4XL (requer contato com o atendimento ao cliente para ativar a lista de permissões)

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: Cluster dedicado ACK.

  • ManagedKubernetes: Tipos de cluster gerenciado ACK, incluindo clusters gerenciados ACK (edições Pro e Básica), clusters ACK Serverless (edições Pro e Básica), clusters ACK Edge (edições Pro e Básica) e clusters ACK Lingjun (edição Pro).

  • ExternalKubernetes: Cluster registrado.

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:

  • true: Ativa a renovação automática.

  • false: Desativa a renovação automática.

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.

  • PrePaid: assinatura.

  • PostPaid: pós-pago.

Valor padrão: PostPaid.

PostPaid

cloud_monitor_flags

boolean

Não

Especifica se o CloudMonitor deve ser instalado nos nós.

  • true: Instala o agente do CloudMonitor.

  • false: Não instala o agente do CloudMonitor.

Valor padrão: false.

false

cpu_policy

string

Não

A política de gerenciamento de CPU do nó.

  • static: Permite que pods com determinadas características de recursos no nó recebam afinidade e exclusividade de CPU aprimoradas.

  • none: Usa o esquema de afinidade de CPU padrão existente.

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 PrePaid.\n\nValores válidos: {1, 2, 3, 6, 12, 24, 36, 48, 60}. Unidade: meses.\n\nValor 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.\n\nValor válido: Month. Atualmente, apenas ciclos de cobrança baseados em meses são suportados.

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 ou 5.

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 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ó.\n\n- cloud_efficiency: disco em nuvem ultra.\n- cloud_ssd: SSD padrão.\n- cloud_essd: ESSD.\n- cloud_auto: disco em nuvem ESSD AutoPL.\n- cloud_essd_entry: disco em nuvem ESSD Entry.\n\nValor 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.\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 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ó.\n\nValores válidos: [40, 500]. Unidade: GiB.\n\nValor 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.\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-{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.\n\nA política de gerenciamento de CPU do nó. As seguintes políticas são suportadas para clusters da versão 1.12.6 ou posterior:\n\n- static: Permite que pods com determinadas características de recursos no nó recebam afinidade e exclusividade de CPU aprimoradas.\n- none: Usa o esquema de afinidade de CPU padrão existente.\n\nValor padrão: none.

none

custom_san deprecated

string

Não

[Deprecated] Use o parâmetro extra_sans em seu lugar.\n\nO 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:\n\n- true: Ativa a proteção contra exclusão do cluster. O cluster não pode ser excluído no console ou por meio de chamadas de operações de API.\n- false: Desativa a proteção contra exclusão do cluster. O cluster pode ser excluído no console ou por meio de chamadas de operações de API.\n\nValor 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.\n\nEspecifica se o cluster deve ser revertido caso a criação do cluster falhe. Valores válidos:\n\n- true: Reverte o cluster se a criação do cluster falhar.\n- false: Não reverte o cluster se a criação do cluster falhar.\n\n\nValor padrão: true.

true

enable_rrsa deprecated

boolean

Não

[Deprecated] Use o parâmetro rrsa_config em seu lugar.\n\nEspecifica se o recurso RRSA deve ser ativado.\n\n- true: Ativa o recurso.\n\n- false: Não ativa o recurso.

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: Ativa o acesso à rede pública.\n- false: Desativa o acesso à rede pública. Se você selecionar esta opção, o servidor de API do cluster não poderá ser acessado pela Internet.\n\nValor padrão: false.

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- true: Armazena contêineres e imagens em discos de dados. Os dados existentes nos discos de dados serão perdidos. Faça backup dos seus dados com antecedência.\n\n- false: Não armazena contêineres e imagens em discos de dados.\n\nValor padrão: false.\n\nRegras de montagem de disco de dados:\n\n- Se a instância ECS tiver discos de dados anexados e o sistema de arquivos do último disco de dados não estiver inicializado, o sistema formata automaticamente o disco de dados como ext4 para armazenar /var/lib/docker e /var/lib/kubelet.\n- Se a instância ECS não tiver discos de dados anexados, nenhum novo disco de dados será montado.

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 no nodepool em seu lugar.\n\nA imagem personalizada para nós. A imagem do sistema é usada por padrão. Quando uma imagem personalizada é selecionada, ela substitui a imagem padrão do sistema. Para obter 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 no 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: CentOS.

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 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 2000. Portanto, ao criar um cluster do tipo de rede Terway, use um grupo de segurança avançado.\n\n- true: Cria e usa um grupo de segurança avançado.\n- false: Usa um grupo de segurança básico.\n\nValor padrão: true.

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: Mantém os nomes das instâncias.\n- false: Não mantém os nomes das instâncias. Os nomes são substituídos por nomes gerados pelo sistema.\n\nValor padrão: true.

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 no 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 é 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.

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.

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 no 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 deve ser ativada para nós mestres. Este parâmetro entra em vigor apenas quando master_instance_charge_type está definido como PrePaid. Valores válidos:\n\n- true: Ativa a renovação automática.\n- false: Desativa a renovação automática.\n\nValor padrão: true.

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 ou 5.\n\nValor padrão: 3.

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: Assinatura.\n- PostPaid: Pay-as-you-go.\n\nValor padrão: PostPaid.

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 obter 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 obter 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 está definido como PrePaid.\n\nValores válidos: {1, 2, 3, 6, 12, 24, 36, 48, 60}.\n\nValor padrão: 1.

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 assinatura para nós mestres. Este parâmetro é obrigatório quando o método de cobrança é PrePaid.\n\nValores válidos: Month. Atualmente, apenas a cobrança mensal é suportada.

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_efficiency: Disco em nuvem Ultra.\n- cloud_ssd: SSD padrão.\n- cloud_essd: SSD empresarial (ESSD).\n\nValor padrão: cloud_ssd. O valor padrão pode variar de acordo com a zona.

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 (PL) 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 obter 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.

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 (-). 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.

  • 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 núcleo e 512 MiB.

  • PrivateZone: Usa o Alibaba Cloud PrivateZone para fornecer recursos de descoberta de serviço. O serviço PrivateZone deve ser ativado.

Valor padrão: não ativado.

PrivateZone

snat_entry

boolean

Não

As configurações de SNAT para a VPC. Valores válidos:

  • true: Ativa a criação automática de um gateway NAT e a configuração automática de regras SNAT. Defina como true se os nós e aplicativos no cluster precisarem acessar a Internet.

  • false: Não cria um gateway NAT ou regras SNAT. Os nós e aplicativos no cluster não podem acessar a Internet.

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.

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:

  • true: Ativa o reforço de segurança MLPS 2.0.

  • false: Não ativa o reforço de segurança MLPS 2.0.

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.

  • true: Ativado.

  • false: Não ativado.

Valor padrão: false.

true

tags

array

Não

As tags do nó. Regras de definição de tags:

  • As tags são pares chave-valor sensíveis a maiúsculas e minúsculas. Você pode definir até 20 tags.

  • As chaves de tag não podem ser duplicadas e podem ter até 64 caracteres. Os valores de tag podem estar vazios e podem ter até 128 caracteres. As chaves e valores de tag não podem começar com "aliyun", "acs:", "https://" ou "http://". Para mais informações, consulte Rótulos e Seletores.

tag

Não

As tags do nó. Regras de definição de tags:

  • As tags são pares chave-valor sensíveis a maiúsculas e minúsculas. Você pode definir até 20 tags.

  • As chaves de tag não podem ser duplicadas e podem ter até 64 caracteres. Os valores de tag podem estar vazios e podem ter até 128 caracteres. As chaves e valores de tag não podem começar com "aliyun", "acs:", "https://" ou "http://". Para mais informações, consulte Rótulos e Seletores.

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.

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 worker_instance_charge_type é definido como PrePaid. Valores válidos:

  • true: Ativa a renovação automática.

  • false: Não ativa a renovação automática.

Valor padrão: true.

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:

  • true: Criptografa os discos em nuvem de dados.

  • false: Não criptografa os discos em nuvem de dados.

Valor padrão: false.

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:

  • PrePaid: Assinatura.

  • PostPaid: Pós-pago.

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 worker_instance_charge_type é 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

[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 é PrePaid.

Valores válidos: Month. Atualmente, apenas ciclos de cobrança mensais são suportados.

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:

  • cloud_efficiency: disco em nuvem de alta eficiência.

  • cloud_ssd: SSD padrão.

Valor padrão: cloud_ssd.

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:

  • PL0

  • PL1

  • PL2

  • PL3

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.

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 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

[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.