Todos los productos
Search
Centro de documentos

Container Service for Kubernetes:CreateCluster

Última actualización: Sep 15, 2026

Crea un clúster de ACK, incluidos los clústeres administrados de ACK, los clústeres ACK Serverless, los clústeres ACK Edge y los clústeres registrados. Al crear un clúster, se configuran la información del clúster, los componentes del clúster y los recursos en la nube relacionados con ACK.

Descripción de la operación

Generación de parámetros de solicitud de OpenAPI mediante la consola

Al llamar a la operación CreateCluster para crear un clúster, si la llamada falla debido a combinaciones incorrectas de parámetros de solicitud, puede usar la consola para generar las combinaciones de parámetros de solicitud requeridas. Realice los siguientes pasos:

  1. Inicie sesión en la consola de Container Service for Kubernetes (ACK) y seleccione Clústeres en el panel de navegación izquierdo.

  2. En la página Clústeres, haga clic en Plantilla de clúster.

  3. En el cuadro de diálogo, seleccione el tipo de clúster que desea crear, haga clic en Crear y, a continuación, configure la información del clúster en la página de configuración del clúster.

  4. Una vez completada la configuración, en la página Confirmar configuración, haga clic en Código equivalente en la esquina superior derecha. El cuadro de diálogo muestra las combinaciones de parámetros necesarias para crear el clúster. Cópielas y utilícelas.

Importante A partir del 4 de julio de 2026, algunos parámetros de solicitud dejarán de surtir efecto. Para obtener más información sobre los cambios y las descripciones de los parámetros de reemplazo, consulte Aviso sobre cambios en los parámetros de solicitud y respuesta de OpenAPI para la gestión de clústeres de ACK y desconexión de OpenAPI.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

  • Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.

  • API: La API que debe invocarse para llevar a cabo la acción.

  • Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.

  • Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.

    • En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.

    • Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.

  • Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.

  • Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

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
Ninguna

Sintaxis de la solicitud

POST /clusters HTTP/1.1

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

body

object

No

Los parámetros del cuerpo de la solicitud.

cluster-demo

access_control_list deprecated

array

No

[Obsoleto] La lista de control de acceso (ACL) de la instancia de SLB para el servidor de API de un clúster registrado.

string

No

La lista de control de acceso (ACL) de la instancia de SLB para el servidor de API de un clúster registrado.

192.168.XX.XX/24

addons

array

No

La lista de componentes del clúster. Al crear un clúster, use addons para especificar los componentes que desea instalar.

Componente de red: Obligatorio. Hay dos tipos de red disponibles: Flannel y Terway. Seleccione uno al crear un clúster:

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

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

Componente de almacenamiento: Opcional. Solo se admite el tipo csi:

csi: [{"name":"csi-plugin","config": ""},{"name": "csi-provisioner","config": ""}].

Componente de registros: Opcional. Se recomienda habilitar este componente. Si no habilita el servicio de registros, no podrá usar la función de auditoría del clúster.

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

  • Cree un nuevo SLS Project: [{"name": "loongcollector","config": "{"IngressDashboardEnabled":"true"}"}].

Componente de Ingress: Opcional. De forma predeterminada, el componente de Ingress nginx-ingress-controller se instala para los clústeres dedicados de ACK.

  • Instale Ingress y habilite el acceso a Internet: [{"name":"nginx-ingress-controller","config":"{"IngressSlbNetworkType":"internet"}"}].

  • No instale Ingress de forma predeterminada: [{"name": "nginx-ingress-controller","config": "","disabled": true}].

Centro de eventos: Opcional. Habilitado de forma predeterminada.

El Centro de eventos proporciona las capacidades para almacenar, consultar y alertar sobre eventos de Kubernetes. El Logstore asociado con el Centro de eventos de Kubernetes es gratuito durante 90 días. Para obtener más información sobre la política de gratuidad, consulte Crear y usar el Centro de eventos de Kubernetes.

Ejemplo de habilitación del Centro de eventos: [{"name":"ack-node-problem-detector","config":"{"sls_project_name":"your_sls_project_name"}"}].

addon

No

La lista de componentes del clúster. Al crear un clúster, use addons para especificar los componentes que desea instalar.

api_audiences

string

No

Una ServiceAccount es la credencial de acceso que utiliza un pod para comunicarse con el servidor de API del clúster. El parámetro api-audiences especifica las identidades de token de solicitud válidas que utiliza el apiserver para autenticar si los tokens de solicitud son válidos. Puede configurar múltiples audiences separadas por comas (,).

Para obtener más información sobre ServiceAccount, consulte Implementar la proyección de volumen de tokens de cuenta de servicio.

kubernetes.default.svc

audit_log_config

object

No

La configuración del registro de auditoría del clúster.

enabled

boolean

No

Especifica si se debe habilitar la función de registro de auditoría del clúster. Valores válidos:

  • true: Habilita la función.

  • false: Deshabilita la función.

true

sls_project_name

string

No

El SLS Project que contiene el Logstore para los registros de auditoría del clúster.

  • Valor predeterminado: k8s-log-{clusterid}.

  • Después de habilitar la función de registro de auditoría del clúster, se crea un Logstore para los registros de auditoría del clúster en el SLS Project especificado.

k8s-log-c2345xxxxxxxxxxxx

auto_mode

object

No

La configuración del modo administrado inteligente.

enable

boolean

No

Especifica si se debe habilitar el modo administrado inteligente. Valores válidos:

  • true: Habilita el modo.

  • false: Deshabilita el modo.

true

auto_renew deprecated

boolean

No

[Obsoleto]

Especifica si se debe habilitar la renovación automática. Este parámetro solo surte efecto cuando charge_type se establece en PrePaid. Valores válidos:

  • true: Habilita la renovación automática.

  • false: Deshabilita la renovación automática.

Valor predeterminado: false.

Este parámetro se modificó el 15 de octubre de 2024. Para obtener más información, consulte Aviso sobre cambios de comportamiento del parámetro CreateCluster.

true

auto_renew_period deprecated

integer

No

[Obsoleto]

El periodo de renovación automática. Este parámetro solo surte efecto cuando el método de facturación es por adelantado y la renovación automática está habilitada. Cuando PeriodUnit=Month, valores válidos: {1, 2, 3, 6, 12}.

Valor predeterminado: 1.

Este parámetro se modificó el 15 de octubre de 2024. Para obtener más información, consulte Aviso sobre cambios de comportamiento del parámetro CreateCluster.

1

charge_type deprecated

string

No

[Obsoleto]

El método de facturación de la instancia de CLB utilizada por el servidor de API. Valor predeterminado: PostPaid. Valores válidos:

  • PostPaid: pago por uso.

  • PrePaid: suscripción. El método de facturación por suscripción ya no se admite para las instancias de CLB recién creadas. Las instancias existentes no se ven afectadas.

Importante
  • Este parámetro se modificó el 15 de octubre de 2024. Para obtener más información, consulte Aviso sobre cambios de comportamiento del parámetro CreateCluster.

  • A partir del 1 de diciembre de 2024, las instancias de CLB recién creadas ya no admiten el método de facturación por suscripción y se cobrará una tarifa por instancia.

Para obtener más información, consulte Aviso sobre cambios de facturación para Classic Load Balancer (CLB).

PostPaid

cis_enabled deprecated

boolean

