Tous les produits
Search

Ce produit

    Container Service for Kubernetes:ModifyCluster

    Centre de documentation

    Container Service for Kubernetes:ModifyCluster

    Dernière mise à jour :Sep 10, 2026

    Modifie la configuration d'un cluster ACK.

    Description de l'opération

    Important À partir du 4 juillet 2026, les paramètres de requête instance_deletion_protection, ingress_loadbalancer_id et access_control_list ne seront plus pris en compte. Pour plus d'informations sur ces modifications, consultez Annonce concernant les modifications des paramètres de requête et de réponse OpenAPI et l'obsolescence des OpenAPI pour la gestion des clusters ACK.

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

    update

    *Cluster

    acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}
    • cs:EnableApiServerEip
    • cs:ApiServerEipId
    		 Aucune

    Syntaxe de la requête

    PUT /api/v2/clusters/{ClusterId} HTTP/1.1

    Paramètres de chemin

    Paramètre

    Type

    Requis

    Description

    Exemple
    ClusterId

    string

    Oui

    L'identifiant du cluster.

    cb95aa626a47740afbf6aa099b65****

    Paramètres de requête

    Paramètre

    Type

    Requis

    Description

    Exemple
    body

    object

    Non

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

    true
    access_control_list deprecated

    array

    Non

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

    string

    Non

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

    Remarque : Le bloc CIDR 0.0.0.0/0 n'est pas autorisé.

    192.168.XX.XX/24
    api_server_custom_cert_sans

    object

    Non

    Les noms alternatifs du sujet (SAN) personnalisés du certificat du serveur d'API. Ce paramètre ajoute des adresses IP ou des noms de domaine personnalisés au champ SAN du certificat du serveur d'API du cluster pour le contrôle d'accès client.

    Seuls les clusters gérés prennent en charge ce paramètre.

    action

    string

    Non

    Indique s'il faut écraser ou ajouter la configuration SAN. Valeurs valides :

    • overwrite : écrase la configuration SAN existante.

    • append : ajoute à la configuration SAN existante.

    append
    subject_alternative_names

    array

    Non

    La liste des SAN.

    string

    Non

    Le SAN. Les adresses IP ou les noms de domaine personnalisés sont pris en charge. Séparez les adresses IP ou les noms de domaine multiples par des virgules (,).

    aliyun.xxx.com,192.168.xx.xx
    api_server_eip

    boolean

    Non

    Indique si le cluster est associé à une EIP pour l'accès au réseau public au serveur d'API. Valeurs valides :

    • true : Le cluster est associé à une EIP.

    • false : Le cluster n'est pas associé à une EIP.

    true
    api_server_eip_id

    string

    Non

    L'identifiant d'instance de l'EIP associée au serveur d'API du cluster. Ce paramètre prend effet uniquement lorsque api_server_eip est défini sur true.

    eip-wz9fnasl6dsfhmvci****
    client_token

    string

    Non

    Le jeton client.

    af31042c-6355-495b-b6e3-exxb9669
    cluster_name

    string

    Non

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

    cluster-new-name
    cluster_spec

    string

    Non

    La spécification du cluster lorsque cluster_type est défini sur ManagedKubernetes et que profile est configuré. Valeurs valides :

    • ack.pro.small : Pro

    • ack.pro.xlarge : Pro XL

    • ack.pro.2xlarge : Pro 2XL

    • ack.pro.4xlarge : Pro 4XL (contactez le service client pour être ajouté à la liste blanche)

    Pro XL, Pro 2XL et Pro 4XL sont trois niveaux fournis par le 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 des 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 des clusters pour les éditions Pro et plan de contrôle provisionné, consultez les Frais de gestion des clusters.

    ack.pro.small
    control_plane_config

    object

    Non

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

    auto_renew

    boolean

    Non

    Indique si le renouvellement automatique doit être activé pour les instances de nœud du plan de contrôle. 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.

    false
    auto_renew_period

    integer

    Non

    La période de renouvellement automatique pour chaque renouvellement des instances de nœud du plan de contrôle.

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

    Valeur par défaut : 1.

    1
    charge_type

    string

    Non

    Le mode de facturation pour les instances de nœud du plan de contrôle. Valeurs valides :

    • PrePaid : abonnement.

    • PostPaid : paiement à l'usage.

    Valeur par défaut : PostPaid.

    PostPaid
    cloud_monitor_flags

    boolean

    Non

    Indique si l'agent CloudMonitor doit être installé sur les nœuds du plan de contrôle. Valeurs valides :

    • true : Installe l'agent CloudMonitor.

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

    true
    cpu_policy

    string

    Non

    La stratégie de gestion du processeur pour les nœuds. Les stratégies suivantes sont prises en charge pour les clusters exécutant la version 1.12.6 ou ultérieure :

    • static : Améliore l'affinité et l'exclusivité du processeur pour les pods avec des caractéristiques de ressources spécifiques sur le nœud.

    • none : Utilise le schéma d'affinité du processeur par défaut.

    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 personnalisée. Spécifiez ce paramètre lorsque vous utilisez une image personnalisée.

    aliyun_3_x64_20G_alibase_20240819.vhd
    image_type

    string

    Non

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

    • AliyunLinux3 : Image Alinux3.

    • Custom : image personnalisée.

    AliyunLinux3
    instance_types

    array

    Non

    Les types d'instances. Pour plus d'informations, consultez Familles d'instances.

    string

    Non

    Le type d'instance.

    ecs.g6.large
    key_pair

    string

    Non

    Le nom de la paire de clés. Spécifiez ce paramètre ou login_password.

    ack
    login_password

    string

    Non

    Le mot de passe de connexion SSH. Spécifiez ce paramètre ou key_pair. 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. Pour utiliser une connexion par mot de passe, spécifiez ce paramètre lors de la mise à l'échelle horizontale.

    Ack@2000
    node_port_range

    string

    Non

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

    Valeur par défaut : 30000-32767.

    30000-32767
    period

    integer

    Non

    La durée d'abonnement pour les instances de nœud du plan de contrôle. Ce paramètre prend effet et est requis uniquement lorsque charge_type est défini sur PrePaid.

    Si period_unit=Month, les valeurs valides sont {1, 2, 3, 6, 12, 24, 36, 48, 60}.

    1
    period_unit

    string

    Non

    L'unité du cycle de facturation pour les instances de nœud du plan de contrôle. Ce paramètre prend effet uniquement lorsque charge_type est défini sur PrePaid.

    Month : Le cycle de facturation est mesuré en mois. Actuellement, seuls les mois sont pris en charge.

    Month
    runtime

    string

    Non

    Le nom de l'environnement d'exécution de conteneurs. Valeurs valides :

    • containerd : Recommandé. Pris en charge par toutes les versions de cluster.

    Valeur par défaut : containerd.

    containerd
    security_hardening_os

    boolean

    Non

    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 : Désactive le renforcement de la sécurité du système d'exploitation Alibaba Cloud.

    Valeur par défaut : false.

    false
    size

    integer

    Non

    Le nombre de nœuds du plan de contrôle. Pour mettre à l'échelle horizontale le plan de contrôle d'un cluster dédié, définissez ce paramètre sur le nombre cible de nœuds du plan de contrôle, qui doit être supérieur au nombre actuel.

    5
    soc_enabled

    boolean

    Non

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

    Valeurs valides :

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

    • false : Désactive le renforcement de la sécurité MLPS 2.0.

    Valeur par défaut : false.

    false
    system_disk_bursting_enabled

    boolean

    Non

    Indique si le mode rafale doit être activé pour le disque cloud système du nœud. Valeurs valides :

    • true : Active le mode rafale.

    • false : Désactive le mode rafale.

    Ce paramètre est pris en charge uniquement lorsque system_disk_category est défini sur cloud_auto. Pour plus d'informations, consultez Disques cloud ESSD AutoPL.

    true
    system_disk_category

    string

    Non

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

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

    cloud_essd
    system_disk_performance_level

    string

    Non

    Le niveau de performance (PL) du disque cloud système du nœud. Ce paramètre prend effet uniquement pour les disques cloud ESSD. Le niveau de performance varie en fonction de la taille du disque cloud. Pour plus d'informations, consultez ESSD.

    PL1
    system_disk_provisioned_iops

    integer

    Non

    Les IOPS de lecture/écriture provisionnées pour le disque cloud système du nœud. Valeurs valides : 0 à min{50 000, 1 000 × capacité - performances de base}. Performances de base = min{1 800 + 50 × capacité, 50 000}.

    Ce paramètre est pris en charge uniquement lorsque system_disk_category est défini sur cloud_auto. Pour plus d'informations, consultez Disques cloud ESSD AutoPL.

    1000
    system_disk_size

    integer

    Non

    La taille du disque cloud système du nœud. Valeurs valides : 40 à 500. Unité : Gio.

    120
    system_disk_snapshot_policy_id

    string

    Non

    L'identifiant de la stratégie d'instantané automatique appliquée au disque cloud système du nœud.

    sp-2zej1nogjvovnz4z****
    control_plane_endpoints_config

    object

    Non

    La configuration de connexion du cluster.

    internal_dns_config

    object

    Non

    La configuration du nom de domaine interne du 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 d'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 d'API via l'adresse IP de l'instance CLB.

    bind_vpcs

    array

    Non

    Les VPC dans lesquels les enregistrements DNS de nom de domaine interne prennent effet.

    string

    Non

    Les VPC dans lesquels les enregistrements DNS de nom de domaine interne prennent effet.

    vpc-xxxx
    enabled

    boolean

    Non

    Indique si l'accès par nom de domaine interne doit être activé pour le cluster. Valeurs valides :

    • true : active l'accès par nom de domaine interne. Les composants côté nœud (kubelet, kube-proxy) accèdent au serveur d'API via le nom de domaine interne.

    true
    load_balancers_config

    array<object>

    Non

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

    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.

    public
    load_balancer_id

    string

    Non

    L'instance SLB associée au point de terminaison.

    nlb-xxxx
    deletion_protection

    boolean

    Non

    Indique si la protection contre la suppression doit être activée pour le cluster. La protection contre la suppression empêche la suppression accidentelle du cluster dans la console ou via des appels d'API. Valeurs valides :

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

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

    Valeur par défaut : false.

    false
    enable_rrsa

    boolean

    Non

    Indique si la fonctionnalité RRSA doit être activée ou désactivée. Seuls les clusters managés prennent en charge ce paramètre. Valeurs valides :

    • true : activer.

    • false : désactiver.

    true
    ingress_domain_rebinding deprecated

    boolean

    Non

    Indique si le nom de domaine de test du cluster doit être relié. Valeurs valides :

    • true : relie le nom de domaine de test du cluster.

    • false : ne relie pas le nom de domaine de test du cluster.

    Valeur par défaut : false.

    false
    ingress_loadbalancer_id deprecated

    string

    Non

    L'identifiant de l'instance SLB du cluster à modifier.

    lb-wz97kes8tnndkpodw****
    instance_deletion_protection deprecated

    boolean

    Non

    Indique si la protection contre la suppression des instances doit être activée pour empêcher la suppression accidentelle des nœuds dans la console ou via des appels d'API. Valeurs valides :

    • true : les nœuds ne peuvent pas être supprimés accidentellement dans la console ou via des appels d'API.

    • false : les nœuds peuvent être supprimés dans la console ou via des appels d'API.

    Valeur par défaut : false.

    false
    maintenance_window maintenance_window

    Non

    La configuration de la fenêtre de maintenance du cluster. Cette fonctionnalité prend effet uniquement dans les clusters managés ACK Pro.

    operation_policy

    object

    Non

    La stratégie d'O&M automatique 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. Pour plus d'informations, consultez Fréquence de mise à niveau.

    Valeurs valides :

    • patch : la dernière version de correctif.

    • stable : l'avant-dernière version mineure.

    • rapid : la dernière version mineure.

    patch
    enabled

    boolean

    Non

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

    • true : active la mise à niveau automatique.

    • false : désactive la mise à niveau automatique.

    true
    resource_group_id

    string

    Non

    L'identifiant du groupe de ressources du cluster.

    rg-acfmyvw3wjm****
    security_group_id

    string

    Non

    L'identifiant du groupe de sécurité du plan de contrôle.

    • Si vous avez configuré des règles de blocage dans le groupe de sécurité, assurez-vous que les règles du groupe de sécurité autorisent les protocoles et les ports dont dépend le cluster. Pour connaître la portée recommandée des règles de groupe de sécurité, consultez Configurer et gérer les groupes de sécurité du cluster.

    • Pour les clusters non dédiés ACK, le plan de contrôle du cluster et les composants managés installés (tels que terway-controlplane) redémarrent brièvement pendant la procédure de modification. Effectuez cette opération pendant les heures creuses. Une fois le groupe de sécurité du plan de contrôle modifié, les interfaces réseau élastiques (ENI) utilisées par le plan de contrôle du cluster et les composants managés installés sont automatiquement ajoutées au nouveau groupe de sécurité.

    • Pour les clusters dédiés ACK, une fois le groupe de sécurité du plan de contrôle modifié, les nouveaux nœuds maîtres ajoutés lors de la mise à l'échelle utilisent automatiquement le nouveau groupe de sécurité du plan de contrôle. Les nœuds du plan de contrôle existants ne sont pas affectés.

    sg-bp1h6rk3pgct2a08***
    system_events_logging

    object

    Non

    La configuration du stockage des événements système.

    enabled

    boolean

    Non

    Indique si le stockage des événements système doit être activé.

    • true : active le stockage des événements système.

    • false : désactive le stockage des événements système.

    true
    logging_project

    string

    Non

    Le nom du LogProject pour le stockage des événements système.

    k8s-log-cb95aa626a47740afbf6aa099b65****
    timezone

    string

    Non

    Le fuseau horaire du cluster. Consultez Fuseaux horaires pris en charge.

    • Une fois le fuseau horaire modifié, la configuration d'inspection du cluster utilise les nouveaux paramètres de fuseau horaire.

    • Pour les clusters managés, le plan de contrôle du cluster et les composants managés installés (tels que terway-controlplane) redémarrent brièvement pendant la modification. Effectuez cette opération pendant les heures creuses. Une fois le fuseau horaire modifié, les nouveaux nœuds ajoutés lors de la mise à l'échelle utilisent automatiquement les nouveaux paramètres de fuseau horaire. Les nœuds existants ne sont pas affectés. Vous pouvez utiliser la fonctionnalité de réinitialisation des nœuds du pool de nœuds pour appliquer les nouveaux paramètres aux nœuds existants.

    • Pour les clusters dédiés, une fois le fuseau horaire modifié, les nouveaux nœuds ajoutés lors de la mise à l'échelle (y compris les nœuds du plan de contrôle) utilisent automatiquement les nouveaux paramètres de fuseau horaire. Les nœuds existants (y compris les nœuds du plan de contrôle) ne sont pas affectés. Vous pouvez utiliser la fonctionnalité de réinitialisation des nœuds du pool de nœuds pour appliquer les nouveaux paramètres aux nœuds existants. Pour les nœuds du plan de contrôle, vous devez effectuer une mise à l'échelle vers le haut puis vers le bas pour appliquer les nouveaux paramètres à tous les nœuds du plan de contrôle.

    Asia/Shanghai
    vswitch_ids

    array

    Non

    Les vSwitches du plan de contrôle du cluster. Pour les clusters dédiés, la modification s'applique aux nouveaux nœuds du plan de contrôle ajoutés lors de la mise à l'échelle. Pour les clusters managés, notez les points suivants lors de la modification des vSwitches du plan de contrôle :

    • Ce paramètre effectue une mise à jour par écrasement complet. Spécifiez la liste complète des vSwitches cibles.

    • Les composants du plan de contrôle redémarrent brièvement pendant la modification. Procédez avec prudence.

    • Assurez-vous que tous les groupes de sécurité du cluster (y compris le groupe de sécurité du plan de contrôle, les groupes de sécurité de tous les pools de nœuds et les groupes de sécurité utilisés par le réseau de conteneurs) autorisent le trafic entrant et sortant pour les blocs CIDR IP des nouveaux vSwitches. Cela empêche les nœuds et les conteneurs de ne pas pouvoir se connecter au serveur d'API.

    • Si des règles ACL sont configurées pour les nouveaux vSwitches du plan de contrôle, assurez-vous que les règles ACL autorisent la communication avec les blocs CIDR IP des nœuds du cluster et du réseau de conteneurs.

    string

    Non

    Le vSwitch du plan de contrôle du cluster.

    vsw-2ze4jvvvade1yk899****

    Éléments de réponse

    Élément

    Type

    Description

    Exemple

    object

    Le corps de la réponse.

    cluster_id

    string

    L'identifiant du cluster.

    cb95aa626a47740afbf6aa09****
    request_id

    string

    L'identifiant de la requête.

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

    string

    L'identifiant de la tâche.

    T-5a54309c80282e39ea00****

    Exemples

    JSON format

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

    Codes d'erreur

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

    Notes de version

    Consultez Notes de version pour la liste complète.