Todos los productos
Search
Centro de documentos

Elastic Compute Service:Run a Cloud Assistant command

Última actualización: Sep 02, 2026

Ejecute un comando creado de Cloud Assistant en una o más instancias de ECS. Cada instancia se ejecuta de forma independiente.

Requisitos previos

Las instancias de destino deben cumplir con los siguientes requisitos:

  • Las instancias deben estar en estado Running.

  • Debe tener instalado Cloud Assistant Agent. Para obtener más información, consulte Install the Cloud Assistant Agent.

    Para utilizar las nuevas funciones de tareas programadas, como ejecutar un comando a intervalos fijos, ejecutarlo solo una vez a una hora específica o especificar un año o zona horaria en una expresión cron, asegúrese de que su versión de Cloud Assistant Agent sea igual o posterior a las siguientes:

    • Linux: 2.2.3.282

    • Windows: 2.1.3.282

    Si se devuelve el código de error ClientNeedUpgrade, debe actualizar el agente a la versión más reciente. Para obtener más información, consulte Upgrade or disable automatic upgrades for the Cloud Assistant Agent.

Contexto

  • Al llamar a una operación de API para ejecutar un comando, puede seleccionar un máximo de 100 instancias. Puede solicitar un aumento en la cuota "Número máximo de instancias compatibles para la ejecución de comandos". Para obtener más información sobre cómo consultar y aumentar las cuotas de recursos, consulte View and increase resource quotas.

  • Si selecciona más de 100 instancias en la consola de ECS, el sistema ejecuta el comando por lotes.

Procedimiento

Ejecutar un comando en la consola de ECS

  1. Vaya a ECS console - Cloud Assistant.

  2. En la esquina superior izquierda de la página, seleccione una región y un resource group.

  3. En la pestaña My Commands, localice el comando de destino y haga clic en Run en la columna Actions.

  4. En el panel Run Command, configure los siguientes parámetros.

    1. En la sección Command Information, verifique el contenido del comando y configure los siguientes parámetros.

      Parámetro

      Descripción

      Command

      Haga clic en View command content para ver el comando.

      Execution Plan

      Seleccione cuándo ejecutar el comando.

      • Immediate execution: Ejecuta el comando inmediatamente.

      • After the next startup of the system: Ejecuta el comando la próxima vez que se inicien las instancias.

      • After each system startup: Ejecuta el comando cada vez que se inician las instancias.

      • Perform Only Dry Run: Valida los parámetros de la solicitud, los entornos de ejecución de las instancias y el estado de Cloud Assistant Agent sin ejecutar el comando.

      • Timing execution: Ejecuta el comando a intervalos fijos, a una hora específica o según una programación cron. Opciones:

        • Run at Fixed Interval: Especifique una expresión de tasa para ejecutar el comando a un intervalo fijo en segundos, minutos, horas o días.

          Nota

          Límites de intervalo:

          • El intervalo oscila entre 60 segundos y 7 días, y debe superar el periodo de tiempo de espera de la tarea programada.

          • El intervalo se mide entre ejecuciones consecutivas, sin incluir el tiempo de ejecución. Por ejemplo, si el intervalo es de 5 minutos y una ejecución tarda 2 minutos, la siguiente comenzará 3 minutos después de que finalice la anterior.

          • La primera ejecución comienza tras completar un intervalo entero. Por ejemplo, una tarea con un intervalo de 5 minutos se ejecuta 5 minutos después de su creación.

        • Run Only Once at Specified Time: Especifique una hora y una zona horaria para ejecutar el comando una sola vez.

          Por ejemplo, si establece Execution Time en May 17, 2022, 17:30:50 y Time Zone en (GMT+08:00) Asia/Shanghai, el comando se ejecutará una vez a las 17:30:50 del 17 de mayo de 2022 (UTC+8).

        • Run on Clock-based Schedule: Utilice una expresión cron para ejecutar el comando según una programación. Especifique la frecuencia con granularidad de segundos, minutos, horas, día del mes, mes, día de la semana o año, y seleccione una zona horaria en la lista desplegable Time Zone. Consulte Cron expressions.

          Nota

          El intervalo mínimo debe ser de al menos 10 segundos y superar el periodo de tiempo de espera de las ejecuciones programadas.

          Por ejemplo, si establece Execution Frequency en 0 0 12 ? * WED 2022 y Time Zone en (GMT+08:00) Asia/Shanghai, el comando se ejecutará a las 12:00:00 todos los miércoles de 2022 (UTC+8).

      Username

      Nombre de usuario para ejecutar el comando en las instancias de ECS.

      Por motivos de seguridad, ejecute los comandos de Cloud Assistant como un usuario estándar siguiendo el principio de menor privilegio. Consulte Run Cloud Assistant commands as a RAM user.

      De forma predeterminada, los comandos se ejecutan como usuario root en Linux y como usuario del sistema en Windows.

      Timeout Period

      Periodo de Timeout Period para ejecutar el comando en las instancias. Si la tarea supera este límite, Cloud Assistant finaliza forzosamente el proceso.

      Unidad: segundos. Valor predeterminado: el Timeout Period especificado para el comando.

      Nota

      Este tiempo de espera aplica únicamente a la tarea del comando. Modificarlo no afecta al tiempo de espera del comando en sí.

      Tag

      Agregue etiquetas a la tarea del comando especificando Tag Key y Value.

    2. En las secciones Select Instances y Select Managed Instances, seleccione las instancias de destino.

      Puede buscar instancias por ID, nombre o etiqueta, y filtrarlas por el estado de Cloud Assistant Agent.

      Nota

      Las instancias administradas son servidores ajenos a Alibaba Cloud gestionados mediante Cloud Assistant. Para obtener más información, consulte Alibaba Cloud managed instances.

  5. Haga clic en Run.

Ejecutar un comando mediante Alibaba Cloud CLI

Antes de usar Alibaba Cloud CLI, instálelo en su computadora. Los métodos de instalación varían según el sistema operativo:

  1. (Opcional) Si la instancia no está en estado Running (Running), llame a StartInstance para iniciarla.

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

    Los valores entre comillas simples ('') son ejemplos. Reemplácelos con sus valores reales.

    Consulte StartInstance.

  2. (Opcional) Llame a DescribeCloudAssistantStatus para comprobar si Cloud Assistant Agent está instalado en las instancias.

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

    Si Cloud Assistant Agent está instalado, CloudAssistantStatus será verdadero en la respuesta. De lo contrario, llame a InstallCloudAssistant para instalarlo. Consulte DescribeCloudAssistantStatus y InstallCloudAssistant.

  3. Llame a InvokeCommand para ejecutar un comando de Cloud Assistant en una o más instancias.

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

    La siguiente tabla describe los parámetros principales. Consulte InvokeCommand.

    Parámetro

    Ejemplo

    Descripción

    RegionId

    cn-hangzhou

    ID de la región.

    InstanceId.1

    i-bp1f4f6o8lv0wqof****

    ID de la primera instancia donde se ejecutará el comando.

    InstanceId.2

    i-bp137qu6142s3mhm****

    ID de la segunda instancia donde se ejecutará el comando.

    CommandId

    c-hz018qp243j****

    ID del comando.