No

[Obsoleto] Para la configuración del plano de control del clúster, use el parámetro security_hardening_os bajo control_plane_config en su lugar. Para la configuración del grupo de nodos, use el parámetro security_hardening_os bajo scaling_group en nodepool en su lugar.

false

client_token

string

No

El token de cliente.

0a287651-1277-4c0d-80d2-623a4*****

cloud_monitor_flags deprecated

boolean

No

[Obsoleto] Para la configuración de los nodos del plano de control del clúster, use el parámetro cloud_monitor_flags bajo control_plane_config en su lugar. Para la configuración del grupo de nodos, use el parámetro cms_enabled bajo kubernetes_config en nodepool en su lugar.

Especifica si se debe instalar el agente de CloudMonitor en el clúster. Valores válidos:

  • true: Instala el agente de CloudMonitor.

  • false: No instala el agente de CloudMonitor.

Valor predeterminado: false.

false

cluster_domain

string

No

El nombre de dominio local del clúster.

Reglas de nomenclatura: Un nombre de dominio consta de una o más partes separadas por puntos (.). Cada parte puede tener hasta 63 caracteres de longitud y puede contener letras minúsculas, dígitos y guiones (-). Cada parte debe comenzar y terminar con una letra minúscula o un dígito.

cluster.local

cluster_spec

string

No

Después de establecer cluster_type en ManagedKubernetes y configurar profile, puede especificar aún más la especificación del clúster. Valores válidos:

  • ack.standard: Edición básica (seleccionada de forma predeterminada si el valor está vacío)

  • ack.pro.small: Edición Pro

  • ack.pro.xlarge: Pro XL

  • ack.pro.2xlarge: Pro 2XL

  • ack.pro.4xlarge: Pro 4XL (requiere contactar al servicio de atención al cliente para habilitar la lista blanca)

Pro XL, Pro 2XL y Pro 4XL son tres niveles proporcionados por el Plano de control aprovisionado de ACK Pro. Al preasignar y dedicar recursos del plano de control, estos niveles garantizan que la concurrencia de API y las capacidades de programación de pods se mantengan en un nivel consistentemente alto. Son adecuados para entrenamiento e inferencia de IA, clústeres a ultra gran escala y cargas de trabajo críticas.

Para obtener información sobre las tarifas de administración de clústeres para la edición Pro y las ediciones de Plano de control aprovisionado, consulte Tarifa de administración de clústeres.

ack.pro.small

cluster_type

string

No

Valores válidos:

  • Kubernetes: Clúster dedicado de ACK.

  • ManagedKubernetes: Tipos de clúster administrado de ACK, incluidos clústeres administrados de ACK (ediciones Pro y básica), clústeres ACK Serverless (ediciones Pro y básica), clústeres ACK Edge (ediciones Pro y básica) y clústeres ACK Lingjun (edición Pro).

  • ExternalKubernetes: Clúster registrado.

Kubernetes

container_cidr

string

No

El bloque CIDR para los pods. Debe ser un bloque CIDR privado válido, específicamente los siguientes bloques CIDR y sus subredes: 10.0.0.0/8, 172.16-31.0.0/12-16 y 192.168.0.0/16. El bloque CIDR no puede superponerse con el bloque CIDR de la VPC ni con los bloques CIDR utilizados por los clústeres de Kubernetes existentes en la VPC. No puede modificar este bloque CIDR después de crear el clúster.

Para obtener más información sobre la planificación de red de clústeres, consulte Planificar la red de un clúster administrado de ACK.

Nota

Este parámetro es obligatorio para los clústeres Flannel.

172.20.0.0/16

control_plane_config

object

No

La configuración del plano de control para los clústeres dedicados de ACK.

auto_renew

boolean

No

Especifica si se debe habilitar la renovación automática para los nodos del plano de control. Este parámetro solo surte efecto cuando el método de facturación se establece en PrePaid. Valores válidos:

  • true: Habilita la renovación automática.

  • false: Deshabilita la renovación automática.

Valor predeterminado: true.

true

auto_renew_period

integer

No

El periodo de renovación automática para los nodos del plano de control.

Valores válidos: {1, 2, 3, 6, 12}. Unidad: meses.

Valor predeterminado: 1.

1

charge_type

string

No

El método de facturación para los nodos del plano de control.

  • PrePaid: suscripción.

  • PostPaid: pago por uso.

Valor predeterminado: PostPaid.

PostPaid

cloud_monitor_flags

boolean

No

Especifica si se debe instalar CloudMonitor en los nodos.

  • true: Instala el agente de CloudMonitor.

  • false: No instala el agente de CloudMonitor.

Valor predeterminado: false.

false

cpu_policy

string

No

La política de administración de CPU de los nodos.

  • static: Permite que los pods con ciertas características de recursos en el nodo obtengan una afinidad y exclusividad de CPU mejoradas.

  • none: Utiliza el esquema de afinidad de CPU predeterminado existente.

Valor predeterminado: none.

none

deploymentset_id

string

No

El ID del conjunto de despliegue.

ds-bp10b35imuam5amw****

image_id

string

No

El ID de la imagen.

aliyun_3_x64_20G_alibase_20240819.vhd

image_type

string

No

El tipo de imagen del sistema operativo.

AliyunLinux3

instance_metadata_options InstanceMetadataOptions

No

La configuración de acceso a los metadatos de la instancia de ECS.

instance_types

array

No

Los tipos de instancia de los nodos.

string

No

El tipo de instancia del nodo.

ecs.g6.large

key_pair

string

No

El nombre del par de claves. Debe establecer key_pair o login_password.

ack

login_password

string

No

La contraseña de inicio de sesión SSH. La contraseña debe tener una longitud de entre 8 y 30 caracteres y contener al menos tres de los siguientes tipos de caracteres: letras mayúsculas, letras minúsculas, dígitos y caracteres especiales. Debe establecer login_password o key_pair.

********

node_port_range

string

No

[Obsoleto] El rango de puertos de servicio de los nodos.

30000-32767

period

integer

No

La duración de la suscripción para los nodos del plano de control. Este parámetro es obligatorio y solo surte efecto cuando el método de facturación se establece en PrePaid.

Valores válidos: {1, 2, 3, 6, 12, 24, 36, 48, 60}. Unidad: meses.

Valor predeterminado: 1.

1

period_unit

string

No

La unidad de duración de la suscripción para los nodos del plano de control. Este parámetro es obligatorio y solo surte efecto cuando el método de facturación se establece en PrePaid.

Valor válido: Month. Actualmente, solo se admiten ciclos de facturación basados en meses.

Month

runtime

string

No

[Obsoleto] El nombre del entorno de ejecución para los nodos del plano de control. Valores válidos:

containerd: El entorno de ejecución Containerd, que es compatible con todas las versiones del clúster.

containerd

security_hardening_os

boolean

No

Especifica si se debe habilitar el endurecimiento de seguridad del sistema operativo de Alibaba Cloud.

  • true: habilita el endurecimiento de seguridad del sistema operativo de Alibaba Cloud.

  • false: deshabilita el endurecimiento de seguridad del sistema operativo de Alibaba Cloud.

Valor predeterminado: false.

false

size

integer

No

El número de nodos del plano de control.

Valores válidos: 3 o 5.

3

soc_enabled

boolean

No

