Tous les produits
Search
Centre de documentation

Elastic Compute Service:Exécuter une commande Cloud Assistant

Dernière mise à jour :Aug 18, 2026

Exécutez une commande Cloud Assistant créée sur une ou plusieurs instances ECS. Chaque instance exécute la commande de manière indépendante.

Prérequis

Les instances cibles doivent répondre aux exigences suivantes :

  • Les instances sont dans l'état Running.

  • L'agent Cloud Assistant Agent doit être installé. Pour plus d'informations, consultez la rubrique Installation de l'agent Cloud Assistant.

    Pour utiliser les nouvelles fonctionnalités des tâches planifiées, telles que l'exécution d'une commande à intervalle fixe, l'exécution unique à une heure spécifiée ou la spécification d'une année ou d'un fuseau horaire dans une expression cron, assurez-vous que votre agent Cloud Assistant Agent est en version 2.2.3.282 ou ultérieure pour Linux, et en version 2.1.3.282 ou ultérieure pour Windows.

    • Linux : 2.2.3.282

    • Windows : 2.1.3.282

    Si le code d'erreur ClientNeedUpgrade est renvoyé, mettez à jour l'agent vers la dernière version. Pour plus d'informations, consultez la rubrique Mise à niveau ou désactivation des mises à niveau automatiques de l'agent Cloud Assistant.

Contexte

  • Lorsque vous appelez une opération API pour exécuter une commande, vous pouvez sélectionner un maximum de 100 instances. Vous pouvez demander une augmentation du quota « Nombre maximal d'instances prises en charge pour l'exécution des commandes ». Pour savoir comment afficher et augmenter les quotas de ressources, consultez la rubrique Affichage et augmentation des quotas de ressources.

  • Si vous sélectionnez plus de 100 instances dans la console ECS, le système exécute la commande par lots.

Procédure

Exécuter une commande dans la console ECS

  1. Accédez à la page Console ECS - Cloud Assistant.

  2. Dans le coin supérieur gauche de la page, sélectionnez une région et un groupe de ressources.

  3. Sous l'onglet My Commands, localisez la commande cible et cliquez sur Run dans la colonne Actions.

  4. Dans le panneau Run Command, configurez les paramètres suivants.

    1. Dans la section Command Information, vérifiez le contenu de la commande et configurez les paramètres suivants.

      Paramètre

      Description

      Command

      Cliquez sur View command content pour afficher la commande.

      Execution Plan

      Sélectionnez le moment d'exécution de la commande.

      • Immediate execution : exécute la commande immédiatement.

      • After the next startup of the system : exécute la commande au prochain démarrage des instances.

      • After each system startup : exécute la commande à chaque démarrage des instances.

      • Perform Only Dry Run : valide les paramètres de requête, les environnements d'exécution des instances et l'état de l'agent Cloud Assistant sans exécuter la commande.

      • Timing execution : exécute la commande à intervalle fixe, à une heure spécifique ou selon une planification cron. Options :

        • Run at Fixed Interval : spécifiez une expression de taux pour exécuter la commande à intervalle fixe en secondes, minutes, heures ou jours.

          Remarque

          Limites d'intervalle :

          • L'intervalle varie de 60 secondes à 7 jours et doit dépasser la période de délai d'attente de la tâche planifiée.

          • L'intervalle est mesuré entre les exécutions consécutives, sans inclure le temps d'exécution. Par exemple, si l'intervalle est de 5 minutes et qu'une exécution dure 2 minutes, la prochaine exécution commence 3 minutes après la fin de l'exécution précédente.

          • La première exécution commence après un intervalle complet. Par exemple, une tâche avec un intervalle de 5 minutes s'exécute 5 minutes après sa création.

        • Run Only Once at Specified Time : spécifiez une heure et un fuseau horaire pour exécuter la commande une seule fois.

          Par exemple, définir l'Execution Time sur May 17, 2022, 17:30:50 et le Time Zone sur (GMT+08:00) Asia/Shanghai exécute la commande une fois le 17 mai 2022 à 17:30:50 (UTC+8).

        • Run on Clock-based Schedule : utilisez une expression cron pour exécuter la commande selon une planification. Spécifiez la fréquence avec une granularité en secondes, minutes, heures, jour du mois, mois, jour de la semaine ou année, et sélectionnez un fuseau horaire dans la liste déroulante Time Zone. Consultez la rubrique Expressions cron.

          Remarque

          L'intervalle minimum doit être de 10 secondes ou plus et doit dépasser la période de délai d'attente des exécutions planifiées.

          Par exemple, définir la Execution Frequency sur 0 0 12 ? * WED 2022 et le Time Zone sur (GMT+08:00) Asia/Shanghai exécute la commande tous les mercredis de l'année 2022 à 12:00:00 (UTC+8).

      Username

      Le nom d'utilisateur pour exécuter la commande sur les instances ECS.

      Pour des raisons de sécurité, exécutez les commandes Cloud Assistant en tant qu'utilisateur standard, conformément au principe du moindre privilège. Consultez la rubrique Exécution des commandes Cloud Assistant en tant qu'utilisateur RAM.

      Par défaut, les commandes s'exécutent en tant qu'utilisateur root sous Linux et en tant qu'utilisateur système sous Windows.

      Timeout Period

      La Timeout Period pour l'exécution de la commande sur les instances. Si la tâche expire, Cloud Assistant termine de force le processus de la tâche.

      Unité : secondes. Valeur par défaut : la Timeout Period spécifiée pour la commande.

      Remarque

      Ce délai d'attente s'applique uniquement à la tâche de commande. Sa modification n'affecte pas le délai d'attente de la commande elle-même.

      Tag

      Ajoutez des tags à la tâche de commande en spécifiant la Tag Key et la Value.

    2. Dans les sections Select Instances et Select Managed Instances, sélectionnez les instances cibles.

      Recherchez des instances par ID, nom ou tag, et filtrez par état de l'agent Cloud Assistant Agent.

      Remarque

      Les instances gérées sont des serveurs non Alibaba Cloud gérés par Cloud Assistant. Pour plus d'informations, consultez la rubrique Instances gérées par Alibaba Cloud.

  5. Cliquez sur Run.

