Tous les produits
Search

Ce produit

    Container Service for Kubernetes:CreateCluster

    Centre de documentation

    Container Service for Kubernetes:CreateCluster

    Dernière mise à jour :Sep 10, 2026

    Crée un cluster ACK, y compris des clusters ACK managés, des clusters ACK Serverless, des clusters ACK Edge et des clusters enregistrés. Lors de la création d'un cluster, vous configurez les informations du cluster, les composants du cluster et les ressources cloud associées à ACK.

    Description de l'opération

    Générer les paramètres de requête OpenAPI à l'aide de la console

    Lorsque vous appelez l'opération CreateCluster pour créer un cluster, si l'appel échoue en raison de combinaisons de paramètres de requête incorrectes, vous pouvez utiliser la console pour générer les combinaisons de paramètres de requête requises. Procédez comme suit :

    1. Connectez-vous à la console Container Service for Kubernetes (ACK) et choisissez Clusters dans le volet de navigation de gauche.

    2. Sur la page Clusters, cliquez sur Modèle de cluster.

    3. Dans la boîte de dialogue, sélectionnez le type de cluster que vous souhaitez créer, cliquez sur Créer, puis configurez les informations du cluster sur la page de configuration du cluster.

    4. Une fois la configuration terminée, sur la page Confirmer la configuration, cliquez sur Code équivalent dans le coin supérieur droit. La boîte de dialogue affiche les combinaisons de paramètres requises pour la création du cluster. Vous pouvez les copier et les utiliser.

    Important À partir du 4 juillet 2026, certains paramètres de requête ne seront plus pris en compte. Pour plus de détails sur les modifications et les descriptions des paramètres de remplacement, consultez Avis sur les modifications des paramètres de requête et de réponse OpenAPI pour la gestion des clusters ACK et la mise hors ligne d'OpenAPI.

    Testez maintenant

    Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

    Test

    Autorisation RAM

    Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

    • Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.

    • API : l'API que vous pouvez appeler pour exécuter l'action.

    • Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.

    • Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.

      • Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.

      • Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.

    • Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.

    • Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

    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
    		 Aucune

    Syntaxe de la requête

    POST /clusters HTTP/1.1

    Paramètres de requête

    Paramètre

    Type

    Requis

    Description

    Exemple
    body

    object

    Non

    Les paramètres du corps de la requête.

    cluster-demo
    access_control_list deprecated

    array

    Non

    [Obsolète] La liste de contrôle d'accès (ACL) de l'instance SLB pour le serveur d'API d'un cluster enregistré.

    string

    Non

    La liste de contrôle d'accès (ACL) de l'instance SLB pour le serveur d'API d'un cluster enregistré.

    192.168.XX.XX/24

    addons

    array

    Non

    La liste des composants du cluster. Lorsque vous créez un cluster, utilisez addons pour spécifier les composants que vous souhaitez installer.

    Composant réseau : Obligatoire. Deux types de réseau sont disponibles : Flannel et Terway. Sélectionnez-en un lors de la création du cluster :

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

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

    Composant de stockage : Facultatif. Seul le type csi est pris en charge :

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

    Composant de journalisation : Facultatif. Nous vous recommandons d'activer ce composant. Si vous n'activez pas le service de journalisation, vous ne pourrez pas utiliser la fonction d'audit de cluster.

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

    • Créer un nouveau SLS Project : [{"name": "loongcollector","config": "{"IngressDashboardEnabled":"true"}"}].

    Composant Ingress : Facultatif. Par défaut, le composant Ingress nginx-ingress-controller est installé pour les clusters dédiés ACK.

    • Installer Ingress et activer l'accès Internet : [{"name":"nginx-ingress-controller","config":"{"IngressSlbNetworkType":"internet"}"}].

    • Ne pas installer Ingress par défaut : [{"name": "nginx-ingress-controller","config": "","disabled": true}].

    Centre d'événements : Facultatif. Activé par défaut.

    Le Centre d'événements offre des capacités de stockage, de requête et d'alerte sur les événements Kubernetes. Le Logstore associé au Centre d'événements Kubernetes est gratuit pendant 90 jours. Pour plus d'informations sur la politique de gratuité, consultez Créer et utiliser le Centre d'événements Kubernetes.

    Exemple d'activation du Centre d'événements : [{"name":"ack-node-problem-detector","config":"{"sls_project_name":"your_sls_project_name"}"}].

    addon

    Non

    La liste des composants du cluster. Lorsque vous créez un cluster, utilisez addons pour spécifier les composants que vous souhaitez installer.

    api_audiences

    string

    Non

    Un ServiceAccount est l'identifiant d'accès utilisé par un pod pour communiquer avec le serveur d'API du cluster. Le paramètre api-audiences spécifie les identités de token de requête valides utilisées par l'apiserver pour authentifier la validité des tokens de requête. Vous pouvez configurer plusieurs audiences séparées par des virgules (,).

    Pour plus d'informations sur ServiceAccount, consultez Déployer la projection de volume de jeton de compte de service.

    kubernetes.default.svc
    audit_log_config

    object

    Non

    La configuration du journal d'audit du cluster.

    enabled

    boolean

    Non

    Indique si la fonction de journal d'audit du cluster doit être activée. Valeurs valides :

    • true : Active la fonction.

    • false : Désactive la fonction.

    true
    sls_project_name

    string

    Non

    Le SLS Project qui contient le Logstore pour les journaux d'audit du cluster.

    • Valeur par défaut : k8s-log-{clusterid}.

    • Une fois la fonction de journal d'audit du cluster activée, un Logstore pour les journaux d'audit du cluster est créé dans le SLS Project spécifié.

    k8s-log-c2345xxxxxxxxxxxx
    auto_mode

    object

    Non

    La configuration du mode managé intelligent.

    enable

    boolean

    Non

    Indique si le mode managé intelligent doit être activé. Valeurs valides :

    • true : Active le mode.

    • false : Désactive le mode.

    true
    auto_renew deprecated

    boolean

    Non

    [Obsolète]

    Indique si le renouvellement automatique doit être activé. Ce paramètre prend effet uniquement lorsque charge_type est défini sur PrePaid. Valeurs valides :

    • true : Active le renouvellement automatique.

    • false : Désactive le renouvellement automatique.

    Valeur par défaut : false.

    Ce paramètre a été modifié le 15 octobre 2024. Pour plus d'informations, consultez Avis sur les changements de comportement du paramètre CreateCluster.

    true
    auto_renew_period deprecated

    integer

    Non

    [Obsolète]

    La période de renouvellement automatique. Ce paramètre prend effet uniquement lorsque le mode de facturation est prépayé et que le renouvellement automatique est activé. Lorsque PeriodUnit=Month, valeurs valides : {1, 2, 3, 6, 12}.

    Valeur par défaut : 1.

    Ce paramètre a été modifié le 15 octobre 2024. Pour plus d'informations, consultez Avis sur les changements de comportement du paramètre CreateCluster.

    1
    charge_type deprecated

    string

    Non

    [Obsolète]

    Le mode de facturation de l'instance CLB utilisée par le serveur d'API. Valeur par défaut : PostPaid. Valeurs valides :

    • PostPaid : paiement à l'usage.

    • PrePaid : abonnement. Le mode de facturation par abonnement n'est plus pris en charge pour les instances CLB nouvellement créées. Les instances existantes ne sont pas affectées.

    Important

    Pour plus d'informations, consultez Avis sur les changements de facturation pour Classic Load Balancer (CLB).

    PostPaid
    cis_enabled deprecated

    boolean

    Non

    [Obsolète] Pour la configuration du plan de contrôle du cluster, utilisez plutôt le paramètre security_hardening_os sous control_plane_config. Pour la configuration du pool de nœuds, utilisez plutôt le paramètre security_hardening_os sous scaling_group dans nodepool.

    false
    client_token

    string

    Non

    Le jeton client.

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

    boolean

    Non

    [Obsolète] Pour la configuration des nœuds du plan de contrôle du cluster, utilisez plutôt le paramètre cloud_monitor_flags sous control_plane_config. Pour la configuration du pool de nœuds, utilisez plutôt le paramètre cms_enabled sous kubernetes_config dans nodepool.

    Indique si l'agent CloudMonitor doit être installé sur le cluster. Valeurs valides :

    • true : Installe l'agent CloudMonitor.

    • false : N'installe pas l'agent CloudMonitor.

    Valeur par défaut : false.

    false
    cluster_domain

    string

    Non

    Le nom de domaine local du cluster.

    Règles de nommage : un nom de domaine se compose d'une ou plusieurs parties séparées par des points (.). Chaque partie peut comporter jusqu'à 63 caractères et peut contenir des lettres minuscules, des chiffres et des traits d'union (-). Chaque partie doit commencer et se terminer par une lettre minuscule ou un chiffre.

    cluster.local
    cluster_spec

    string

    Non

    Après avoir défini cluster_type sur ManagedKubernetes et configuré profile, vous pouvez spécifier davantage la spécification du cluster. Valeurs valides :

    • ack.standard : Édition Basic (sélectionnée par défaut si la valeur est vide)

    • ack.pro.small : Édition Pro

    • ack.pro.xlarge : Pro XL

    • ack.pro.2xlarge : Pro 2XL

    • ack.pro.4xlarge : Pro 4XL (nécessite de contacter le service client pour activer la liste blanche)

    Pro XL, Pro 2XL et Pro 4XL sont trois niveaux fournis par Plan de contrôle provisionné ACK Pro. En préallouant et en dédiant les ressources du plan de contrôle, ces niveaux garantissent que la concurrence de l'API et les capacités de planification des pods restent à un niveau constamment élevé. Ils conviennent à l'entraînement et à l'inférence de l'IA, aux clusters à très grande échelle et aux charges de travail critiques.

    Pour plus d'informations sur les frais de gestion de cluster pour les éditions Pro et les éditions Plan de contrôle provisionné, consultez Frais de gestion de cluster.

    ack.pro.small
    cluster_type

    string

    Non

    Valeurs valides :

    • Kubernetes : Cluster dédié ACK.

    • ManagedKubernetes : Types de clusters managés ACK, y compris les clusters managés ACK (éditions Pro et Basic), les clusters ACK Serverless (éditions Pro et Basic), les clusters ACK Edge (éditions Pro et Basic) et les clusters ACK Lingjun (édition Pro).

    • ExternalKubernetes : Cluster enregistré.

    Kubernetes
    container_cidr

    string

    Non

    Le bloc CIDR pour les pods. Il doit s'agir d'un bloc CIDR privé valide, plus précisément les blocs CIDR suivants et leurs sous-réseaux : 10.0.0.0/8, 172.16-31.0.0/12-16 et 192.168.0.0/16. Le bloc CIDR ne peut pas chevaucher le bloc CIDR du VPC ou les blocs CIDR utilisés par les clusters Kubernetes existants dans le VPC. Vous ne pouvez pas modifier ce bloc CIDR après la création du cluster.

    Pour plus d'informations sur la planification du réseau de cluster, consultez Planifier le réseau d'un cluster managé ACK.

    Remarque

    Ce paramètre est requis pour les clusters Flannel.

    172.20.0.0/16
    control_plane_config

    object

    Non

    La configuration du plan de contrôle pour les clusters dédiés ACK.

    auto_renew

    boolean

    Non

    Indique si le renouvellement automatique doit être activé pour les nœuds du plan de contrôle. Ce paramètre prend effet uniquement lorsque le mode de facturation est défini sur PrePaid. Valeurs valides :\n- true : active le renouvellement automatique.\n- false : désactive le renouvellement automatique.\n\nValeur par défaut : true.

    true
    auto_renew_period

    integer

    Non

    La période de renouvellement automatique pour les nœuds du plan de contrôle.\n\nValeurs valides : {1, 2, 3, 6, 12}. Unité : mois.\n\nValeur par défaut : 1.

    1
    charge_type

    string

    Non

    Le mode de facturation des nœuds du plan de contrôle.

    • PrePaid : abonnement.

    • PostPaid : paiement à l'usage.

    Valeur par défaut : PostPaid.

    PostPaid
    cloud_monitor_flags

    boolean

    Non

    Indique si CloudMonitor doit être installé sur les nœuds.

    • true : installe l'agent CloudMonitor.

    • false : n'installe pas l'agent CloudMonitor.

    Valeur par défaut : false.

    false
    cpu_policy

    string

    Non

    La stratégie de gestion des processeurs des nœuds.

    • static : permet d'accorder une affinité et une exclusivité de processeur améliorées aux pods présentant certaines caractéristiques de ressources sur le nœud.

    • none : utilise le schéma d'affinité de processeur par défaut existant.

    Valeur par défaut : none.

    none
    deploymentset_id

    string

    Non

    L'identifiant de l'ensemble de déploiement.

    ds-bp10b35imuam5amw****
    image_id

    string

    Non

    L'identifiant de l'image.

    aliyun_3_x64_20G_alibase_20240819.vhd
    image_type

    string

    Non

    Le type d'image du système d'exploitation.

    AliyunLinux3
    instance_metadata_options InstanceMetadataOptions

    Non

    La configuration de l'accès aux métadonnées des instances ECS.

    instance_types

    array

    Non

    Les types d'instances des nœuds.

    string

    Non

    Le type d'instance du nœud.

    ecs.g6.large
    key_pair

    string

    Non

    Le nom de la paire de clés. Vous devez définir soit key_pair, soit login_password.

    ack
    login_password

    string

    Non

    Le mot de passe de connexion SSH. Le mot de passe doit comporter entre 8 et 30 caractères et contenir au moins trois des types de caractères suivants : lettres majuscules, lettres minuscules, chiffres et caractères spéciaux. Vous devez définir soit login_password, soit key_pair.

    ********
    node_port_range

    string

    Non

    [Obsolète] La plage de ports de service des nœuds.

    30000-32767

    period

    integer

    Non

    La durée d'abonnement pour les nœuds du plan de contrôle. Ce paramètre est requis et prend effet uniquement lorsque le mode de facturation est défini sur PrePaid.\n\nValeurs valides : {1, 2, 3, 6, 12, 24, 36, 48, 60}. Unité : mois.\n\nValeur par défaut : 1.

    1
    period_unit

    string

    Non

    L'unité de durée d'abonnement pour les nœuds du plan de contrôle. Ce paramètre est requis et prend effet uniquement lorsque le mode de facturation est défini sur PrePaid.\n\nValeur valide : Month. Actuellement, seuls les cycles de facturation mensuels sont pris en charge.

    Month
    runtime

    string

    Non

    [Deprecated] Le nom de l'environnement d'exécution pour les nœuds du plan de contrôle. Valeurs valides :\n\ncontainerd : l'environnement d'exécution Containerd, qui est pris en charge par toutes les versions de cluster.

    containerd
    security_hardening_os

    boolean

    Non

    Indique si le durcissement de sécurité d'Alibaba Cloud OS doit être activé.

    • true : active le durcissement de sécurité d'Alibaba Cloud OS.

    • false : désactive le durcissement de sécurité d'Alibaba Cloud OS.

    Valeur par défaut : false.

    false
    size

    integer

    Non

    Le nombre de nœuds du plan de contrôle.\n\nValeurs valides : 3 ou 5.

    3
    soc_enabled

    boolean

    Non

    Indique si le durcissement de sécurité MLPS doit être activé.

    • true : active le durcissement de sécurité MLPS 2.0.

    • false : désactive le durcissement de sécurité MLPS 2.0.

    Valeur par défaut : false.

    false
    system_disk_bursting_enabled

    boolean

    Non

    Indique si les performances en mode burst doivent être activées pour les disques cloud système des nœuds.

    • true : Activé.

    • false : Désactivé.

    Ce paramètre est pris en charge uniquement lorsque system_disk_category est défini sur cloud_auto.

    true
    system_disk_category

    string

    Non

    Le type de disque cloud système du nœud.

    • cloud_efficiency : disque cloud ultra.

    • cloud_ssd : SSD standard.

    • cloud_essd : ESSD.

    • cloud_auto : disque cloud ESSD AutoPL.

    • cloud_essd_entry : disque cloud ESSD Entry.

    Valeur par défaut : cloud_ssd. La valeur par défaut peut varier selon la zone.

    cloud_ssd
    system_disk_performance_level

    string

    Non

    Le niveau de performance du disque cloud système des nœuds. Ce paramètre prend effet uniquement pour les disques cloud ESSD.\n\nLe niveau de performance varie en fonction de la taille du disque cloud. Pour plus d'informations, consultez Disques cloud ESSD.

    PL1
    system_disk_provisioned_iops

    integer

    Non

    Les IOPS de lecture/écriture provisionnés pour les disques cloud système des nœuds.\n\nValeurs valides : 0 à min{50 000, 1 000 × capacité - performances de base}. Performances de base = min{1 800 + 50 × capacité, 50 000}.\n\nCe paramètre est pris en charge uniquement lorsque system_disk_category est défini sur cloud_auto.

    1000
    system_disk_size

    integer

    Non

    La taille du disque cloud système des nœuds.\n\nValeurs valides : [40, 500]. Unité : GiB.\n\nValeur par défaut : 120.

    120
    system_disk_snapshot_policy_id

    string

    Non

    La stratégie d'instantané automatique pour les disques cloud système des nœuds.

    sp-2zej1nogjvovnz4z****
    control_plane_endpoints_config

    object

    Non

    La configuration du point de terminaison du cluster.

    internal_dns_config

    object

    Non

    La configuration DNS interne pour le cluster. Ce paramètre s'applique aux clusters managés ACK. Le nom de domaine interne est utilisé par les composants système côté nœud tels que kubelet et kube-proxy pour accéder au serveur API. Si l'accès par nom de domaine interne n'est pas activé, les composants système côté nœud accèdent au serveur API via l'adresse IP du CLB.

    bind_vpcs

    array

    Non

    Les VPC dans lesquels les enregistrements DNS internes du cluster prennent effet.

    string

    Non

    Les VPC dans lesquels les enregistrements DNS internes du cluster prennent effet.

    vpc-xxxx
    load_balancers_config

    array<object>

    Non

    La configuration du point de terminaison du cluster. Lorsque ce paramètre est spécifié, les paramètres endpoint_public_access et load_balancer_id ne prennent pas effet. ACK prend uniquement en charge la création automatique d'instances NLB. Pour spécifier une instance CLB ou NLB, utilisez load_balancers_config pour spécifier l'identifiant d'instance correspondant.

    object

    Non

    La configuration de l'équilibrage de charge pour l'accès au cluster.

    endpoint_type

    string

    Non

    Le type de point de terminaison.

    private
    load_balancer_id

    string

    Non

    L'identifiant de l'instance NLB.

    nlb-0ogk9aaxxxxxxx
    controlplane_log_components

    array

    Non

    La liste des noms de composants qui spécifie les composants du plan de contrôle pour lesquels collecter les journaux.\n\nPar défaut, les journaux sont collectés à partir de kube-apiserver, kube-controller-manager, kube-scheduler et cloud-controller-manager.

    string

    Non

    La liste des noms de composants qui spécifie les composants du plan de contrôle pour lesquels collecter les journaux.\n\nPar défaut, les journaux sont collectés à partir de kube-apiserver, kube-controller-manager, kube-scheduler et cloud-controller-manager.

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

    string

    Non

    Le projet Simple Log Service pour les journaux des composants du plan de contrôle. Vous pouvez utiliser un projet existant pour le stockage des journaux, ou le système crée automatiquement un projet. Si vous choisissez la création automatique, un projet Simple Log Service nommé k8s-log-{ClusterID} est créé.

    k8s-log-xxx
    controlplane_log_ttl

    string

    Non

    La période de rétention des journaux des composants du plan de contrôle, en jours.

    30
    cpu_policy deprecated

    string

    Non

    [Obsolète] Utilisez le paramètre cpu_policy sous control_plane_config pour la configuration du plan de contrôle du cluster, ou utilisez le paramètre cpu_policy sous kubernetes_config dans nodepool pour la configuration du pool de nœuds.

    La stratégie de gestion des processeurs des nœuds. Les stratégies suivantes sont prises en charge pour les clusters de version 1.12.6 ou ultérieure :

    • static : permet aux pods présentant certaines caractéristiques de ressources sur le nœud de bénéficier d'une affinité et d'une exclusivité de processeur améliorées.

    • none : utilise le schéma d'affinité de processeur par défaut existant.

    Valeur par défaut : none.

    none
    custom_san deprecated

    string

    Non

    [Deprecated] Utilisez plutôt le paramètre extra_sans.\n\nLe nom alternatif du sujet (SAN) du certificat personnalisé. Séparez les adresses IP ou les noms de domaine multiples par des virgules (,).

    cs.aliyun.com
    deletion_protection

    boolean

    Non

    Indique si la protection contre la suppression du cluster doit être activée, ce qui empêche la suppression accidentelle du cluster dans la console ou via des appels d'opérations d'API. Valeurs valides :

    • true : active la protection contre la suppression du cluster. Le cluster ne peut pas être supprimé dans la console ou via des appels d'opérations d'API.

    • false : désactive la protection contre la suppression du cluster. Le cluster peut être supprimé dans la console ou via des appels d'opérations d'API.

    Valeur par défaut : false.

    true
    disable_rollback deprecated

    boolean

    Non

    [Obsolète] Lorsque la création du cluster échoue, aucune restauration n'est effectuée par défaut. Vous devez nettoyer manuellement le cluster en échec.

    Indique si le cluster doit être restauré en cas d'échec de sa création. Valeurs valides :

    • true : restaure le cluster en cas d'échec de sa création.

    • false : ne restaure pas le cluster en cas d'échec de sa création.

    Valeur par défaut : true.

    true
    enable_rrsa deprecated

    boolean

    Non

    [Obsolète] Utilisez plutôt le paramètre rrsa_config.

    Indique si la fonctionnalité RRSA doit être activée.

    • true : active la fonctionnalité.

    • false : n'active pas la fonctionnalité.

    false
    encryption_provider_key

    string

    Non

    L'identifiant de la clé Key Management Service (KMS) utilisée pour chiffrer les disques cloud. Pour plus d'informations, consultez Key Management Service.

    Remarque

    Cette fonctionnalité prend effet uniquement dans les clusters ACK Pro.

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

    boolean

    Non

    Indique si l'accès au réseau public doit être activé. Une adresse IP élastique (EIP) est utilisée pour exposer le serveur d'API afin de permettre l'accès au cluster via le réseau public.

    • true : active l'accès au réseau public.

    • false : désactive l'accès au réseau public. Si vous sélectionnez cette option, le serveur d'API du cluster ne peut pas être accessible via Internet.

    Valeur par défaut : false.

    true
    extra_sans

    array

    Non

    Le Subject Alternative Name (SAN) personnalisé pour le certificat du serveur d'API.

    string

    Non

    Le SAN du certificat. Prend en charge les adresses IP ou les noms de domaine personnalisés.

    192.168.xx.xx
    format_disk deprecated

    boolean

    Non

    [Obsolète] La sélection de nœuds existants lors de la création d'un cluster n'est pas prise en charge. Pour ajouter des nœuds existants à un cluster, créez d'abord un pool de nœuds et appelez l'opération AttachInstancesToNodePool.

    Indique si des disques de données doivent être montés sur des instances existantes lors de la création d'un cluster avec des instances existantes. Valeurs valides :

    • true : stocke les conteneurs et les images sur les disques de données. Les données existantes sur les disques de données seront perdues. Sauvegardez vos données à l'avance.

    • false : ne stocke pas les conteneurs et les images sur les disques de données.

    Valeur par défaut : false.

    Règles de montage des disques de données :

    • Si l'instance ECS dispose de disques de données attachés et que le système de fichiers du dernier disque de données n'est pas initialisé, le système formate automatiquement le disque de données en ext4 pour stocker /var/lib/docker et /var/lib/kubelet.

    • Si l'instance ECS n'a pas de disques de données attachés, aucun nouveau disque de données n'est monté.

    false
    image_id deprecated

    string

    Non

    [Obsolète] Pour la configuration du plan de contrôle du cluster, utilisez plutôt le paramètre image_id sous control_plane_config. Pour la configuration du pool de nœuds, utilisez plutôt le paramètre image_id sous scaling_group dans nodepool.

    L'image personnalisée pour les nœuds. L'image système est utilisée par défaut. Lorsqu'une image personnalisée est sélectionnée, elle remplace l'image système par défaut. Pour plus d'informations, consultez Images personnalisées.

    m-bp16z7xko3vvv8gt****
    image_type deprecated

    string

    Non

    [Obsolète] Pour la configuration du plan de contrôle du cluster, utilisez plutôt le paramètre image_type sous control_plane_config. Pour la configuration du pool de nœuds, utilisez plutôt le paramètre image_type sous scaling_group dans nodepool.

    Le type de distribution du système d'exploitation. Nous vous recommandons d'utiliser ce champ pour spécifier le système d'exploitation du nœud. Valeurs valides :

    • CentOS

    • AliyunLinux

    • AliyunLinux Qboot

    • AliyunLinuxUEFI

    • AliyunLinux3

    • Windows

    • WindowsCore

    • AliyunLinux3Arm64

    • ContainerOS

    Valeur par défaut : CentOS.

    AliyunLinux
    instances deprecated

    array

    Non

    [Obsolète] La sélection de nœuds existants lors de la création d'un cluster n'est pas prise en charge. Pour ajouter des nœuds existants à un cluster, créez d'abord un pool de nœuds et appelez l'opération AttachInstancesToNodePool.

    La liste des instances ECS à utiliser lors de la création d'un cluster avec des nœuds existants. Ces instances sont ajoutées au cluster en tant que nœuds de travail.

    Remarque

    Ce champ est requis lorsque vous créez un cluster en utilisant des instances existantes.

    string

    Non

    La liste des instances ECS à utiliser lors de la création d'un cluster avec des nœuds existants. Ces instances sont ajoutées au cluster en tant que nœuds de travail.

    Remarque

    Ce champ est requis lorsque vous créez un cluster en utilisant des instances existantes.

    i-2ze4zxnm36vq00xn****
    ip_stack

    string

    Non

    La pile de protocoles IP du cluster.

    Valeurs valides : ipv4 (pile unique) dual (double pile). Valeur par défaut : ipv4
    is_enterprise_security_group

    boolean

    Non

    Indique si la création automatique d'un groupe de sécurité avancé doit être activée. Ce paramètre prend effet lorsque security_group_id est vide.

    Remarque

    Lorsqu'un groupe de sécurité de base est utilisé, le nombre total de nœuds et de pods Terway dans le cluster ne peut pas dépasser 2000. Par conséquent, lors de la création d'un cluster de type réseau Terway, utilisez un groupe de sécurité avancé.

    • true : crée et utilise un groupe de sécurité avancé.

    • false : utilise un groupe de sécurité de base.

    Valeur par défaut : true.

    true
    keep_instance_name deprecated

    boolean

    Non

    [Obsolète] La sélection de nœuds existants lors de la création d'un cluster n'est pas prise en charge. Pour ajouter des nœuds existants à un cluster, créez d'abord un pool de nœuds et appelez l'opération AttachInstancesToNodePool.

    Indique si les noms d'instance doivent être conservés lors de la création d'un cluster avec des instances existantes.

    • true : conserve les noms d'instance.

    • false : ne conserve pas les noms d'instance. Les noms sont remplacés par des noms générés par le système.

    Valeur par défaut : true.

    true
    key_pair deprecated

    string

    Non

    [Obsolète] Pour la configuration du plan de contrôle du cluster, utilisez plutôt le paramètre key_pair sous control_plane_config. Pour la configuration du pool de nœuds, utilisez plutôt le paramètre key_pair sous scaling_group dans nodepool.

    Le nom de la paire de clés. Mutuellement exclusif avec login_password.

    security-key
    kubernetes_version

    string

    Non

    La version du cluster, qui est cohérente avec la version de référence de la communauté Kubernetes. Utilisez la version la plus récente. Si vous ne spécifiez pas ce paramètre, la version la plus récente est utilisée par défaut.

    Vous pouvez créer des clusters des trois versions les plus récentes. Appelez l'opération DescribeKubernetesVersionMetadata pour interroger les versions de cluster prises en charge.

    Pour plus d'informations sur les versions de Kubernetes prises en charge par ACK, consultez Présentation des versions de Kubernetes.

    1.32.1-aliyun.1
    load_balancer_id

    string

    Non

    L'identifiant de l'instance du Classic Load Balancer (CLB) utilisé pour l'accès au serveur d'API. Si ce paramètre est spécifié, la création automatique d'un CLB pour le serveur d'API est ignorée.

    Remarque

    Assurez-vous que l'instance CLB n'a pas d'autres dépendances (telles que des écouteurs ou des serveurs backend). Les instances CLB partagées et orientées Internet ne sont pas prises en charge.

    lb-wz9t256gqa3vbouk****
    load_balancer_spec deprecated

    string

    Non

    [Obsolète] Le CLB utilise la facturation à l'usage. Ce paramètre ne prend pas effet.

    La spécification de l'équilibrage de charge. Valeurs valides :

    • slb.s1.small

    • slb.s2.small

    • slb.s2.medium

    • slb.s3.small

    • slb.s3.medium

    • slb.s3.large

    Valeur par défaut : slb.s2.small.

    slb.s2.small
    logging_type deprecated

    string

    Non

    [Obsolète] Active le service de journalisation pour le cluster. Ce paramètre prend effet uniquement pour les clusters ACK Serverless, et la valeur doit être SLS.

    SLS
    login_password deprecated

    string

    Non

    [Obsolète] Pour la configuration du plan de contrôle du cluster, utilisez plutôt le paramètre login_password sous control_plane_config. Pour la configuration du pool de nœuds, utilisez plutôt le paramètre login_password sous scaling_group dans nodepool.

    Le mot de passe de connexion SSH. Mutuellement exclusif avec key_pair. Le mot de passe doit comporter de 8 à 30 caractères et contenir au moins trois des types de caractères suivants : lettres majuscules, lettres minuscules, chiffres et caractères spéciaux.

    null
    maintenance_window maintenance_window

    Non

    La fenêtre d'exploitation et de maintenance du cluster.

    master_auto_renew deprecated

    boolean

    Non

    [Obsolète] Pour la configuration du plan de contrôle du cluster, utilisez plutôt le paramètre auto_renew sous control_plane_config.

    Indique si le renouvellement automatique doit être activé pour les nœuds maîtres. Ce paramètre prend effet uniquement lorsque master_instance_charge_type est défini sur PrePaid. Valeurs valides :

    • true : active le renouvellement automatique.

    • false : désactive le renouvellement automatique.

    Valeur par défaut : true.

    true
    master_auto_renew_period deprecated

    integer

    Non

    [Obsolète] Pour la configuration du plan de contrôle du cluster, utilisez plutôt le paramètre auto_renew_period sous control_plane_config.

    La période de renouvellement automatique pour les nœuds maîtres. Ce paramètre prend effet et est requis uniquement lorsque la méthode de facturation par abonnement est sélectionnée.

    Valeurs valides : {1, 2, 3, 6, 12}.

    Valeur par défaut : 1.

    1
    master_count deprecated

    integer

    Non

    [Obsolète] Pour la configuration du plan de contrôle du cluster, utilisez plutôt le paramètre size sous control_plane_config.

    Le nombre de nœuds maîtres. Valeurs valides : 3 ou 5.

    Valeur par défaut : 3.

    3
    master_instance_charge_type deprecated

    string

    Non

    [Obsolète] Pour la configuration du plan de contrôle du cluster, utilisez plutôt le paramètre instance_charge_type sous control_plane_config.

    La méthode de facturation pour les nœuds maîtres. Valeurs valides :

    • PrePaid : abonnement.

    • PostPaid : paiement à l'usage.

    Valeur par défaut : PostPaid.

    PrePaid
    master_instance_types deprecated

    array

    Non

    [Obsolète] Pour la configuration du plan de contrôle du cluster, utilisez plutôt le paramètre instance_types sous control_plane_config.

    Les types d'instances pour les nœuds maîtres. Pour plus d'informations, consultez Familles d'instances.

    string

    Non

    Le type d'instance pour un nœud maître. Le nombre de types d'instances spécifiés doit correspondre à la valeur de master_count et correspondre un à un avec les éléments de master_instance_types. Pour plus d'informations, consultez Familles d'instances.

    ecs.n4.xlarge
    master_period deprecated

    integer

    Non

    [Obsolète] Pour la configuration du plan de contrôle du cluster, utilisez plutôt le paramètre unit sous control_plane_config.

    La durée d'abonnement pour les nœuds maîtres. Ce paramètre prend effet et est requis uniquement lorsque master_instance_charge_type est défini sur PrePaid.

    Valeurs valides : {1, 2, 3, 6, 12, 24, 36, 48, 60}.

    Valeur par défaut : 1.

    1
    master_period_unit deprecated

    string

    Non

    [Obsolète] Pour la configuration du plan de contrôle du cluster, utilisez plutôt le paramètre period_unit sous control_plane_config.

    L'unité de période d'abonnement pour les nœuds maîtres. Ce paramètre est requis lorsque la méthode de facturation est PrePaid.

    Valeurs valides : Month. Actuellement, seule la facturation mensuelle est prise en charge.

    Month
    master_system_disk_category deprecated

    string

    Non

    [Obsolète] Pour la configuration du plan de contrôle du cluster, utilisez plutôt le paramètre system_disk_category sous control_plane_config.

    Le type de disque cloud système pour les nœuds maîtres. Valeurs valides :

    • cloud_efficiency : disque cloud Ultra.

    • cloud_ssd : SSD standard.

    • cloud_essd : SSD Enterprise (ESSD).

    Valeur par défaut : cloud_ssd. La valeur par défaut peut varier selon la zone.

    cloud_ssd
    master_system_disk_performance_level deprecated

    string

    Non

    [Obsolète] Pour la configuration du plan de contrôle du cluster, utilisez plutôt le paramètre system_disk_performance_level sous control_plane_config.

    Le niveau de performance (PL) du disque cloud système pour les nœuds maîtres. Ce paramètre prend effet uniquement pour les disques cloud ESSD. Le niveau de performance est lié à la taille du disque. Pour plus d'informations, consultez Disques cloud ESSD.

    PL1
    master_system_disk_size deprecated

    integer

    Non

    [Obsolète] Pour la configuration du plan de contrôle du cluster, utilisez plutôt le paramètre system_disk_size sous control_plane_config.

    La taille du disque cloud système pour les nœuds maîtres. Valeurs valides : [40, 500]. Unité : GiB.

    Valeur par défaut : 120.

    120
    master_system_disk_snapshot_policy_id deprecated

    string

    Non

    [Obsolète] Pour la configuration du plan de contrôle du cluster, utilisez plutôt le paramètre system_disk_snapshot_policy_id sous control_plane_config.

    L'identifiant de la stratégie d'instantané automatique pour les disques cloud système des nœuds maîtres.

    sp-2zej1nogjvovnz4z****
    master_vswitch_ids deprecated

    array

    Non

    [Obsolète] Utilisez plutôt le paramètre vswitch_ids.

    La liste des identifiants de vSwitch pour les nœuds maîtres. Le nombre de vSwitches doit être compris dans la plage [1, 3]. Pour garantir une haute disponibilité, sélectionnez trois vSwitches répartis dans différentes zones.

    Le nombre de types d'instances spécifiés doit correspondre à la valeur de master_count et correspondre un à un avec les éléments de master_vswitch_ids.

    string

    Non

    La liste des identifiants de vSwitch pour les nœuds maîtres. Le nombre de vSwitches doit être compris dans la plage [1, 3]. Pour garantir une haute disponibilité, sélectionnez trois vSwitches répartis dans différentes zones.

    Le nombre de types d'instances spécifiés doit correspondre à la valeur de master_count et correspondre un à un avec les éléments de master_vswitch_ids.

    vsw-2ze3ds0mdip0hdz8i****
    name

    string

    Oui

    Le nom personnalisé du cluster. Le nom peut contenir des chiffres, des caractères chinois, des lettres et des traits d'union (-). Il doit comporter de 1 à 63 caractères et ne peut pas commencer par un trait d'union (-).

    cluster-demo
    nat_gateway deprecated

    boolean

    Non

    [Obsolète] Utilisez plutôt le paramètre snat_entry.

    true
    node_cidr_mask

    string

    Non

    Le nombre d'adresses IP par nœud, déterminé en spécifiant le bloc CIDR du réseau. Ce paramètre prend effet uniquement pour les clusters de type réseau Flannel.

    Valeur par défaut : 26.

    25
    node_name_mode deprecated

    string

    Non

    [Obsolète] Pour la configuration du pool de nœuds, utilisez plutôt le paramètre node_name_mode sous kubernetes_config dans nodepool.

    null
    node_port_range deprecated

    string

    Non

    La plage de ports de service du nœud. Plage de ports valide : [30000, 65535].

    Valeur par défaut : 30000-32767.

    30000~32767

    nodepools

    array

    Non

    La liste des pools de nœuds.

    nodepool

    Non

    La configuration du pool de nœuds.

    num_of_nodes deprecated

    integer

    Non

    [Deprecated] Utilisez plutôt le paramètre desired_size sous scaling_group dans nodepool.

    Le nombre de nœuds workers. Valeurs valides : 0 à 100.

    3
    operation_policy

    object

    Non

    La stratégie d'exploitation et de maintenance automatiques du cluster.

    cluster_auto_upgrade

    object

    Non

    La configuration de mise à niveau automatique du cluster.

    channel

    string

    Non

    La fréquence de mise à niveau automatique du cluster. Valeurs valides :

    • patch : met automatiquement à niveau vers la dernière version de correctif disponible dans la version mineure actuelle. La nouvelle version de Kubernetes ne contient pas de modifications avec rupture de compatibilité.

    • stable : met automatiquement à niveau vers la dernière version de correctif de l'avant-dernière version mineure. La nouvelle version de Kubernetes peut impliquer des modifications d'API et de fonctionnalités, mais sa stabilité a été largement validée.

    • rapid : met automatiquement à niveau vers la dernière version de correctif de la dernière version mineure, permettant un accès plus rapide aux nouvelles fonctionnalités de la communauté Kubernetes.

    stable
    enabled

    boolean

    Non

    Indique si la mise à niveau automatique du cluster doit être activée.

    • true : activée.

    • false : non activée.

    true
    os_type deprecated

    string

    Non

    [Deprecated] Pour la configuration des nœuds du plan de contrôle du cluster, utilisez plutôt le paramètre image_type sous control_plane_config. Pour la configuration du pool de nœuds, utilisez plutôt le paramètre image_type sous scaling_group dans nodepool.

    Le type de plateforme du système d'exploitation. Valeurs valides :

    • Windows

    • Linux

    Valeur par défaut : Linux.

    Linux
    period deprecated

    integer

    Non

    [Deprecated]

    La durée de l'abonnement. Ce paramètre prend effet et est requis uniquement lorsque charge_type est défini sur PrePaid.

    Valeurs valides : 1, 2, 3, 6, 12, 24, 36, 48 et 60.

    Valeur par défaut : 1.

    Ce paramètre a été modifié le 15 octobre 2024. Pour plus d'informations, consultez Avis sur les changements de comportement des paramètres de l'API CreateCluster.

    1
    period_unit deprecated

    string

    Non

    [Deprecated]

    Le cycle de facturation. Ce paramètre est requis lorsque le mode de facturation est défini sur PrePaid.

    Valeurs valides : Month. Actuellement, seuls les cycles de facturation mensuels sont pris en charge.

    Ce paramètre a été modifié le 15 octobre 2024. Pour plus d'informations, consultez Avis sur les changements de comportement des paramètres de l'API CreateCluster.

    Month
    platform deprecated

    string

    Non

    [Deprecated] Pour la configuration du pool de nœuds, utilisez plutôt le paramètre platform sous scaling_group dans nodepool.

    La distribution du système d'exploitation. Valeurs valides :

    • CentOS

    • AliyunLinux

    • QbootAliyunLinux

    • Qboot

    • Windows

    • WindowsCore

    Valeur par défaut : CentOS.

    CentOS
    pod_vswitch_ids deprecated

    array

    Non

    [Deprecated] Lorsque le plugin réseau Terway est sélectionné, vous devez spécifier des vSwitches pour l'allocation des adresses IP des pods. Chaque vSwitch de pod correspond à un vSwitch de nœud worker, et les zones des vSwitches de pod et des vSwitches de nœud worker doivent être identiques.

    Remarque

    Le masque de bloc CIDR du vSwitch de pod ne doit pas dépasser 19 et ne doit pas excéder 25. Sinon, le nombre d'adresses IP de pod disponibles dans le réseau du cluster sera très limité, ce qui affecte le fonctionnement normal du cluster.

    string

    Non

    Lorsque le plugin réseau Terway est sélectionné, vous devez spécifier des vSwitches pour l'allocation des adresses IP des pods. Chaque vSwitch de pod correspond à un vSwitch de nœud worker, et les zones des vSwitches de pod et des vSwitches de nœud worker doivent être identiques.

    Remarque

    Le masque de bloc CIDR du vSwitch de pod ne doit pas dépasser 19 et ne doit pas excéder 25. Sinon, le nombre d'adresses IP de pod disponibles dans le réseau du cluster sera très limité, ce qui affecte le fonctionnement normal du cluster.

    vsw-2ze97jwri7cei0mpw****
    profile

    string

    Non

    Lorsque vous définissez cluster_type sur ManagedKubernetes pour les clusters ACK managés, vous pouvez spécifier davantage le sous-type de cluster.

    • Default : cluster ACK managé, y compris les clusters ACK (éditions Pro et Basic).

    • Edge : cluster ACK Edge, y compris les clusters ACK Edge (éditions Pro et Basic).

    • Serverless : cluster ACK Serverless, y compris les clusters ACK Serverless (éditions Pro et Basic).

    • Lingjun : cluster ACK Lingjun, disponible en édition Pro.

    Default
    proxy_mode

    string

    Non

    Le mode kube-proxy.

    • iptables : un mode kube-proxy mature et stable. La découverte de services et l'équilibrage de charge pour les services Kubernetes sont configurés à l'aide de règles iptables. Les performances sont modérées et affectées par l'échelle. Ce mode convient aux clusters avec un petit nombre de services.

    • ipvs : un mode kube-proxy haute performance. La découverte de services et l'équilibrage de charge pour les services Kubernetes sont configurés à l'aide du module IPVS de Linux. Ce mode convient aux clusters avec un grand nombre de services nécessitant des performances d'équilibrage de charge élevées.

    • nftables : un mode kube-proxy de nouvelle génération qui implémente la découverte de services et l'équilibrage de charge basés sur nftables de Linux. Il s'agit d'un remplacement moderne d'iptables. Par rapport à iptables, nftables offre de meilleures performances réseau, des mises à jour de règles plus efficaces et un comportement amélioré dans les scénarios de services à grande échelle.
      Uniquement pris en charge pour les clusters exécutant la version 1.35 ou ultérieure. La communauté Kubernetes a rendu IPVS obsolète à partir de la version 1.35. Pour les nouveaux clusters, utilisez nftables pour une prise en charge communautaire à plus long terme.

    Valeur par défaut : ipvs.

    ipvs
    rds_instances deprecated

    array

    Non

    [Deprecated] Pour la configuration du pool de nœuds, utilisez plutôt le paramètre rds_instances sous scaling_group dans nodepool.

    La liste des instances ApsaraDB RDS auxquelles vous souhaitez ajouter les nœuds du cluster à la liste blanche. Ajoutez directement le bloc CIDR des pods de conteneurs et le bloc CIDR des nœuds à la liste blanche RDS. La configuration des instances RDS peut échouer si les instances ne sont pas en état d'exécution.

    string

    Non

    La liste des instances ApsaraDB RDS auxquelles vous souhaitez ajouter les nœuds du cluster à la liste blanche. Ajoutez directement le bloc CIDR des pods de conteneurs et le bloc CIDR des nœuds à la liste blanche RDS. La configuration des instances RDS peut échouer si les instances ne sont pas en état d'exécution.

    rm-2zev748xi27xc****
    region_id

    string

    Oui

    L'identifiant de la région où le cluster est déployé. Pour plus de détails, consultez Régions prises en charge par Container Service.

    cn-beijing
    resource_group_id

    string

    Non

    L'identifiant du groupe de ressources auquel le cluster appartient. Utilisez ce paramètre pour isoler différentes ressources.

    rg-acfm3mkrure****
    rrsa_config

    object

    Non

    La configuration de la fonctionnalité RAM Roles for Service Accounts (RRSA).

    enabled

    boolean

    Non

    Indique si la fonctionnalité RRSA doit être activée.

    • true : activée.

    • false : non activée.

    true
    runtime deprecated runtime

    Non

    Le runtime de conteneurs utilisé dans le cluster. Les runtimes pris en charge incluent containerd, les conteneurs sandboxés et Docker.

    Remarque

    Kubernetes 1.24 ne prend plus en charge Docker en tant que runtime de conteneurs intégré.

    Pour plus d'informations, consultez Comparaison des runtimes de conteneurs Docker, containerd et conteneurs sandboxés.

    security_group_id

    string

    Non

    L'identifiant d'un groupe de sécurité existant. Ce paramètre est mutuellement exclusif avec is_enterprise_security_group. Les nœuds du cluster sont automatiquement ajoutés à ce groupe de sécurité.

    sg-bp1bdue0qc1g7k****
    security_hardening_os deprecated

    boolean

    Non

    [Deprecated] Pour la configuration du plan de contrôle du cluster, utilisez plutôt le paramètre security_hardening_os sous control_plane_config. Pour la configuration du pool de nœuds, utilisez plutôt le paramètre security_hardening_os sous scaling_group dans nodepool.

    Indique si le renforcement de la sécurité du système d'exploitation Alibaba Cloud doit être activé. Valeurs valides :

    • true : active le renforcement de la sécurité du système d'exploitation Alibaba Cloud.

    • false : n'active pas le renforcement de la sécurité du système d'exploitation Alibaba Cloud.

    Valeur par défaut : false.

    false
    service_account_issuer

    string

    Non

    Un ServiceAccount est l'identifiant d'accès utilisé pour la communication entre un pod et le serveur API du cluster. Le service-account-issuer est l'identité de l'émetteur dans le jeton serviceaccount, qui correspond au champ iss dans la charge utile du jeton.

    Pour plus d'informations sur ServiceAccount, consultez Déploiement de la projection de volume de jeton de compte de service.

    kubernetes.default.svc
    service_cidr

    string

    Non

    Le bloc CIDR pour les services. Plages valides : 10.0.0.0/16-24, 172.16-31.0.0/16-24 et 192.168.0.0/16-24. Le bloc CIDR ne peut pas chevaucher le bloc CIDR du VPC 10.1.0.0/21 ni les blocs CIDR utilisés par les clusters Kubernetes existants dans le VPC. Cette valeur ne peut pas être modifiée après la création du cluster.

    Valeur par défaut : 172.19.0.0/20.

    172.21.0.0/20
    service_discovery_types deprecated

    array

    Non

    [Deprecated] Le type de découverte de services au sein du cluster, utilisé pour spécifier la méthode de découverte de services dans les clusters ACK Serverless.

    • CoreDNS : utilise le composant standard natif de Kubernetes pour la découverte de services, CoreDNS. Un ensemble de conteneurs doit être déployé dans le cluster pour la résolution DNS. Par défaut, deux instances ECI avec des spécifications de 0,25 cœur et 512 Mio sont utilisées.

    • PrivateZone : utilise Alibaba Cloud PrivateZone pour fournir des capacités de découverte de services. Le service PrivateZone doit être activé.

    Valeur par défaut : non activé.

    string

    Non

    Le type de découverte de services au sein du cluster, utilisé pour spécifier la méthode de découverte de services dans les clusters ACK Serverless.

    • CoreDNS : utilise le composant standard natif de Kubernetes pour la découverte de services, CoreDNS. Un ensemble de conteneurs doit être déployé dans le cluster pour la résolution DNS. Par défaut, deux instances ECI avec des spécifications de 0,25 cœur et 512 Mio sont utilisées.

    • PrivateZone : utilise Alibaba Cloud PrivateZone pour fournir des capacités de découverte de services. Le service PrivateZone doit être activé.

    Valeur par défaut : non activé.

    PrivateZone
    snat_entry

    boolean

    Non

    Paramètres de configuration de SNAT pour le VPC. Valeurs valides :

    • true : active la création automatique d'une passerelle NAT et la configuration automatique des règles SNAT. Définissez cette valeur sur true si les nœuds et les applications du cluster doivent accéder à Internet.

    • false : ne crée pas de passerelle NAT ni de règles SNAT. Les nœuds et les applications du cluster ne peuvent pas accéder à Internet.

    Remarque

    Si cette option n'est pas activée lors de la création du cluster et qu'un accès à Internet est requis ultérieurement, vous pouvez l'activer manuellement.

    Valeur par défaut : false.

    false
    soc_enabled deprecated

    boolean

    Non

    [Deprecated] Pour la configuration des nœuds du plan de contrôle du cluster, utilisez plutôt le paramètre soc_enabled sous control_plane_config. Pour la configuration du pool de nœuds, utilisez plutôt le paramètre soc_enabled sous scaling_group dans nodepool.

    Indique si le renforcement de la sécurité MLPS 2.0 doit être activé. Pour plus d'informations, consultez Conformité à la protection classifiée en Chine pour ACK.

    Valeurs valides :

    • true : active le renforcement de la sécurité MLPS 2.0.

    • false : n'active pas le renforcement de la sécurité MLPS 2.0.

    Valeur par défaut : false.

    false
    ssh_flags

    boolean

    Non

    Indique si la connexion SSH publique doit être activée. Ceci est utilisé pour se connecter aux nœuds maîtres des clusters dédiés ACK. Ce paramètre ne prend pas effet pour les clusters managés.

    • true : activée.

    • false : non activée.

    Valeur par défaut : false.

    true
    tags

    array

    Non

    Les balises des nœuds. Règles de définition des balises :

    • Les balises sont des paires clé-valeur sensibles à la casse. Vous pouvez définir jusqu'à 20 balises.

    • Les clés de balise ne peuvent pas être dupliquées et peuvent comporter jusqu'à 64 caractères. Les valeurs de balise peuvent être vides et comporter jusqu'à 128 caractères. Les clés et les valeurs de balise ne peuvent pas commencer par "aliyun", "acs:", "https://" ou "http://". Pour plus d'informations, consultez Étiquettes et sélecteurs.

    tag

    Non

    Les balises des nœuds. Règles de définition des balises :

    • Les balises sont des paires clé-valeur sensibles à la casse. Vous pouvez définir jusqu'à 20 balises.

    • Les clés de balise ne peuvent pas être dupliquées et peuvent comporter jusqu'à 64 caractères. Les valeurs de balise peuvent être vides et comporter jusqu'à 128 caractères. Les clés et les valeurs de balise ne peuvent pas commencer par "aliyun", "acs:", "https://" ou "http://". Pour plus d'informations, consultez Étiquettes et sélecteurs.

    taints deprecated

    array

    Non

    [Deprecated] Pour la configuration du pool de nœuds, utilisez plutôt le paramètre taints sous kubernetes_config dans nodepool.

    Les informations sur les taints des nœuds. Les taints et les tolerations fonctionnent ensemble pour empêcher les pods d'être planifiés sur des nœuds inappropriés. Pour plus d'informations, consultez taint-and-toleration.

    taint

    Non

    Les informations sur les taints des nœuds. Les taints et les tolerations fonctionnent ensemble pour empêcher les pods d'être planifiés sur des nœuds inappropriés. Pour plus d'informations, consultez taint-and-toleration.

    timeout_mins deprecated

    integer

    Non

    [Deprecated] Par défaut, le système n'effectue pas de restauration lorsque la création du cluster échoue. Vous devez nettoyer manuellement le cluster ayant échoué.

    Le délai d'expiration de la création du cluster, en minutes.

    Valeur par défaut : 60.

    60
    timezone

    string

    Non

    Le fuseau horaire utilisé par le cluster. Pour plus d'informations, consultez Fuseaux horaires pris en charge.

    Asia/Shanghai
    user_ca

    string

    Non

    L'autorité de certification (CA) personnalisée du cluster.

    -----BEGIN CERTIFICATE-----****
    user_data deprecated

    string

    Non

    [Deprecated] Les données de nœud personnalisées.

    IyEvdXNyL2Jpbi9iYXNoCmVjaG8gIkhlbGxvIEFD****
    vpcid

    string

    Non

    Le VPC utilisé par le cluster. Vous devez fournir un VPC lors de la création d'un cluster.

    vpc-2zeik9h3ahvv2zz95****
    vswitch_ids

    array

    Non

    Les vSwitches pour les nœuds du cluster. Ce paramètre est requis lors de la création d'un cluster managé sans nœud.

    string

    Non

    Les vSwitches pour les nœuds du cluster. Ce paramètre est requis lors de la création d'un cluster managé sans nœud.

    vsw-2ze3ds0mdip0hdz8i****
    worker_auto_renew deprecated

    boolean

    Non

    [Deprecated] Pour la configuration du pool de nœuds, utilisez plutôt le paramètre auto_renew sous scaling_group dans nodepool.

    Indique si le renouvellement automatique des nœuds workers doit être activé. Ce paramètre prend effet uniquement lorsque worker_instance_charge_type est défini sur PrePaid. Valeurs valides :

    • true : active le renouvellement automatique.

    • false : n'active pas le renouvellement automatique.

    Valeur par défaut : true.

    true
    worker_auto_renew_period deprecated

    integer

    Non

    [Deprecated] Pour la configuration du pool de nœuds, utilisez plutôt le paramètre auto_renew_period sous scaling_group dans nodepool.

    Le cycle de renouvellement automatique pour les nœuds workers. Ce paramètre prend effet et est requis uniquement lorsque le mode de facturation par abonnement est sélectionné.

    Valeurs valides : 1, 2, 3, 6 et 12.

    1
    worker_data_disks deprecated

    array<object>

    Non

    [Obsolète] Utilisez le paramètre data_disks dans scaling_group du pool de nœuds à la place.

    La combinaison du type, de la taille et d'autres configurations des disques cloud de données pour les nœuds de travail.

    object

    Non

    L'ensemble de configuration des disques cloud de données.

    category

    string

    Oui

    Le type de disque cloud de données.

    cloud_essd
    encrypted

    string

    Non

    Indique si les disques cloud de données doivent être chiffrés. Valeurs valides :

    • true : chiffre les disques cloud de données.

    • false : ne chiffre pas les disques cloud de données.

    Valeur par défaut : false.

    true
    performance_level

    string

    Non

    Le niveau de performance des disques cloud de données des nœuds. Ce paramètre prend effet uniquement pour les disques cloud ESSD.

    PL1
    size

    string

    Oui

    La taille du disque cloud de données. Valeurs valides : 40 à 32767. Unité : Gio.

    120
    worker_instance_charge_type deprecated

    string

    Non

    [Obsolète] Utilisez le paramètre instance_charge_type dans scaling_group du pool de nœuds à la place.

    Le mode de facturation des nœuds de travail. Valeurs valides :

    • PrePaid : abonnement.

    • PostPaid : paiement à l'usage.

    Valeur par défaut : paiement à l'usage.

    PrePaid
    worker_instance_types deprecated

    array

    Non

    [Obsolète] Utilisez le paramètre instance_types dans scaling_group du pool de nœuds à la place.

    Les configurations d'instances pour les nœuds de travail.

    string

    Non

    Le type d'instance pour les nœuds de travail. Spécifiez au moins un type d'instance. Pour plus d'informations, consultez Familles d'instances.

    Remarque

    La priorité d'un type d'instance diminue à mesure que sa position dans le tableau augmente. Si une instance ne peut pas être créée sur la base d'un type d'instance à priorité plus élevée, le système utilise automatiquement le type d'instance de priorité suivante.

    ecs.n4.large
    worker_period deprecated

    integer

    Non

    [Obsolète] Utilisez le paramètre period dans scaling_group du pool de nœuds à la place.

    La durée d'abonnement pour les nœuds de travail. Ce paramètre prend effet et est requis uniquement lorsque worker_instance_charge_type est défini sur PrePaid.

    Valeurs valides : {1, 2, 3, 6, 12, 24, 36, 48, 60}.

    Valeur par défaut : 1.

    1
    worker_period_unit deprecated

    string

    Non

    [Obsolète] Utilisez le paramètre period_unit dans scaling_group du pool de nœuds à la place.

    Le cycle de facturation pour les nœuds de travail. Ce paramètre est requis lorsque le mode de facturation est PrePaid.

    Valeurs valides : Month. Actuellement, seuls les cycles de facturation mensuels sont pris en charge.

    Month
    worker_system_disk_category deprecated

    string

    Non

    [Obsolète] Utilisez le paramètre system_disk_category dans scaling_group du pool de nœuds à la place.

    Le type de disque cloud système pour les nœuds de travail. Pour plus d'informations, consultez Présentation du stockage bloc.

    Valeurs valides :

    • cloud_efficiency : disque cloud ultra.

    • cloud_ssd : SSD standard.

    Valeur par défaut : cloud_ssd.

    cloud_efficiency
    worker_system_disk_performance_level deprecated

    string

    Non

    [Obsolète] Utilisez le paramètre system_disk_performance_level dans scaling_group du pool de nœuds à la place.

    Lorsque le disque cloud système est un ESSD, vous pouvez configurer le niveau de performance (PL) de l'ESSD. Pour plus d'informations, consultez Disques cloud ESSD.

    Valeurs valides :

    • PL0

    • PL1

    • PL2

    • PL3

    PL1
    worker_system_disk_size deprecated

    integer

    Non

    [Obsolète] Utilisez le paramètre system_disk_size dans scaling_group du pool de nœuds à la place.

    La taille du disque cloud système pour les nœuds de travail. Unité : Gio.

    Valeurs valides : [40,500].

    La valeur de ce paramètre doit être supérieure ou égale à max{40, ImageSize}.

    Valeur par défaut : 120.

    120
    worker_system_disk_snapshot_policy_id deprecated

    string

    Non

    [Obsolète] Utilisez le paramètre system_disk_snapshot_policy_id dans scaling_group du pool de nœuds à la place.

    L'identifiant de la stratégie d'instantané automatique utilisée par les disques cloud système des nœuds de travail.

    sp-2zej1nogjvovnz4z****
    worker_vswitch_ids deprecated

    array

    Non

    [Obsolète] Utilisez le paramètre vswitch_ids dans scaling_group du pool de nœuds à la place.

    La liste des vSwitches utilisés par les nœuds du cluster. Chaque nœud correspond à une valeur.

    Lorsque vous créez un cluster géré avec zéro nœud, le champ worker_vswitch_ids n'est pas requis, mais vous devez fournir vswitch_ids.

    string

    Non

    La liste des vSwitches pour les nœuds de travail. Valeurs valides : [1,20]. Pour garantir une haute disponibilité, sélectionnez des vSwitches dans différentes zones.

    Lorsque vous créez un cluster géré avec zéro nœud, le champ worker_vswitch_ids n'est pas requis, mais vous devez fournir vswitch_ids.

    vsw-2ze3ds0mdip0hdz8i****
    zone_id deprecated

    string

    Non

    [Obsolète] Utilisez le paramètre zone_ids à la place.

    L'identifiant de la zone active de la région à laquelle le cluster appartient. Ce paramètre est spécifique aux clusters gérés ACK.

    Lorsque vous créez un cluster géré ACK, si vpc_id et vswitch_ids ne sont pas spécifiés, vous devez spécifier zone_id pour que le cluster crée automatiquement un VPC et les ressources réseau associées dans cette zone. Si vpc_id et vswitch_ids sont spécifiés, ce paramètre ne prend pas effet.

    cn-beiji****
    zone_ids

    array

    Non

    Les identifiants de plusieurs zones dans la région à laquelle le cluster appartient. Ce paramètre est spécifique aux clusters gérés ACK.

    string

    Non

    L'identifiant de la zone active de la région à laquelle le cluster appartient. Les vSwitches sont susceptibles d'être créés automatiquement dans cette zone.

    Lorsque vous créez un cluster géré ACK, si vpc_id et vswitch_ids ne sont pas spécifiés, spécifiez zone_ids pour que le cluster crée automatiquement un VPC et les ressources réseau associées dans plusieurs zones actives. Si vpc_id et vswitch_ids sont spécifiés, ce paramètre ne prend pas effet.

    cn-beijing-h

    Éléments de réponse

    Élément

    Type

    Description

    Exemple

    object

    Le corps de la réponse.

    cluster_id

    string

    L'identifiant du cluster.

    cb95aa626a47740afbf6aa099b650****
    request_id

    string

    L'identifiant de la requête.

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

    string

    L'identifiant de la tâche.

    T-5a54309c80282e39ea****

    Exemples

    JSON format

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

    Codes d'erreur

    Consultez Codes d'erreur pour la liste complète.

    Notes de version

    Consultez Notes de version pour la liste complète.