Especifica si se debe habilitar el endurecimiento de seguridad de MLPS.

  • true: habilita el endurecimiento de seguridad de MLPS 2.0.

  • false: deshabilita el endurecimiento de seguridad de MLPS 2.0.

Valor predeterminado: false.

false

system_disk_bursting_enabled

boolean

No

Especifica si se debe habilitar el rendimiento de ráfaga para los discos en la nube del sistema de los nodos.

  • true: habilitado.

  • false: deshabilitado.

Este parámetro solo se admite cuando system_disk_category se establece en cloud_auto.

true

system_disk_category

string

No

El tipo de disco en la nube del sistema de los nodos.

  • cloud_efficiency: disco en la nube ultra.

  • cloud_ssd: SSD estándar.

  • cloud_essd: ESSD.

  • cloud_auto: disco en la nube ESSD AutoPL.

  • cloud_essd_entry: disco en la nube ESSD Entry.

Valor predeterminado: cloud_ssd. El valor predeterminado puede variar según la zona.

cloud_ssd

system_disk_performance_level

string

No

El nivel de rendimiento del disco en la nube del sistema de los nodos. Este parámetro solo surte efecto para los discos en la nube ESSD.

El nivel de rendimiento varía según el tamaño del disco en la nube. Para obtener más información, consulte Discos en la nube ESSD.

PL1

system_disk_provisioned_iops

integer

No

Las IOPS de lectura y escritura aprovisionadas para los discos en la nube del sistema de los nodos.

Valores válidos: 0 a min{50,000, 1000 × capacidad - rendimiento base}. Rendimiento base = min{1,800 + 50 × capacidad, 50,000}.

Este parámetro solo se admite cuando system_disk_category se establece en cloud_auto.

1000

system_disk_size

integer

No

El tamaño del disco en la nube del sistema de los nodos.

Valores válidos: [40, 500]. Unidad: GiB.

Valor predeterminado: 120.

120

system_disk_snapshot_policy_id

string

No

La política de instantáneas automáticas para los discos en la nube del sistema de los nodos.

sp-2zej1nogjvovnz4z****

control_plane_endpoints_config

object

No

La configuración del endpoint del clúster.

internal_dns_config

object

No

La configuración de DNS interno para el clúster. Este parámetro se aplica a los clústeres administrados de ACK. El nombre de dominio interno es utilizado por los componentes del sistema del lado del nodo, como kubelet y kube-proxy, para acceder al servidor de API. Si no se habilita el acceso por nombre de dominio interno, los componentes del sistema del lado del nodo acceden al servidor de API a través de la dirección IP del CLB.

bind_vpcs

array

No

Las VPC en las que surten efecto los registros de DNS internos del clúster.

string

No

Las VPC en las que surten efecto los registros de DNS internos del clúster.

vpc-xxxx

load_balancers_config

array<object>

No

La configuración del endpoint del clúster. Cuando se especifica este parámetro, los parámetros endpoint_public_access y load_balancer_id no surten efecto. ACK solo admite la creación automática de instancias NLB. Para especificar una instancia de CLB o NLB, utilice load_balancers_config para especificar el ID de la instancia correspondiente.

object

No

La configuración de balanceo de carga para el acceso al clúster.

endpoint_type

string

No

El tipo de endpoint.

private

load_balancer_id

string

No

El ID de la instancia de NLB.

nlb-0ogk9aaxxxxxxx

controlplane_log_components

array

No

La lista de nombres de componentes que especifica de qué componentes del plano de control se recopilan registros.

De forma predeterminada, los registros se recopilan de kube-apiserver, kube-controller-manager, kube-scheduler y cloud-controller-manager.

string

No

La lista de nombres de componentes que especifica de qué componentes del plano de control se recopilan registros.

De forma predeterminada, los registros se recopilan de kube-apiserver, kube-controller-manager, kube-scheduler y cloud-controller-manager.

["apiserver","kcm","scheduler"]

controlplane_log_project

string

No

El proyecto de Simple Log Service para los registros de los componentes del plano de control. Puede utilizar un proyecto existente para el almacenamiento de registros, o el sistema crea un proyecto automáticamente. Si elige la creación automática, se crea un proyecto de Simple Log Service llamado k8s-log-{ClusterID}.

k8s-log-xxx

controlplane_log_ttl

string

No

El periodo de retención de registros para los registros de los componentes del plano de control, en días.

30

cpu_policy deprecated

string

No

[Obsoleto] Utilice el parámetro cpu_policy bajo control_plane_config para la configuración del plano de control del clúster, o utilice el parámetro cpu_policy bajo kubernetes_config en nodepool para la configuración del grupo de nodos.

La política de administración de CPU de los nodos. Se admiten las siguientes políticas para clústeres de la versión 1.12.6 o posterior:

  • static: permite que los pods con ciertas características de recursos en el nodo obtengan una afinidad y exclusividad de CPU mejoradas.

  • none: utiliza el esquema de afinidad de CPU predeterminado existente.

Valor predeterminado: none.

none

custom_san deprecated

string

No

[Obsoleto] Utilice el parámetro extra_sans en su lugar.

El nombre alternativo del asunto (SAN) del certificado personalizado. Separe varias direcciones IP o nombres de dominio con comas (,).

cs.aliyun.com

deletion_protection

boolean

No

Especifica si se debe habilitar la protección contra eliminación del clúster, lo que evita que el clúster se elimine accidentalmente en la consola o al llamar a operaciones de la API. Valores válidos:

  • true: habilita la protección contra eliminación del clúster. El clúster no se puede eliminar en la consola ni al llamar a operaciones de la API.

  • false: deshabilita la protección contra eliminación del clúster. El clúster se puede eliminar en la consola o al llamar a operaciones de la API.

Valor predeterminado: false.

true

disable_rollback deprecated

boolean

No

[Obsoleto] Cuando falla la creación del clúster, no se realiza ninguna reversión de forma predeterminada. Debe limpiar manualmente el clúster con error.

Especifica si se debe revertir el clúster si falla su creación. Valores válidos:

  • true: revierte el clúster si falla su creación.

  • false: no revierte el clúster si falla su creación.

Valor predeterminado: true.

true

enable_rrsa deprecated

boolean

No

[Obsoleto] Utilice el parámetro rrsa_config en su lugar.

Especifica si se debe habilitar la función RRSA.

  • true: habilita la función.

  • false: no habilita la función.

false

encryption_provider_key

string

No

El ID de la clave de Key Management Service (KMS) que se utiliza para cifrar los discos en la nube. Para obtener más información, consulte Key Management Service.

Nota

Esta función solo surte efecto en los clústeres ACK Pro.

0fe64791-55eb-4fc7-84c5-c6c7cdca****

endpoint_public_access

boolean

No

Especifica si se debe habilitar el acceso a la red pública. Se utiliza una dirección IP elástica (EIP) para exponer el servidor de API y permitir el acceso a la red pública del clúster.

  • true: habilita el acceso a la red pública.

  • false: deshabilita el acceso a la red pública. Si selecciona esta opción, no se puede acceder al servidor de API del clúster a través de Internet.

Valor predeterminado: false.

true

extra_sans

array

No

El nombre alternativo del sujeto (SAN) personalizado para el certificado del servidor de API.

string

No

El SAN del certificado. Admite direcciones IP o nombres de dominio personalizados.

