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:
-
Inicie sesión en la consola de Container Service for Kubernetes (ACK) y seleccione Clústeres en el panel de navegación izquierdo.
-
En la página Clústeres, haga clic en Plantilla de clúster.
-
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.
-
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.
Pruébelo ahora
Test
Autorización de RAM
|
Action |
Nivel de acceso |
Tipo de recurso |
Clave de condición |
Acción dependiente |
|
cs:CreateCluster |
create |
*Cluster
|
|
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 Componente de red: Obligatorio. Hay dos tipos de red disponibles: Flannel y Terway. Seleccione uno al crear un clúster:
Componente de almacenamiento: Opcional. Solo se admite el tipo
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.
Componente de Ingress: Opcional. De forma predeterminada, el componente de Ingress
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 |
||
| 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 Para obtener más información sobre |
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 |
| sls_project_name |
string |
No |
El SLS Project que contiene el Logstore para los registros de auditoría del clúster.
|
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 |
auto_renew
deprecated
|
boolean |
No |
[Obsoleto] Especifica si se debe habilitar la renovación automática. Este parámetro solo surte efecto cuando
Valor predeterminado: 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 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:
Importante
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 |
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 Especifica si se debe instalar el agente de CloudMonitor en el clúster. Valores válidos:
Valor predeterminado: |
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
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 |
| 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
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.
Valor predeterminado: |
PostPaid |
| cloud_monitor_flags |
boolean |
No |
Especifica si se debe instalar CloudMonitor en los nodos.
Valor predeterminado: false. |
false |
| cpu_policy |
string |
No |
La política de administración de CPU de los nodos.
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 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 Valor válido: |
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.
Valor predeterminado: false. |
false |
| size |
integer |
No |
El número de nodos del plano de control. Valores válidos: |
3 |
| soc_enabled |
boolean |
No |
Especifica si se debe habilitar el endurecimiento de seguridad de MLPS.
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.
Este parámetro solo se admite cuando |
true |
| system_disk_category |
string |
No |
El tipo de disco en la nube del sistema de los nodos.
Valor predeterminado: |
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 |
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 |
| 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-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 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:
Valor predeterminado: |
none |
custom_san
deprecated
|
string |
No |
[Obsoleto] Utilice el parámetro 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:
Valor predeterminado: |
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:
Valor predeterminado: |
true |
enable_rrsa
deprecated
|
boolean |
No |
[Obsoleto] Utilice el parámetro Especifica si se debe habilitar la función RRSA.
|
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.
Valor predeterminado: |
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:
Valor predeterminado: Reglas de montaje de 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 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 El tipo de distribución del sistema operativo. Se recomienda usar este campo para especificar el sistema operativo del nodo. Valores válidos:
Valor predeterminado: |
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 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.
Valor predeterminado: |
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.
Valor predeterminado: |
true |
key_pair
deprecated
|
string |
No |
[Obsoleto] Para la configuración del plano de control del clúster, use el parámetro El nombre del par de claves. Es mutuamente excluyente con |
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:
Valor predeterminado: |
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 |
login_password
deprecated
|
string |
No |
[Obsoleto] Para la configuración del plano de control del clúster, use el parámetro La contraseña de inicio de sesión SSH. Es mutuamente excluyente con |
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 Especifica si se debe habilitar la renovación automática para los nodos maestros. Este parámetro solo surte efecto cuando
Valor predeterminado: |
true |
master_auto_renew_period
deprecated
|
integer |
No |
[Obsoleto] Para la configuración del plano de control del clúster, use el parámetro 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 El número de nodos maestros. Valores válidos: Valor predeterminado: |
3 |
master_instance_charge_type
deprecated
|
string |
No |
[Obsoleto] Para la configuración del plano de control del clúster, use el parámetro El método de facturación para los nodos maestros. Valores válidos:
Valor predeterminado: |
PrePaid |
master_instance_types
deprecated
|
array |
No |
[Obsoleto] Para la configuración del plano de control del clúster, use el parámetro 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 |
ecs.n4.xlarge |
|
master_period
deprecated
|
integer |
No |
[Obsoleto] Para la configuración del plano de control del clúster, use el parámetro La duración de la suscripción para los nodos maestros. Este parámetro surte efecto y es obligatorio solo cuando 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 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 Valores válidos: |
Month |
master_system_disk_category
deprecated
|
string |
No |
[Obsoleto] Para la configuración del plano de control del clúster, use el parámetro El tipo de disco en la nube del sistema para los nodos maestros. Valores válidos:
Valor predeterminado: |
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 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 El tamaño del disco en la nube del sistema para los nodos maestros. Valores válidos: [40, 500]. Unidad: GiB. Valor predeterminado: |
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 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 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 |
|
|
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 |
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 |
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: |
25 |
node_name_mode
deprecated
|
string |
No |
[Obsoleto] Para la configuración del pool de nodos, use el parámetro |
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 |
| 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:
|
stable |
| enabled |
boolean |
No |
Especifica si se debe habilitar la actualización automática del clúster.
|
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:
Valor predeterminado: |
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:
Valor predeterminado: |
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
|
Default |
| proxy_mode |
string |
No |
El modo de kube-proxy.
Valor predeterminado: |
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 |
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 |
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:
Valor predeterminado: |
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 Para obtener más información sobre |
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
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
Valor predeterminado: no habilitado. |
PrivateZone |
|
| snat_entry |
boolean |
No |
Configuración para habilitar SNAT en la VPC. Valores válidos:
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 |
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:
Valor predeterminado: |
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.
Valor predeterminado: |
true |
| tags |
array |
No |
Las etiquetas de los nodos. Reglas de definición de etiquetas:
|
|
| tag |
No |
Las etiquetas de los nodos. Reglas de definición de etiquetas:
|
||
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 |
| 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
Valor predeterminado: |
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:
Valor predeterminado: |
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:
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 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 Valores válidos: |
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:
Valor predeterminado: |
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:
|
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 |
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 |
|
|
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 |
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.