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

  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 desativação do OpenAPI.

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 de 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 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: Ativado.

  • false: Não ativado.

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.

  • true: Ativado.

  • false: Não 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:

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

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

  • 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 (entre em contato com o suporte 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

  • Kubernetes: Cluster dedicado ACK.

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

  • ExternalKubernetes: Cluster registrado.

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:

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

  • true: Ativa o reforço de segurança do Alibaba Cloud OS.

  • false: Desativa o reforço de segurança do Alibaba Cloud OS.

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.

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

  • false: Desativa o reforço de segurança MLPS 2.0.

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

  • true: Ativado.

  • false: Desativado.

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

  • cloud_efficiency: disco em nuvem ultra.

  • cloud_ssd: SSD padrão.

  • cloud_essd: ESSD.

  • cloud_auto: disco em nuvem ESSD AutoPL.

  • cloud_essd_entry: disco em nuvem ESSD Entry.

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:

  • 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

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:

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

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

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:

  • true: Reverte o cluster quando a criação do cluster falha.

  • false: Não reverte o cluster quando a criação do cluster falha.

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.

  • true: Ativa o recurso.

  • 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 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: Ativa o acesso público.\n- false: Desativa o acesso público. Se você optar por não ativar o acesso à rede pública, 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 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: 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 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: 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 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.

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 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 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 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 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 cobrança 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 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.

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: 26.

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.

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.

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.

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 cluster_type como ManagedKubernetes para clusters gerenciados pelo ACK, é possível especificar ainda o subtipo do cluster.\n- Default: Cluster gerenciado pelo 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 do 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 do iptables. O desempenho é moderado e afetado pela escala do cluster. 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. Esta é 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 o nftables para suporte da comunidade a longo prazo.\n\nValor padrão: ipvs.

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

[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- true: Ativa o endurecimento de segurança do SO do Alibaba Cloud.\n- false: Não ativa o endurecimento de segurança do SO do Alibaba Cloud.\n\nValor padrão: false.

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 service-account-issuer é a identidade do emissor no token da serviceaccount, que é o campo iss na carga útil do token.\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 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 ACK Serverless.\n\n- CoreDNS: Usa o componente padrão de descoberta de serviço nativo do Kubernetes, o 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. Você deve ativar o serviço PrivateZone.\n\nValor padrão: não ativado.

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.

  • CoreDNS: Usa o componente padrão de descoberta de serviço nativo do Kubernetes, o 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.

  • PrivateZone: Usa o Alibaba Cloud PrivateZone para fornecer recursos de descoberta de serviço. Você deve ativar o serviço PrivateZone.

Valor padrão: não ativado.

PrivateZone

snat_entry

boolean

Não

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

  • true: Ativa a criação automática de um gateway NAT e configura as 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 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:

  • true: Ativa o reforço de conformidade de proteção classificada.

  • false: Não ativa o reforço de conformidade de proteção classificada.

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 que diferenciam maiúsculas de 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 os 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 que diferenciam maiúsculas de 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 os 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

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

  • 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

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

  • true: Criptografa os discos de dados em nuvem.

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

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:

  • PrePaid: assinatura.

  • PostPaid: pós-pago.

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:

  • cloud_efficiency: disco em nuvem ultra.

  • cloud_ssd: SSD padrão.

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:

  • PL0

  • PL1

  • PL2

  • PL3

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.