192.168.xx.xx

format_disk deprecated

boolean

No

[Obsoleto] No se admite la selección de nodos existentes durante la creación del clúster. Para agregar nodos existentes a un clúster, cree primero un pool de nodos y llame a la operación AttachInstancesToNodePool.

Especifica si se deben montar discos de datos en las instancias existentes al crear un clúster con instancias existentes. Valores válidos:

  • true: almacena contenedores e imágenes en los discos de datos. Los datos existentes en los discos de datos se perderán. Haga una copia de seguridad de sus datos con antelación.

  • false: no almacena contenedores e imágenes en los discos de datos.

Valor predeterminado: false.

Reglas de montaje de discos de datos:

  • Si la instancia ECS tiene discos de datos conectados y el sistema de archivos del último disco de datos no está inicializado, el sistema formatea automáticamente el disco de datos como ext4 para almacenar /var/lib/docker y /var/lib/kubelet.

  • Si la instancia ECS no tiene discos de datos conectados, no se montan nuevos discos de datos.

false

image_id deprecated

string

No

[Obsoleto] Para la configuración del plano de control del clúster, use el parámetro image_id en control_plane_config en su lugar. Para la configuración del pool de nodos, use el parámetro image_id en scaling_group dentro de nodepool en su lugar.

La imagen personalizada para los nodos. La imagen del sistema se utiliza de forma predeterminada. Cuando se selecciona una imagen personalizada, reemplaza la imagen predeterminada del sistema. Para obtener más información, consulte Imágenes personalizadas.

m-bp16z7xko3vvv8gt****

image_type deprecated

string

No

[Obsoleto] Para la configuración del plano de control del clúster, use el parámetro image_type en control_plane_config en su lugar. Para la configuración del pool de nodos, use el parámetro image_type en scaling_group dentro de nodepool en su lugar.

El tipo de distribución del sistema operativo. Se recomienda usar este campo para especificar el sistema operativo del nodo. Valores válidos:

  • CentOS

  • AliyunLinux

  • AliyunLinux Qboot

  • AliyunLinuxUEFI

  • AliyunLinux3

  • Windows

  • WindowsCore

  • AliyunLinux3Arm64

  • ContainerOS

Valor predeterminado: CentOS.

AliyunLinux

instances deprecated

array

No

[Obsoleto] No se admite la selección de nodos existentes durante la creación del clúster. Para agregar nodos existentes a un clúster, cree primero un pool de nodos y llame a la operación AttachInstancesToNodePool.

La lista de instancias ECS que se utilizarán al crear un clúster con nodos existentes. Estas instancias se agregan al clúster como nodos de trabajo.

Nota

Este campo es obligatorio cuando se crea un clúster mediante instancias existentes.

string

No

La lista de instancias ECS que se utilizarán al crear un clúster con nodos existentes. Estas instancias se agregan al clúster como nodos de trabajo.

Nota

Este campo es obligatorio cuando se crea un clúster mediante instancias existentes.

i-2ze4zxnm36vq00xn****

ip_stack

string

No

La pila de protocolos IP del clúster.

Valores válidos: ipv4 (pila única) dual (pila doble). Valor predeterminado: ipv4

is_enterprise_security_group

boolean

No

Especifica si se debe habilitar la creación automática de un grupo de seguridad avanzado. Este parámetro surte efecto cuando security_group_id está vacío.

Nota

Cuando se utiliza un grupo de seguridad básico, el número total de nodos y pods de Terway en el clúster no puede superar los 2000. Por lo tanto, al crear un clúster de tipo de red Terway, utilice un grupo de seguridad avanzado.

  • true: crea y utiliza un grupo de seguridad avanzado.

  • false: utiliza un grupo de seguridad básico.

Valor predeterminado: true.

true

keep_instance_name deprecated

boolean

No

[Obsoleto] No se admite la selección de nodos existentes durante la creación del clúster. Para agregar nodos existentes a un clúster, cree primero un pool de nodos y llame a la operación AttachInstancesToNodePool.

Especifica si se deben conservar los nombres de las instancias al crear un clúster con instancias existentes.

  • true: conserva los nombres de las instancias.

  • false: no conserva los nombres de las instancias. Los nombres se reemplazan por nombres generados por el sistema.

Valor predeterminado: true.

true

key_pair deprecated

string

No

[Obsoleto] Para la configuración del plano de control del clúster, use el parámetro key_pair en control_plane_config en su lugar. Para la configuración del pool de nodos, use el parámetro key_pair en scaling_group dentro de nodepool en su lugar.

El nombre del par de claves. Es mutuamente excluyente con login_password.

security-key

kubernetes_version

string

No

La versión del clúster, que es coherente con la versión base de la comunidad de Kubernetes. Utilice la versión más reciente. Si no especifica este parámetro, se utiliza la versión más reciente de forma predeterminada.

Puede crear clústeres de las tres versiones más recientes. Llame a la operación DescribeKubernetesVersionMetadata para consultar las versiones de clúster admitidas.

Para obtener más información sobre las versiones de Kubernetes admitidas por ACK, consulte Resumen de lanzamiento de versiones de Kubernetes.

1.32.1-aliyun.1

load_balancer_id

string

No

El ID de instancia del Classic Load Balancer (CLB) que se utiliza para el acceso al servidor de API. Si se especifica este parámetro, se omite la creación automática de un CLB para el servidor de API.

Nota

Asegúrese de que la instancia CLB no tenga otras dependencias (como listeners o servidores backend). No se admiten instancias CLB compartidas ni orientadas a Internet.

lb-wz9t256gqa3vbouk****

load_balancer_spec deprecated

string

No

[Obsoleto] CLB utiliza la facturación por uso. Este parámetro no surte efecto.

La especificación de balanceo de carga. Valores válidos:

  • slb.s1.small

  • slb.s2.small

  • slb.s2.medium

  • slb.s3.small

  • slb.s3.medium

  • slb.s3.large

Valor predeterminado: slb.s2.small.

slb.s2.small

logging_type deprecated

string

No

[Obsoleto] Habilita el servicio de registros para el clúster. Este parámetro solo surte efecto para los clústeres ACK Serverless, y el valor debe ser SLS.

SLS

login_password deprecated

string

No

[Obsoleto] Para la configuración del plano de control del clúster, use el parámetro login_password en control_plane_config en su lugar. Para la configuración del pool de nodos, use el parámetro login_password en scaling_group dentro de nodepool en su lugar.

La contraseña de inicio de sesión SSH. Es mutuamente excluyente con key_pair. La contraseña debe tener de 8 a 30 caracteres de longitud y contener al menos tres de los siguientes tipos de caracteres: letras mayúsculas, letras minúsculas, dígitos y caracteres especiales.

null

maintenance_window maintenance_window

No

La ventana de operación y mantenimiento del clúster.

master_auto_renew deprecated

boolean

No

[Obsoleto] Para la configuración del plano de control del clúster, use el parámetro auto_renew en control_plane_config en su lugar.

Especifica si se debe habilitar la renovación automática para los nodos maestros. Este parámetro solo surte efecto cuando master_instance_charge_type se establece en PrePaid. Valores válidos:

  • true: habilita la renovación automática.

  • false: deshabilita la renovación automática.

Valor predeterminado: true.

true

master_auto_renew_period deprecated

integer

No

