Todos los productos
Search
Centro de documentos

Elastic Compute Service:Create a command

Última actualización: Sep 02, 2026

Los comandos de Cloud Assistant le permiten ejecutar rápidamente tareas rutinarias en instancias de Elastic Compute Service (ECS), como ejecutar scripts de O&M automatizados, sondear procesos, restablecer contraseñas de usuario, instalar o desinstalar software, actualizar aplicaciones e instalar parches. Un comando puede ser un script de Windows PowerShell, un script Bat de Windows o un script Shell de Linux, y admite parámetros personalizados que le permiten establecer valores de variables.

Límites

Recurso

Límite

Comandos por región

500–50,000 (cuota por cuenta; puede aumentar según el uso de ECS)

Tamaño máximo del script codificado en Base64

18 KB

Para consultar o aumentar su cuota, consulte Manage quotas. Incluya una razón detallada en su solicitud para mejorar las posibilidades de aprobación.

Procedimiento

Crear un comando en la consola de ECS

  1. Vaya a la página de ECS Cloud Assistant.

  2. En la barra de navegación superior, seleccione una región y un resource group.

    Después de asignar el comando a un resource group, puede gestionar los permisos del comando a nivel de resource group. Agregue las directivas de acceso necesarias a ese resource group. Para conocer las directivas de acceso aplicables a los comandos de Cloud Assistant y la autorización de resource group, consulte Cloud Assistant command-specific sample custom policies y Classify resources into resource groups and grant permissions on the resource groups .
  3. En la página ECS Cloud Assistant, haga clic en Create/Run Command.

  4. En la sección Command Information, configure el comando. Command type: Seleccione el tipo que coincida con el sistema operativo de la instancia destino. Command content: Introduzca o pegue el comando. Compruebe la sintaxis, la lógica y el algoritmo antes de guardar. Ejemplo: archivar un archivo en /backup en una instancia Linux:

    • Run at Fixed Interval: Establezca un intervalo (de 60 segundos a 7 días) mediante una expresión de tasa. El intervalo es el tiempo entre ejecuciones consecutivas, no la duración de la ejecución. Por ejemplo, un intervalo de 5 minutos con una ejecución de 2 minutos significa que la siguiente ejecución comienza 3 minutos después de que finalice la anterior. La primera ejecución comienza una vez transcurrido el intervalo desde la creación de la tarea. > Note: El intervalo debe superar el tiempo de espera del comando.

    • Run on Clock-based Schedule Cron Expression: Especifique una expresión cron (con precisión de segundos) y una zona horaria. Intervalo mínimo: 10 segundos (debe superar el tiempo de espera). Ejemplo: 0 0 12 ? * WED 2022 con (GMT+08:00) Asia/Shanghai se ejecuta cada miércoles a las 12:00:00 durante 2022. Consulte Cron expressions.

    Plan de ejecución

    Opción

    Comportamiento

    Precheck only

    Realiza una comprobación previa de la solicitud sin aplicar el comando. Esta comprobación abarca los parámetros de la solicitud, el entorno de ejecución de las instancias y el estado de Cloud Assistant Agent.

    Run on schedule

    Ejecuta el comando como una tarea programada. Consulte las opciones siguientes.

    Otros parámetros

    Parámetro Descripción
    Command Name Nombre del comando.
    Command Description Descripción del propósito del comando.
    Username Usuario del sistema operativo que ejecuta el comando. Valor predeterminado: root (Linux), system (Windows). Utilice los privilegios mínimos necesarios. Consulte Run Cloud Assistant commands as a regular user.
    Execution Path Directorio donde se ejecuta el script en la instancia. Valor predeterminado: /root para Linux y C:\Windows\system32 para Windows. Para garantizar que el script se ejecute en el directorio esperado, agregue un comando cd al inicio del script.
    Timeout Tiempo máximo de ejecución. Valores válidos: de 10 a 86,400 segundos (24 horas). Valor predeterminado: 60 segundos. Un valor inferior a 10 se ajusta automáticamente a 10.
    Modo de finalización de tarea

    Especifica cómo finaliza la tarea cuando la detiene.

    • Script Process: finaliza el proceso del script.

    • Process Tree: finaliza el árbol de procesos, que incluye el proceso del script y todos los procesos secundarios que este genera.

    Command content: puede activar Use Parameters. Tras la codificación en Base64, el contenido del comando no debe exceder los 18 KB si elige Run and Save, o los 24 KB si elige Run.

    Parámetros personalizados: defina parámetros con el formato {{parameter}} y asígneles valores manualmente. Los parámetros personalizados admiten valores dinámicos y le permiten reutilizar un mismo valor en varios lugares.

    Parámetros integrados: Cloud Assistant proporciona parámetros integrados que se sustituyen automáticamente en tiempo de ejecución y no requieren asignación manual, como {{ACS::RegionId}} para el ID de región y {{ACS::InstanceId}} para el ID de instancia.

    #!/bin/bash
    # Example
    # {{name}} is a custom parameter. Assign a value to it after you finish writing the command content.
    echo {{name}}
    
    # {{ACS::RegionId}} is a built-in parameter and needs no manual assignment.
    echo {{ACS::RegionId}}
  5. En Select Instance o Select Managed Instances, seleccione las instancias destino. Puede seleccionar varias instancias, hasta 100 a la vez.

  6. Haga clic en Save.

Crear un comando mediante Alibaba Cloud CLI

Ejemplo de solicitud

Llame a CreateCommand para crear un comando. El siguiente ejemplo crea un comando llamado update que actualiza el sistema operativo en instancias Linux.

aliyun ecs CreateCommand --RegionId 'cn-hangzhou' \
--CommandContent 'eXVtIHVwZGF0ZSAteQ==' \
--Type 'RunShellScript' \
--Name 'update' \
--Description 'update' \
--output cols=CommandId
Reemplace los valores entre comillas simples por sus valores reales.

La siguiente tabla describe los parámetros clave. Para consultar la referencia completa de parámetros, vea CreateCommand.

Parámetro

Ejemplo

Descripción

RegionId

cn-hangzhou

La región.

Name

update

Nombre del comando.

Type

RunShellScript

Tipo de comando: RunShellScript (Shell de Linux), RunBatScript (Bat de Windows) o RunPowerShellScript (PowerShell de Windows).

CommandContent

eXVtIHVwZGF0ZSAteQ==

Contenido del comando codificado en Base64.

Description

update

Descripción del comando.

Ejemplo de respuesta

CommandId
---------
c-hz018qng4on****

Siguientes pasos

Después de crear un comando, puede consultar sus detalles en la pestaña My Commands. Para ejecutar el comando en instancias específicas, consulte Run a command.

Si el comando utiliza parámetros, introduzca los valores correspondientes en la columna Command Parameters al ejecutar el comando.