Exécuter une commande à l'aide d'Alibaba Cloud CLI

Avant d'utiliser Alibaba Cloud CLI, installez-le sur votre ordinateur. Les méthodes d'installation varient selon le système d'exploitation :

  1. (Facultatif) Si l'instance n'est pas dans l'état Running (Running), appelez StartInstance pour la démarrer.

    aliyun ecs StartInstance --InstanceId 'i-bp1f4f6o8lv0wqof****' 
    Remarque

    Les valeurs entre guillemets simples ('') sont des exemples. Remplacez-les par vos valeurs réelles.

    Consultez la documentation de l'API StartInstance.

  2. (Facultatif) Appelez DescribeCloudAssistantStatus pour vérifier si l'agent Cloud Assistant Agent est installé sur les instances.

    aliyun ecs DescribeCloudAssistantStatus --RegionId 'cn-hangzhou' \
    --InstanceId.1 'i-bp1f4f6o8lv0wqof****' 

    Si l'agent Cloud Assistant Agent est installé, CloudAssistantStatus a la valeur true dans la réponse. Sinon, appelez InstallCloudAssistant pour l'installer. Consultez les documentations des API DescribeCloudAssistantStatus et InstallCloudAssistant.

  3. Appelez InvokeCommand pour exécuter une commande Cloud Assistant sur une ou plusieurs instances.

    aliyun ecs InvokeCommand --RegionId 'cn-hangzhou' \
    --InstanceId.1 'i-bp1f4f6o8lv0wqof****' \
    --InstanceId.2 'i-bp137qu6142s3mhm****' \
    --CommandId 'c-hz018qp243j****'

    Le tableau suivant décrit les principaux paramètres. Consultez la documentation de l'API InvokeCommand.

    Paramètre

    Exemple

    Description

    RegionId

    cn-hangzhou

    ID de la région.

    InstanceId.1

    i-bp1f4f6o8lv0wqof****

    ID de la première instance sur laquelle exécuter la commande.

    InstanceId.2

    i-bp137qu6142s3mhm****

    ID de la deuxième instance sur laquelle exécuter la commande.

    CommandId

    c-hz018qp243j****

    ID de la commande.