[Obsoleto] Para la configuración del plano de control del clúster, use el parámetro auto_renew_period en control_plane_config en su lugar.

El período de renovación automática para los nodos maestros. Este parámetro surte efecto y es obligatorio solo cuando se selecciona el método de facturación por suscripción.

Valores válidos: {1, 2, 3, 6, 12}.

Valor predeterminado: 1.

1

master_count deprecated

integer

No

[Obsoleto] Para la configuración del plano de control del clúster, use el parámetro size en control_plane_config en su lugar.

El número de nodos maestros. Valores válidos: 3 o 5.

Valor predeterminado: 3.

3

master_instance_charge_type deprecated

string

No

[Obsoleto] Para la configuración del plano de control del clúster, use el parámetro instance_charge_type en control_plane_config en su lugar.

El método de facturación para los nodos maestros. Valores válidos:

  • PrePaid: suscripción.

  • PostPaid: pago por uso.

Valor predeterminado: PostPaid.

PrePaid

master_instance_types deprecated

array

No

[Obsoleto] Para la configuración del plano de control del clúster, use el parámetro instance_types en control_plane_config en su lugar.

Los tipos de instancia para los nodos maestros. Para obtener más información, consulte Familias de instancias.

string

No

El tipo de instancia para un nodo maestro. El número de tipos de instancia especificados debe coincidir con el valor de master_count y corresponder uno a uno con los elementos en master_instance_types. Para obtener más información, consulte Familias de instancias.

ecs.n4.xlarge

master_period deprecated

integer

No

[Obsoleto] Para la configuración del plano de control del clúster, use el parámetro unit en control_plane_config en su lugar.

La duración de la suscripción para los nodos maestros. Este parámetro surte efecto y es obligatorio solo cuando master_instance_charge_type se establece en PrePaid.

Valores válidos: {1, 2, 3, 6, 12, 24, 36, 48, 60}.

Valor predeterminado: 1.

1

master_period_unit deprecated

string

No

[Obsoleto] Para la configuración del plano de control del clúster, use el parámetro period_unit en control_plane_config en su lugar.

La unidad del período de suscripción para los nodos maestros. Este parámetro es obligatorio cuando el método de facturación es PrePaid.

Valores válidos: Month. Actualmente, solo se admite la facturación mensual.

Month

master_system_disk_category deprecated

string

No

[Obsoleto] Para la configuración del plano de control del clúster, use el parámetro system_disk_category en control_plane_config en su lugar.

El tipo de disco en la nube del sistema para los nodos maestros. Valores válidos:

  • cloud_efficiency: disco en la nube ultra.

  • cloud_ssd: SSD estándar.

  • cloud_essd: SSD empresarial (ESSD).

Valor predeterminado: cloud_ssd. El valor predeterminado puede variar según la zona.

cloud_ssd

master_system_disk_performance_level deprecated

string

No

[Obsoleto] Para la configuración del plano de control del clúster, use el parámetro system_disk_performance_level en control_plane_config en su lugar.

El nivel de rendimiento (PL) del disco en la nube del sistema para los nodos maestros. Este parámetro solo surte efecto para los discos en la nube ESSD. El nivel de rendimiento está relacionado con el tamaño del disco. Para obtener más información, consulte Discos en la nube ESSD.

PL1

master_system_disk_size deprecated

integer

No

[Obsoleto] Para la configuración del plano de control del clúster, use el parámetro system_disk_size en control_plane_config en su lugar.

El tamaño del disco en la nube del sistema para los nodos maestros. Valores válidos: [40, 500]. Unidad: GiB.

Valor predeterminado: 120.

120

master_system_disk_snapshot_policy_id deprecated

string

No

[Obsoleto] Para la configuración del plano de control del clúster, use el parámetro system_disk_snapshot_policy_id en control_plane_config en su lugar.

El ID de la política de instantáneas automáticas para los discos en la nube del sistema de los nodos maestros.

sp-2zej1nogjvovnz4z****

master_vswitch_ids deprecated

array

No

[Obsoleto] Use el parámetro vswitch_ids en su lugar.

La lista de ID de vSwitch para los nodos maestros. El número de vSwitches debe estar en el rango de [1, 3]. Para garantizar la alta disponibilidad, seleccione tres vSwitches distribuidos en diferentes zonas.

El número de tipos de instancia especificados debe coincidir con el valor de master_count y corresponder uno a uno con los elementos en master_vswitch_ids.

string

No

La lista de ID de vSwitch para los nodos maestros. El número de vSwitches debe estar en el rango de [1, 3]. Para garantizar la alta disponibilidad, seleccione tres vSwitches distribuidos en diferentes zonas.

El número de tipos de instancia especificados debe coincidir con el valor de master_count y corresponder uno a uno con los elementos en master_vswitch_ids.

vsw-2ze3ds0mdip0hdz8i****

name

string

Sí

El nombre personalizado del clúster. El nombre puede contener dígitos, caracteres chinos, letras y guiones (-). Debe tener una longitud de 1 a 63 caracteres y no puede comenzar con un guion (-).

cluster-demo

nat_gateway deprecated

boolean

No

[Obsoleto] Use el parámetro snat_entry en su lugar.

true

node_cidr_mask

string

No

El número de direcciones IP por nodo, determinado al especificar el bloque CIDR de red. Este parámetro solo surte efecto para los clústeres de tipo de red Flannel.

Valor predeterminado: 26.

25

node_name_mode deprecated

string

No

[Obsoleto] Para la configuración del pool de nodos, use el parámetro node_name_mode en kubernetes_config dentro de nodepool en su lugar.

null

node_port_range deprecated

string

No

El rango de puertos de servicio del nodo. Rango de puertos válido: [30000, 65535].

Valor predeterminado: 30000-32767.

30000~32767

nodepools

array

No

La lista de pools de nodos.

nodepool

No

La configuración del pool de nodos.

num_of_nodes deprecated

integer

No

[Obsoleto] Use el parámetro desired_size bajo scaling_group en nodepool en su lugar.

El número de nodos de trabajo. Valores válidos: 0 a 100.

3

operation_policy

object

No

La política automática de operación y mantenimiento del clúster.

cluster_auto_upgrade

object

No

La configuración de actualización automática del clúster.

channel

string

No

La frecuencia de actualización automática del clúster. Valores válidos:

  • patch: Actualiza automáticamente a la última versión de parche disponible dentro de la versión menor actual. La nueva versión de Kubernetes no contiene cambios disruptivos.

  • stable: Actualiza automáticamente a la última versión de parche de la penúltima versión menor. La nueva versión de Kubernetes puede implicar cambios en la API y en las funciones, pero su estabilidad ha sido ampliamente validada.

  • rapid: Actualiza automáticamente a la última versión de parche de la última versión menor, lo que permite un acceso más rápido a las nuevas funciones de la comunidad de Kubernetes.

stable

enabled

boolean

No

Especifica si se debe habilitar la actualización automática del clúster.

  • true: Habilitado.

  • false: Deshabilitado.

true

os_type deprecated

string

No

[Obsoleto] Para la configuración de los nodos del plano de control del clúster, use el parámetro image_type bajo control_plane_config en su lugar. Para la configuración del grupo de nodos, use el parámetro image_type bajo scaling_group en nodepool en su lugar.

