Todos los productos
Search
Centro de documentos

:Parámetros de uso frecuente

Última actualización: Sep 09, 2026

addon

Configuración de los componentes del clúster.

Parámetro

Tipo

Ejemplo

Descripción

name

String

nginx-ingress-controller

Nombre del componente.

config

String

{\"IngressSlbNetworkType\":\"internet\"}

Configuración del componente.

disabled

Boolean

false

Indica si un componente se instala automáticamente en un clúster recién creado. Además de los componentes obligatorios, durante la creación del clúster también se instalan algunos componentes opcionales, como los de Simple Log Service. Establezca este parámetro para deshabilitar la instalación automática de un componente opcional. Una vez creado el clúster, instale el componente desde la consola o mediante una llamada a la API. Valores válidos:

  • true: deshabilita la instalación automática del componente.
  • false: permite la instalación automática del componente.

data_disk

Configuración de los discos de datos de los nodos.

Parámetro

Tipo

Ejemplo

Descripción

category

String

cloud_ssd

Tipo de disco de datos. Valores válidos:

  • cloud: disco básico.
  • cloud_efficiency: ultra disk.
  • cloud_ssd: SSD estándar.
  • cloud_essd: SSD mejorado.
  • cloud_auto: ESSD AutoPL.

Valor predeterminado: cloud_efficiency.

size

Long

40

Tamaño del disco de datos. Unidad: GiB.

Valores válidos: de 40 a 32768.

Valor predeterminado: 120.

encrypted

String

true

Indica si se cifra el disco de datos. Valores válidos:

  • true: cifra el disco de datos.
  • false: no cifra el disco de datos.

Valor predeterminado: false.

auto_snapshot_policy_id

String

sp-2zej1nogjvovnz4z****

ID de la política de instantáneas automáticas. La copia de seguridad automática del disco se ejecuta según la política especificada.

De forma predeterminada, este parámetro está vacío, lo que indica que la copia de seguridad automática está deshabilitada.

performance_level

String

PL1

Nivel de rendimiento (PL) del disco de datos. Este parámetro solo surte efecto en los discos SSD mejorados. Si aumenta el tamaño del disco de datos, especifique un PL más alto. Para obtener más información, consulte Discos SSD mejorados.

provisioned_iops

Long

1000

IOPS predefinidas del disco de datos. Valores válidos: de 0 a min{50,000, 1,000 × Capacity - Baseline IOPS}. Baseline IOPS = min{1,800 + 50 × Capacity, 50,000}

Este parámetro solo es compatible cuando DiskCategory se establece en cloud_auto. Para obtener más información, consulte Discos ESSD AutoPL.

bursting_enabled

Boolean

true

Indica si se habilita la función de ráfaga para el disco de datos. Valores válidos:

  • true: habilita la función de ráfaga para el disco de datos.
  • false: deshabilita la función de ráfaga para el disco de datos.

Este parámetro solo es compatible cuando DiskCategory se establece en cloud_auto. Para obtener más información, consulte Discos ESSD AutoPL.

maintenance_window

Configuración de la ventana de mantenimiento del clúster.

Parámetro

Tipo

Ejemplo

Descripción

enable

Boolean

false

Indica si se habilita la ventana de mantenimiento del clúster. Valores válidos:

  • true: habilita la ventana de mantenimiento del clúster.
  • false: deshabilita la ventana de mantenimiento del clúster.

Valor predeterminado: false.

maintenance_time

String

03:00:00Z

Hora de inicio de la ventana de mantenimiento del clúster. El valor debe seguir el formato de hora estándar de Golang. Ejemplo: 15:04:05Z.

duration

String

3h

Duración de la ventana de mantenimiento del clúster. El rango va de 1 a 24 horas. Unidad: h.

Valor predeterminado: 3h.

weekly_period

String

Monday,Thursday

Día de la semana en que se ejecuta el mantenimiento. Separe varios días con comas (,). Valores válidos: Monday, Tuesday, Wednesday, Thursday, Friday, Saturday y Sunday.

Valor predeterminado: Thursday.

nodepool

Configuración de los node pools.

Parámetro

Tipo

Ejemplo

Descripción

auto_scaling

Object

Configuración de escalado automático del node pool.

enable

Boolean

true

Indica si se habilita el escalado automático para un node pool.

  • true: habilita el escalado automático del node pool.
  • false: deshabilita el escalado automático del node pool. Si establece este parámetro en false, los demás parámetros de la sección auto_scaling no surten efecto.

Valor predeterminado: false.

max_instances

Long

10

Número máximo de instancias de Elastic Compute Service (ECS) que se pueden crear en el node pool.

min_instances

Long

0

Número mínimo de instancias ECS que deben mantenerse en el node pool.

type

String

cpu

Tipos de instancia utilizables para el escalado automático del node pool. Valores válidos:

  • cpu: instancia estándar.
  • gpu: instancia acelerada por GPU.
  • gpushare: instancia acelerada por GPU compartida.
  • spot: preemptible instance.

Valor predeterminado: cpu.

is_bond_eip

Boolean

true

Este parámetro está obsoleto.

Indica si se asocia una EIP al node pool. Valores válidos:

  • true: asocia una EIP al node pool.
  • false: no asocia ninguna EIP al node pool.

Valor predeterminado: false.

eip_internet_charge_type

String

PayByBandwidth

Este parámetro está obsoleto.

Método de medición de la EIP. Valores válidos:

  • PayByBandwidth: pago por ancho de banda.
  • PayByTraffic: pago por transferencia de datos.

Valor predeterminado: PayByBandwidth.

eip_bandwidth

Long

5

Este parámetro está obsoleto.

Ancho de banda máximo de la EIP. Unidad: Mbit/s.

kubernetes_config

Object

Configuración del clúster donde se despliega el node pool.

cms_enabled

Boolean

true

Indica si se instala el agente de CloudMonitor en los nodos ECS. Una vez instalado, podrá consultar la información de monitoreo de las instancias en la consola de CloudMonitor. Se recomienda instalar el agente de CloudMonitor. Valores válidos:

  • true: instala el agente de CloudMonitor en los nodos ECS.
  • false: no instala el agente de CloudMonitor en los nodos ECS.

Valor predeterminado: false.

cpu_policy

String

none

Política de administración de CPU de los nodos del node pool. A continuación se muestran las políticas compatibles si la versión de Kubernetes del clúster es 1.12.6 o posterior.

  • static: otorga mayor afinidad y exclusividad de CPU a los pods con características de recursos específicas en el nodo.
  • none: utiliza la afinidad de CPU predeterminada.

Valor predeterminado: none.

labels

Array of tag

Etiquetas de los nodos del node pool. Agregue etiquetas a los nodos del clúster.

runtime

String

containerd

Entorno de ejecución de contenedores. Valores válidos:

  • containerd: admite todas las versiones de Kubernetes. Se recomienda usar containerd.
  • Sandboxed-Container.runv: permite ejecutar aplicaciones en contenedores aislados, los cuales ofrecen mayor seguridad. Solo Kubernetes 1.24 y versiones anteriores admiten Sandboxed-Container.
  • docker: compatible con Kubernetes 1.22 y versiones anteriores.

Valor predeterminado: containerd.

runtime_version

String

1.6.20

Versión del entorno de ejecución de contenedores.

taints

Array of taint

Taints.

user_data

String

MXM=

Datos definidos por el usuario en el nodo.

node_name_mode

String

customized,aliyun,ip,com

Un nombre de nodo personalizado consta de un prefijo, una dirección IP del nodo y un sufijo.

  • El prefijo y el sufijo pueden contener varias partes separadas por puntos (.). Cada parte puede incluir letras minúsculas, dígitos y guiones (-). Un nombre de nodo personalizado debe comenzar y terminar con un dígito o una letra minúscula.
  • La dirección IP del nodo en un nombre personalizado corresponde a la dirección IP privada del nodo.

Establezca el valor con el formato customized,aliyun,ip,com. El valor consta de cuatro partes separadas por comas (,). Los elementos customized e ip son contenido fijo; aliyun es el prefijo y com es el sufijo. Ejemplo: aliyun.192.168.xxx.xxx.com.

nodepool_info

Object

Configuración del node pool.

name

String

np-test

Nombre del node pool.

resource_group_id

String

rg-acfmyvw3wjm****

ID del resource group al que pertenece el node pool.

type

String

ess

Tipo de node pool. Valores válidos:

  • ess: node pool.
  • edge: node pool perimetral.

scaling_group

Object

Configuración del grupo de escalado que utiliza el node pool.

auto_renew

Boolean

false

Indica si se habilita la renovación automática para un node pool. Este parámetro solo surte efecto cuando 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.

auto_renew_period

Long

0

Periodo de renovación automática de los nodos del node pool. Este parámetro surte efecto y es obligatorio únicamente cuando instance_charge_type se establece en PrePaid.

Si especifica PeriodUnit=Month, los valores válidos son 1, 2, 3, 6 y 12.

Valor predeterminado: 1.

data_disks

Array of data_disk

Configuración de los discos de datos que desea adjuntar a los nodos del node pool.

image_id

String

aliyun_2_1903_x64_20G_alibase_20200904.vhd

ID de una imagen personalizada. De forma predeterminada, se usa la imagen proporcionada por ACK.

instance_charge_type

String

PostPaid

Método de facturación de los nodos del node pool. Valores válidos:

  • PrePaid: método de facturación por suscripción.
  • PostPaid: método de facturación pay-as-you-go.

Valor predeterminado: PostPaid.

instance_types

Array of String

ecs.n1.medium

Tipo de instancia.

key_pair

String

np-key

Nombre de la key pair. Establezca este parámetro o el parámetro login_password.

Nota

Establezca key_pair si el node pool es administrado.

login_password

String

Hello1234

Contraseña para iniciar sesión mediante SSH. Establezca este parámetro o el parámetro key_pair. La contraseña debe tener entre 8 y 30 caracteres, e incluir como mínimo tres de los siguientes tipos de caracteres: letras mayúsculas, letras minúsculas, dígitos y caracteres especiales.

period

Long

0

Duración de la suscripción de los nodos de un node pool. Este parámetro surte efecto y es obligatorio únicamente cuando instance_charge_type se establece en PrePaid. Los valores válidos de period son 1, 2, 3, 6 y 12 cuando period_unit se establece en Month.

Valor predeterminado: 1.

period_unit

String

Month

Unidad de la duración de la suscripción. Este parámetro es obligatorio cuando instance_charge_type se establece en PrePaid.

Valor válido: Month.

platform

String

AliyunLinux

Versión del sistema operativo. Valores válidos:

  • CentOS
  • AliyunLinux
  • Windows
  • WindowsCore

Valor predeterminado: AliyunLinux.

rds_instances

Array of String

rm-2zey3t89t6280****

ID de las instancias de ApsaraDB RDS.

spot_strategy

String

NoSpot

Tipo de preemptible instance. Valores válidos:

  • NoSpot: instancia que no es preemptible instance.
  • SpotWithPriceLimit: preemptible instance configurada con el precio de oferta máximo.
  • SpotAsPriceGo: preemptible instance cuya oferta el sistema realiza automáticamente según el precio actual del mercado.

Para obtener más información, consulte Preemptible instances.

spot_price_limit

Array

Tipo de instancia para las preemptible instances y límite de precio de dicho tipo.

instance_type

String

ecs.c6.large

Tipo de instancia de las preemptible instances.

price_limit

String

0.39

Precio de oferta máximo de una preemptible instance.

scaling_policy

String

release

Modo de escalado del grupo de escalado. Valores válidos:

  • release: modo estándar. Las instancias ECS se crean y liberan según el uso de recursos.
  • recycle: modo rápido. Durante los eventos de escalado, las instancias ECS se crean, detienen o inician, lo que reduce el tiempo necesario para el siguiente evento de escalado horizontal. Cuando la instancia está detenida, solo se cobra por el servicio de almacenamiento. Esto no aplica a las instancias ECS con discos locales adjuntos.

Valor predeterminado: release.

security_group_id

String

sg-2zeihch86ooz9io4****

ID del security group al que desea agregar el node pool. Establezca este parámetro o security_group_ids. Se recomienda establecer security_group_ids.

security_group_ids

Array of String

sg-2zeihch86ooz9io4****

ID del security group.

system_disk_category

String

cloud_efficiency

Tipo de disco del sistema. Valores válidos:

  • cloud_efficiency: ultra disk.
  • cloud_ssd: SSD estándar.
  • cloud_essd: SSD mejorado.
  • cloud_auto: ESSD AutoPL.

Valor predeterminado: cloud_efficiency.

system_disk_size

Long

120

Tamaño del disco del sistema de un nodo. Unidad: GiB.

Valores válidos: de 40 a 500.

system_disk_performance_level

String

PL1

Nivel de rendimiento (PL) del disco del sistema que desea usar para el nodo. Este parámetro solo surte efecto en los discos ESSD.

  • PL0: rendimiento de E/S concurrente máximo moderado y latencia de E/S baja.
  • PL1: rendimiento de E/S concurrente máximo moderado y latencia de E/S baja.
  • PL2: rendimiento de E/S concurrente máximo alto y latencia de E/S baja.
  • PL3: rendimiento de E/S concurrente máximo ultrarrápido y latencia de E/S muy baja.

system_disk_provisioned_iops

Long

1000

IOPS predefinidas de un disco del sistema. Valores válidos: de 0 a min{50,000, 1,000 × Capacity - Baseline IOPS}. Baseline IOPS = min{1,800 + 50 × Capacity, 50,000}

Este parámetro solo es compatible cuando SystemDiskCategory se establece en cloud_auto. Para obtener más información, consulte Discos ESSD AutoPL.

system_disk_bursting_enabled

Boolean

true

Indica si se habilita la función de ráfaga para los discos del sistema. Valores válidos:

  • true: habilita la función de ráfaga.
  • false: deshabilita la función de ráfaga.

Este parámetro solo es compatible cuando SystemDiskCategory se establece en cloud_auto. Para obtener más información, consulte Discos ESSD AutoPL.

tags

Array

Etiquetas que desea agregar a las instancias ECS.

Cada clave debe ser única y no superar los 128 caracteres. Ni las claves ni los valores pueden comenzar con aliyun o acs:. Tampoco pueden contener https:// ni http://.

key

String

key

Clave de una etiqueta.

value

String

value

Valor de una etiqueta.

vswitch_ids

Array of String

vsw-2ze0fmpbwo140ahni****

ID de los vSwitches.

multi_az_policy

String

COST_OPTIMIZED

Política de escalado de instancias ECS para un grupo de escalado multizona. Valores válidos:

  • PRIORITY: el grupo de escalado escala según el parámetro VSwitchIds.N. Si no es posible crear una instancia ECS en la zona donde reside el vSwitch de mayor prioridad, Auto Scaling crea la instancia ECS en la zona del vSwitch con la siguiente prioridad más alta.

  • COST_OPTIMIZED: las instancias ECS se crean ordenadas de forma ascendente según el precio unitario de vCPU. Se da preferencia a la creación de preemptible instances cuando la configuración de escalado especifica tipos de preemptible instances. Mediante el parámetro CompensateWithOnDemand, indique si se crean automáticamente instancias pay-as-you-go cuando no sea posible crear preemptible instances por falta de recursos.

    Nota

    COST_OPTIMIZED solo es válido cuando se especifican varios tipos de instancia o como mínimo un tipo de preemptible instance.

  • BALANCE: las instancias ECS se distribuyen uniformemente entre las múltiples zonas especificadas por el grupo de escalado. Si la distribución de instancias ECS pierde equilibrio entre varias zonas debido a inventario insuficiente, llame a la operación RebalanceInstances de Auto Scaling para equilibrarla. Para obtener más información, consulte RebalanceInstances.

Valor predeterminado: PRIORITY.

on_demand_base_capacity

Long

0

Número mínimo de instancias pay-as-you-go que deben mantenerse en el grupo de escalado. Valores válidos: de 0 a 1000. Si la cantidad de instancias pay-as-you-go es menor que el valor de este parámetro, Auto Scaling da preferencia a la creación de instancias pay-as-you-go.

on_demand_percentage_above_base_capacity

Long

20

Porcentaje de instancias pay-as-you-go entre las instancias adicionales que superan la cantidad indicada por on_demand_base_capacity. Valores válidos: de 0 a 100.

spot_instance_pools

Long

5

Número de tipos de instancia disponibles para crear preemptible instances. Auto Scaling crea preemptible instances de varios tipos de instancia disponibles al costo más bajo. Valores válidos: de 1 a 10.

spot_instance_remedy

Boolean

false

Indica si se reponen las preemptible instances. Si este parámetro se establece en true y el grupo de escalado recibe un mensaje del sistema sobre la recuperación de una preemptible instance, el grupo intenta crear una nueva instancia para reemplazarla. Valores válidos:

  • true: habilita la reposición de preemptible instances.
  • false: deshabilita la reposición de preemptible instances.

compensate_with_on_demand

Boolean

true

Indica si se crean automáticamente instancias pay-as-you-go para cumplir con la cantidad requerida de instancias ECS cuando no es posible crear preemptible instances por motivos de costo o inventario insuficiente. Este parámetro solo surte efecto cuando multi_az_policy se establece en COST_OPTIMIZED. Valores válidos:

  • true: crea automáticamente instancias pay-as-you-go para cumplir con la cantidad requerida de instancias ECS si no es posible crear preemptible instances.
  • false: no crea instancias pay-as-you-go para cumplir con la cantidad requerida de instancias ECS si no es posible crear preemptible instances.

internet_charge_type

String

PayByBandwidth

Método de medición de la dirección IP pública. Valores válidos:

  • PayByBandwidth: pago por ancho de banda.
  • PayByTraffic: pago por transferencia de datos.

internet_max_bandwidth_out

Long

10

Ancho de banda saliente máximo de la dirección IP pública del nodo. Unidad: Mbit/s. Valores válidos: de 1 a 100.

image_type

String

AliyunLinux

Tipo de imagen del sistema operativo. Especifique este parámetro o el parámetro platform. Valores válidos:

  • AliyunLinux: Alinux2.
  • AliyunLinux3: Alinux3.
  • AliyunLinux3Arm64: Alinux3 ARM.
  • AliyunLinuxUEFI: Alinux2 UEFI.
  • CentOS: CentOS.
  • Windows: Windows.
  • WindowsCore: Windows Core.
  • ContainerOS: ContainerOS.

deploymentset_id

String

ds-bp1d19mmbsv3jf6xxxxx

ID del conjunto de despliegue al que pertenecen las instancias ECS del node pool.

desired_size

Long

2

Número esperado de nodos en el node pool.

private_pool_options

Object

Configuración del node pool privado.

id

String

eap-bp67acfmxazb4****

ID del node pool privado.

match_criteria

String

Open

Tipo de node pool privado. Este parámetro especifica el tipo de pool privado que desea usar para crear instancias. Un node pool privado se genera cuando entra en vigor una garantía de elasticidad o un servicio de reserva de capacidad. El sistema selecciona un node pool privado para lanzar instancias. Valores válidos:

  • Open: pool privado abierto. El sistema selecciona un node pool privado abierto para lanzar instancias. Si no hay disponible ningún node pool privado abierto coincidente, se usan los recursos del node pool público.

  • Target: pool privado específico. El sistema usa los recursos del node pool privado especificado para lanzar instancias. Si dicho node pool privado no está disponible, no será posible lanzar instancias.

  • None: no se usa ningún pool privado. Los recursos de los node pools privados no se emplean para lanzar las instancias.

tee_config

Object

Configuración de computación confidencial.

tee_enable

Boolean

false

Indica si se habilita la computación confidencial para el node pool.

management

Object

Configuración de la función de node pool administrado.

enable

Boolean

false

Indica si se habilita la función de node pool administrado. Valores válidos:

  • true: habilita la función de node pool administrado.
  • false: deshabilita la función de node pool administrado. Los demás parámetros de esta sección solo surten efecto cuando se especifica enable=true.

auto_repair

Boolean

false

Indica si se habilita la reparación automática. Este parámetro solo surte efecto cuando se especifica enable=true. Valores válidos:

  • true: habilita la reparación automática.
  • false: deshabilita la reparación automática.

upgrade_config

Object

Configuración de actualización automática. Esta configuración solo surte efecto cuando se especifica enable=true.

auto_upgrade

Boolean

false

Indica si se habilita la actualización automática. Valores válidos:

  • true: habilita la actualización automática.
  • false: deshabilita la actualización automática.

surge

Long

0

Número de nodos adicionales.

surge_percentage

Long

0

Porcentaje de nodos adicionales respecto a los nodos del node pool. Establezca este parámetro o surge.

max_unavailable

Long

0

Número máximo de nodos que pueden estar en estado Unavailable. Valores válidos: de 1 a 1000.

Valor predeterminado: 1.

count

Long

1

Este parámetro está obsoleto. Use el parámetro desired_size en su lugar.

Número de nodos en el node pool.

interconnect_mode

String

basic

Tipo de red del node pool perimetral. Este parámetro solo surte efecto cuando se establece el parámetro type del node pool en edge. Valores válidos:

  • basic: básico.
  • improved: mejorado.
  • private: dedicado. Solo Kubernetes 1.22 y versiones posteriores admiten este parámetro.

interconnect_config

Object

Este parámetro está obsoleto.

Configuración del node pool perimetral.

cen_id

String

cen-ey9k9nfhz0f***

Este parámetro está obsoleto.

ID de la instancia de Cloud Enterprise Network (CEN) asociada al node pool perimetral mejorado.

ccn_id

String

ccn-qm5i0i0q9yi***

Este parámetro está obsoleto.

ID de la instancia de Cloud Connect Network (CCN) asociada al node pool perimetral mejorado.

ccn_region_id

String

cn-shanghai

Este parámetro está obsoleto.

Región a la que pertenece la instancia CCN asociada al node pool perimetral mejorado.

bandwidth

Long

10

Este parámetro está obsoleto.

Ancho de banda del node pool perimetral mejorado. Unidad: Mbit/s.

improved_period

String

1

Este parámetro está obsoleto.

Duración de la suscripción del node pool perimetral mejorado. La duración se mide en meses.

max_nodes

Long

10

Número máximo de nodos que admite un node pool perimetral. El valor debe ser igual o mayor que 0. Un valor de 0 indica que la cantidad de nodos del node pool solo está limitada por la cuota de nodos del clúster. En la mayoría de los casos, este parámetro se establece en un valor mayor que 0 para los node pools perimetrales. Se establece en 0 para los node pools de tipo ess o para los node pools perimetrales predeterminados.

runtime

Configuración de los motores de contenedores.

Parámetro

Tipo

Ejemplo

Descripción

name

String

containerd

Nombre de un entorno de ejecución de contenedores. ACK admite los siguientes tipos de entornos de ejecución.

  • containerd: admite todas las versiones de Kubernetes. Se recomienda usar containerd.
  • Sandboxed-Container.runv: permite ejecutar aplicaciones en contenedores aislados, los cuales ofrecen mayor seguridad. Solo Kubernetes 1.24 y versiones anteriores admiten Sandboxed-Container.
  • docker: compatible con Kubernetes 1.22 y versiones anteriores.

Valor predeterminado: containerd.

version

String

1.6.20

Versión del entorno de ejecución de contenedores. De forma predeterminada, se usa la versión más reciente.

Para obtener más información sobre los cambios en Sandboxed-Container, consulte Notas de la versión de Sandboxed-Container.

tag

Configuración de las etiquetas.

Parámetro

Tipo

Ejemplo

Descripción

key

String

env

key de una etiqueta.

value

String

prod

value de una etiqueta.

taint

Configuración de los taints de los nodos.

Parámetro

Tipo

Ejemplo

Descripción

key

String

key

key de un taint.

value

String

value

value de un taint.

effect

String

NoSchedule

Política de programación. Valores válidos:

  • NoSchedule: los pods que no toleran este taint no se programan en nodos que lo tengan. Esta política afecta únicamente el proceso de programación y solo surte efecto en los pods pendientes de programar. Los pods ya programados no están sujetos a ella.

  • NoExecute: los pods que no toleran este taint se expulsan después de que el taint se agregue al nodo.

  • PreferNoSchedule: política de preferencia para los pods. Los pods ya programados no están sujetos a ella. Si se agrega este taint a un nodo, el sistema intenta no programar en él los pods que no lo toleran.

Valor predeterminado: NoSchedule.