El tipo de plataforma del sistema operativo. Valores válidos:

  • Windows

  • Linux

Valor predeterminado: Linux.

Linux

period deprecated

integer

No

[Obsoleto]

La duración de la suscripción. Este parámetro surte efecto y es obligatorio solo cuando charge_type se establece en PrePaid.

Valores válidos: 1, 2, 3, 6, 12, 24, 36, 48 y 60.

Valor predeterminado: 1.

Este parámetro se modificó el 15 de octubre de 2024. Para obtener más información, consulte Aviso sobre cambios de comportamiento de los parámetros de la API CreateCluster.

1

period_unit deprecated

string

No

[Obsoleto]

El ciclo de facturación. Este parámetro es obligatorio cuando el método de facturación se establece en PrePaid.

Valores válidos: Month. Actualmente, solo se admiten ciclos de facturación mensuales.

Este parámetro se modificó el 15 de octubre de 2024. Para obtener más información, consulte Aviso sobre cambios de comportamiento de los parámetros de la API CreateCluster.

Month

platform deprecated

string

No

[Obsoleto] Para la configuración del grupo de nodos, use el parámetro platform bajo scaling_group en nodepool en su lugar.

La distribución del sistema operativo. Valores válidos:

  • CentOS

  • AliyunLinux

  • QbootAliyunLinux

  • Qboot

  • Windows

  • WindowsCore

Valor predeterminado: CentOS.

CentOS

pod_vswitch_ids deprecated

array

No

[Obsoleto] Cuando se selecciona el complemento de red Terway, debe especificar vSwitches para la asignación de direcciones IP de los pods. Cada vSwitch de pod corresponde a un vSwitch de nodo de trabajo, y las zonas de los vSwitches de pod y los vSwitches de nodo de trabajo deben ser las mismas.

Nota

La máscara de bloque CIDR del vSwitch de pod no debe exceder 19 y no debe ser mayor a 25. De lo contrario, el número de direcciones IP de pod disponibles en la red del clúster será muy limitado, lo que afecta las operaciones normales del clúster.

string

No

Cuando se selecciona el complemento de red Terway, debe especificar vSwitches para la asignación de direcciones IP de los pods. Cada vSwitch de pod corresponde a un vSwitch de nodo de trabajo, y las zonas de los vSwitches de pod y los vSwitches de nodo de trabajo deben ser las mismas.

Nota

La máscara de bloque CIDR del vSwitch de pod no debe exceder 19 y no debe ser mayor a 25. De lo contrario, el número de direcciones IP de pod disponibles en la red del clúster será muy limitado, lo que afecta las operaciones normales del clúster.

vsw-2ze97jwri7cei0mpw****

profile

string

No

Cuando establece cluster_type en ManagedKubernetes para clústeres administrados de ACK, puede especificar además el subtipo de clúster.

  • Default: Clúster administrado de ACK, incluidos los clústeres de ACK (ediciones Pro y Basic).

  • Edge: Clúster ACK Edge, incluidos los clústeres ACK Edge (ediciones Pro y Basic).

  • Serverless: Clúster ACK Serverless, incluidos los clústeres ACK Serverless (ediciones Pro y Basic).

  • Lingjun: Clúster ACK Lingjun, disponible en la edición Pro.

Default

proxy_mode

string

No

El modo de kube-proxy.

  • iptables: Un modo de kube-proxy maduro y estable. El descubrimiento de servicios y el balanceo de carga para los servicios de Kubernetes se configuran mediante reglas de iptables. El rendimiento es moderado y se ve afectado por la escala. Este modo es adecuado para clústeres con un número reducido de servicios.

  • ipvs: Un modo de kube-proxy de alto rendimiento. El descubrimiento de servicios y el balanceo de carga para los servicios de Kubernetes se configuran mediante el módulo IPVS de Linux. Este modo es adecuado para clústeres con una gran cantidad de servicios que requieren un alto rendimiento de balanceo de carga.

  • nftables: Un modo de kube-proxy de próxima generación que implementa el descubrimiento de servicios y el balanceo de carga basados en nftables de Linux. Es un reemplazo moderno de iptables. En comparación con iptables, nftables ofrece un mejor rendimiento de red, actualizaciones de reglas más eficientes y un comportamiento mejorado en escenarios de servicios a gran escala.
    Solo es compatible con clústeres que ejecutan la versión 1.35 o posterior. La comunidad de Kubernetes marcó IPVS como obsoleto a partir de la versión 1.35. Para los nuevos clústeres, use nftables para obtener soporte de la comunidad a más largo plazo.

Valor predeterminado: ipvs.

ipvs

rds_instances deprecated

array

No

[Obsoleto] Para la configuración del grupo de nodos, use el parámetro rds_instances bajo scaling_group en nodepool en su lugar.

La lista de instancias de ApsaraDB RDS a las que desea agregar los nodos del clúster a la lista blanca. Agregue el bloque CIDR del pod del contenedor y el bloque CIDR del nodo directamente a la lista blanca de RDS. La configuración de las instancias de RDS puede fallar si las instancias no se encuentran en estado de ejecución.

string

No

La lista de instancias de ApsaraDB RDS a las que desea agregar los nodos del clúster a la lista blanca. Agregue el bloque CIDR del pod del contenedor y el bloque CIDR del nodo directamente a la lista blanca de RDS. La configuración de las instancias de RDS puede fallar si las instancias no se encuentran en estado de ejecución.

rm-2zev748xi27xc****

region_id

string

Sí

El ID de la región donde se despliega el clúster. Para obtener más información, consulte Regiones admitidas por el servicio de contenedores.

cn-beijing

resource_group_id

string

No

El ID del grupo de recursos al que pertenece el clúster. Use este parámetro para aislar diferentes recursos.

rg-acfm3mkrure****

rrsa_config

object

No

La configuración de la función RAM Roles for Service Accounts (RRSA).

enabled

boolean

No

Especifica si se debe habilitar la función RRSA.

  • true: Habilitado.

  • false: Deshabilitado.

true

runtime deprecated runtime

No

El entorno de ejecución de contenedores utilizado en el clúster. Los entornos de ejecución admitidos incluyen containerd, contenedores en entorno aislado y Docker.

Nota

Kubernetes 1.24 ya no admite Docker como entorno de ejecución de contenedores integrado.

Para obtener más información, consulte Comparación de los entornos de ejecución de Docker, containerd y contenedores en entorno aislado.

security_group_id

string

No

El ID de un grupo de seguridad existente. Este parámetro es mutuamente excluyente con is_enterprise_security_group. Los nodos del clúster se agregan automáticamente a este grupo de seguridad.

sg-bp1bdue0qc1g7k****

security_hardening_os deprecated

boolean

No

[Obsoleto] Para la configuración del plano de control del clúster, use el parámetro security_hardening_os bajo control_plane_config en su lugar. Para la configuración del grupo de nodos, use el parámetro security_hardening_os bajo scaling_group en nodepool en su lugar.

Especifica si se debe habilitar el endurecimiento de seguridad del sistema operativo de Alibaba Cloud. Valores válidos:

  • true: Habilita el endurecimiento de seguridad del sistema operativo de Alibaba Cloud.

  • false: No habilita el endurecimiento de seguridad del sistema operativo de Alibaba Cloud.

Valor predeterminado: false.

false

service_account_issuer

string

No

Una ServiceAccount es la credencial de acceso utilizada para la comunicación entre un pod y el servidor de API del clúster. El service-account-issuer es la identidad del emisor en el token de serviceaccount, que es el campo iss en la carga útil del token.

Para obtener más información sobre ServiceAccount, consulte Implementación de la proyección de volumen de token de cuenta de servicio.

kubernetes.default.svc

service_cidr

string

No

El bloque CIDR para los servicios. Rangos válidos: 10.0.0.0/16-24, 172.16-31.0.0/16-24 y 192.168.0.0/16-24. El bloque CIDR no puede superponerse con el bloque CIDR de VPC 10.1.0.0/21 ni con los bloques CIDR utilizados por los clústeres de Kubernetes existentes en la VPC. Este valor no se puede modificar después de crear el clúster.

Valor predeterminado: 172.19.0.0/20.

172.21.0.0/20

service_discovery_types deprecated

array

No

[Obsoleto] El tipo de descubrimiento de servicios dentro del clúster, utilizado para especificar el método de descubrimiento de servicios en los clústeres ACK Serverless.

  • CoreDNS: Utiliza el componente estándar de descubrimiento de servicios nativo de Kubernetes, CoreDNS. Se debe desplegar un conjunto de contenedores en el clúster para la resolución de DNS. De forma predeterminada, se utilizan dos instancias ECI de 0.25 Core y 512 MiB.

  • PrivateZone: Utiliza Alibaba Cloud PrivateZone para proporcionar capacidades de descubrimiento de servicios. El servicio PrivateZone debe estar activado.

Valor predeterminado: no habilitado.

string

No

El tipo de descubrimiento de servicios dentro del clúster, que se utiliza para especificar el método de descubrimiento de servicios en los clústeres ACK Serverless.

  • CoreDNS: Utiliza el componente estándar de descubrimiento de servicios nativo de Kubernetes, CoreDNS. Se debe desplegar un conjunto de contenedores en el clúster para la resolución de DNS. De forma predeterminada, se utilizan dos instancias ECI de 0.25 núcleos y 512 MiB.

  • PrivateZone: Utiliza Alibaba Cloud PrivateZone para proporcionar capacidades de descubrimiento de servicios. El servicio PrivateZone debe estar activado.

Valor predeterminado: no habilitado.

PrivateZone

snat_entry

boolean

No

Configuración para habilitar SNAT en la VPC. Valores válidos:

  • true: Habilita la creación automática de una puerta de enlace NAT y la configuración automática de reglas SNAT. Establézcalo en true si los nodos y las aplicaciones del clúster necesitan acceso a Internet.

  • false: No crea una puerta de enlace NAT ni reglas SNAT. Los nodos y las aplicaciones del clúster no pueden acceder a Internet.

Nota

Si no se habilita durante la creación del clúster y posteriormente se requiere acceso a Internet, puede habilitarlo manualmente.

Valor predeterminado: false.

false

soc_enabled deprecated

boolean

No

[Obsoleto] Para la configuración de los nodos del plano de control del clúster, use el parámetro soc_enabled bajo control_plane_config en su lugar. Para la configuración del grupo de nodos, use el parámetro soc_enabled bajo scaling_group en nodepool en su lugar.

Especifica si se debe habilitar el fortalecimiento de seguridad MLPS 2.0. Para obtener más información, consulte Cumplimiento de protección clasificada de China para ACK.

Valores válidos:

  • true: Habilita el fortalecimiento de seguridad MLPS 2.0.

  • false: No habilita el fortalecimiento de seguridad MLPS 2.0.

Valor predeterminado: false.

false

ssh_flags

boolean

No

Especifica si se debe habilitar el inicio de sesión SSH público. Se utiliza para iniciar sesión en los nodos maestros de los clústeres dedicados de ACK. Este parámetro no surte efecto en los clústeres administrados.

  • true: Habilitado.

  • false: No habilitado.

Valor predeterminado: false.

true

tags

array

No

Las etiquetas de los nodos. Reglas de definición de etiquetas:

  • Las etiquetas son pares clave-valor que distinguen entre mayúsculas y minúsculas. Puede configurar hasta 20 etiquetas.

  • Las claves de etiqueta no pueden duplicarse y pueden tener hasta 64 caracteres de longitud. Los valores de etiqueta pueden estar vacíos y tener hasta 128 caracteres de longitud. Las claves y los valores de etiqueta no pueden comenzar con "aliyun", "acs:", "https://" ni "http://". Para obtener más información, consulte Etiquetas y selectores.

tag

No

Las etiquetas de los nodos. Reglas de definición de etiquetas:

  • Las etiquetas son pares clave-valor que distinguen entre mayúsculas y minúsculas. Puede configurar hasta 20 etiquetas.

  • Las claves de etiqueta no pueden duplicarse y pueden tener hasta 64 caracteres de longitud. Los valores de etiqueta pueden estar vacíos y tener hasta 128 caracteres de longitud. Las claves y los valores de etiqueta no pueden comenzar con "aliyun", "acs:", "https://" ni "http://". Para obtener más información, consulte Etiquetas y selectores.

taints deprecated

array

No

[Obsoleto] Para la configuración del grupo de nodos, use el parámetro taints bajo kubernetes_config en nodepool en su lugar.

La información de taints de los nodos. Los taints y las tolerancias funcionan en conjunto para evitar que los pods se programen en nodos inapropiados. Para obtener más información, consulte taint-and-toleration.

taint

No

La información de taints de los nodos. Los taints y las tolerancias funcionan en conjunto para evitar que los pods se programen en nodos inapropiados. Para obtener más información, consulte taint-and-toleration.

timeout_mins deprecated

integer

No

[Obsoleto] De forma predeterminada, el sistema no revierte los cambios cuando falla la creación del clúster. Debe limpiar manualmente el clúster fallido.

El tiempo de espera de creación del clúster, en minutos.

Valor predeterminado: 60.

60

timezone

string

No

La zona horaria que utiliza el clúster. Para obtener más información, consulte Zonas horarias admitidas.

Asia/Shanghai

user_ca

string

No

La autoridad de certificación (CA) personalizada del clúster.

-----BEGIN CERTIFICATE-----****

user_data deprecated

string

No

[Obsoleto] Los datos personalizados del nodo.

IyEvdXNyL2Jpbi9iYXNoCmVjaG8gIkhlbGxvIEFD****

vpcid

string

No

La VPC que utiliza el clúster. Debe proporcionar una VPC al crear un clúster.

vpc-2zeik9h3ahvv2zz95****

vswitch_ids

array

No

Los vSwitches para los nodos del clúster. Este parámetro es obligatorio al crear un clúster administrado sin nodos.

string

No

Los vSwitches para los nodos del clúster. Este parámetro es obligatorio al crear un clúster administrado sin nodos.

vsw-2ze3ds0mdip0hdz8i****

worker_auto_renew deprecated

boolean

No

[Obsoleto] Para la configuración del grupo de nodos, use el parámetro auto_renew bajo scaling_group en nodepool en su lugar.

Especifica si se debe habilitar la renovación automática para los nodos de trabajo. Este parámetro solo surte efecto cuando worker_instance_charge_type se establece en PrePaid. Valores válidos:

  • true: Habilita la renovación automática.

  • false: No habilita la renovación automática.

Valor predeterminado: true.

true

worker_auto_renew_period deprecated

integer

No

[Obsoleto] Para la configuración del grupo de nodos, use el parámetro auto_renew_period bajo scaling_group en nodepool en su lugar.

El ciclo de renovación automática para los nodos de trabajo. Este parámetro surte efecto y es obligatorio solo cuando se selecciona el método de facturación por suscripción.

Valores válidos: 1, 2, 3, 6 y 12.

1

worker_data_disks deprecated

array<object>

No

[Obsoleto] En su lugar, use el parámetro data_disks en scaling_group del grupo de nodos.

La combinación del tipo, tamaño y otras configuraciones de discos en la nube de datos para los nodos de trabajo.

object

No

El conjunto de configuraciones de discos en la nube de datos.

category

string

Sí

El tipo de disco en la nube de datos.

cloud_essd

encrypted

string

No

Especifica si se deben cifrar los discos en la nube de datos. Valores válidos:

  • true: cifra los discos en la nube de datos.

  • false: no cifra los discos en la nube de datos.

Valor predeterminado: false.

true

performance_level

string

No

El nivel de rendimiento de los discos en la nube de datos de los nodos. Este parámetro solo surte efecto para los discos en la nube ESSD.

PL1

size

string

Sí

El tamaño del disco en la nube de datos. Valores válidos: de 40 a 32767. Unidad: GiB.

120

worker_instance_charge_type deprecated

string

No

[Obsoleto] En su lugar, use el parámetro instance_charge_type en scaling_group del grupo de nodos.

El método de facturación para los nodos de trabajo. Valores válidos:

  • PrePaid: suscripción.

  • PostPaid: pago por uso.

Valor predeterminado: pago por uso.

PrePaid

worker_instance_types deprecated

array

No

[Obsoleto] En su lugar, use el parámetro instance_types en scaling_group del grupo de nodos.

Las configuraciones de instancia para los nodos de trabajo.

string

No

El tipo de instancia para los nodos de trabajo. Especifique al menos un tipo de instancia. Para obtener más información, consulte Familias de instancias.

Nota

La prioridad de un tipo de instancia disminuye a medida que aumenta su posición en la matriz. Si no se puede crear una instancia basada en un tipo de instancia de mayor prioridad, el sistema utiliza automáticamente el siguiente tipo de instancia en prioridad.

ecs.n4.large

worker_period deprecated

integer

No

[Obsoleto] En su lugar, use el parámetro period en scaling_group del grupo de nodos.

La duración de la suscripción para los nodos de trabajo. Este parámetro solo surte efecto y es obligatorio cuando worker_instance_charge_type se establece en PrePaid.

Valores válidos: {1, 2, 3, 6, 12, 24, 36, 48, 60}.

Valor predeterminado: 1.

1

worker_period_unit deprecated

string

No

[Obsoleto] En su lugar, use el parámetro period_unit en scaling_group del grupo de nodos.

El ciclo de facturación para los nodos de trabajo. Este parámetro es obligatorio cuando el método de facturación es PrePaid.

Valores válidos: Month. Actualmente, solo se admiten ciclos de facturación mensuales.

Month

worker_system_disk_category deprecated

string

No

[Obsoleto] En su lugar, use el parámetro system_disk_category en scaling_group del grupo de nodos.

El tipo de disco en la nube del sistema para los nodos de trabajo. Para obtener más información, consulte Introducción al almacenamiento de bloques.

Valores válidos:

  • cloud_efficiency: disco en la nube ultra.

  • cloud_ssd: SSD estándar.

Valor predeterminado: cloud_ssd.

cloud_efficiency

worker_system_disk_performance_level deprecated

string

No

[Obsoleto] En su lugar, use el parámetro system_disk_performance_level en scaling_group del grupo de nodos.

Cuando el disco en la nube del sistema es un ESSD, puede configurar el nivel de rendimiento (PL) del ESSD. Para obtener más información, consulte Discos en la nube ESSD.

Valores válidos:

  • PL0

  • PL1

  • PL2

  • PL3

PL1

worker_system_disk_size deprecated

integer

No

[Obsoleto] En su lugar, use el parámetro system_disk_size en scaling_group del grupo de nodos.

El tamaño del disco en la nube del sistema para los nodos de trabajo. Unidad: GiB.

Valores válidos: [40,500].

El valor de este parámetro debe ser mayor o igual que max{40, ImageSize}.

Valor predeterminado: 120.

120

worker_system_disk_snapshot_policy_id deprecated

string

No

[Obsoleto] En su lugar, use el parámetro system_disk_snapshot_policy_id en scaling_group del grupo de nodos.

El ID de la política de instantáneas automáticas que utilizan los discos en la nube del sistema de los nodos de trabajo.

sp-2zej1nogjvovnz4z****

worker_vswitch_ids deprecated

array

No

[Obsoleto] En su lugar, use el parámetro vswitch_ids en scaling_group del grupo de nodos.

La lista de vSwitches que utilizan los nodos del clúster. Cada nodo corresponde a un valor.

Cuando crea un clúster administrado con cero nodos, el campo worker_vswitch_ids no es obligatorio, pero debe proporcionar vswitch_ids.

string

No

La lista de vSwitches para los nodos de trabajo. Valores válidos: [1,20]. Para garantizar la alta disponibilidad, seleccione vSwitches en diferentes zonas.

Cuando crea un clúster administrado con cero nodos, el campo worker_vswitch_ids no es obligatorio, pero debe proporcionar vswitch_ids.

vsw-2ze3ds0mdip0hdz8i****

zone_id deprecated

string

No

[Obsoleto] En su lugar, use el parámetro zone_ids.

El ID de la zona activa de la región a la que pertenece el clúster. Este parámetro es específico de los clústeres administrados de ACK.

Al crear un clúster administrado de ACK, si no se especifican vpc_id y vswitch_ids, debe especificar zone_id para que el clúster cree automáticamente una VPC y los recursos de red relacionados en esta zona. Si se especifican vpc_id y vswitch_ids, este parámetro no surte efecto.

cn-beiji****

zone_ids

array

No

Los ID de varias zonas de la región a la que pertenece el clúster. Este parámetro es específico de los clústeres administrados de ACK.

string

No

El ID de la zona activa de la región a la que pertenece el clúster. Los vSwitches se crean automáticamente en esta zona.

Al crear un clúster administrado de ACK, si no se especifican vpc_id y vswitch_ids, debe especificar zone_ids para que el clúster cree automáticamente una VPC y los recursos de red relacionados en varias zonas activas. Si se especifican vpc_id y vswitch_ids, este parámetro no surte efecto.

cn-beijing-h

Elementos de la respuesta

Elemento

Tipo

Descripción

Ejemplo

object

El cuerpo de la respuesta.

cluster_id

string

El ID del clúster.

cb95aa626a47740afbf6aa099b650****

request_id

string

El ID de la solicitud.

687C5BAA-D103-4993-884B-C35E4314****

task_id

string

El ID de la tarea.

T-5a54309c80282e39ea****

Ejemplos

Respuesta exitosa

JSON Formato

{
  "cluster_id": "cb95aa626a47740afbf6aa099b650****",
  "request_id": "687C5BAA-D103-4993-884B-C35E4314****",
  "task_id": "T-5a54309c80282e39ea****"
}

Códigos de error

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.