Todos os produtos
Search
Central de documentação

Elastic Compute Service:Create a command

Última atualização: Jul 03, 2026

Crie comandos reutilizáveis do Cloud Assistant para automatizar tarefas de O&M em instâncias ECS sem precisar fazer login.

Tipos de comando compatíveis:

SO

Tipos compatíveis

Linux

Shell, Python, Perl

Windows

Bat, PowerShell

Limitações

Recurso

Limite

Comandos por região

500–50.000 (cota por conta; pode aumentar conforme o uso do ECS)

Tamanho máximo do script codificado em Base64

18 KB

Parâmetros personalizados por comando

20

Para visualizar ou aumentar sua cota, consulte Gerenciar cotas. Inclua uma justificativa detalhada na solicitação para aumentar as chances de aprovação.

Pré-requisitos

Verifique os seguintes requisitos:

  • Uma conta Alibaba Cloud com acesso ao ECS.

  • (Opcional) Um grupo de recursos para gerenciar permissões de comando no nível do grupo de recursos com o RAM.

Criar um comando no console ECS

Importante

Não inclua informações confidenciais — como pares AccessKey, senhas ou códigos de autorização — como texto simples nos comandos. Use parâmetros personalizados no formato {{key}} e forneça os valores durante a execução.

  1. Acesse a página do Cloud Assistant do ECS.

  2. Na barra de navegação superior, selecione uma região e um grupo de recursos.

    Os grupos de recursos permitem gerenciar permissões de comando com políticas do RAM. Consulte Exemplos de políticas personalizadas específicas para comandos do Cloud Assistant e Classificar recursos em grupos de recursos e conceder permissões nos grupos de recursos .

    Region

  3. Na página ECS Cloud Assistant, clique em Create/Run Command.

  4. Na seção Command Information, configure o comando. Command type: Selecione o tipo correspondente ao SO da instância de destino. Command content: Insira ou cole o comando. Verifique a sintaxe, a lógica e o algoritmo antes de salvar. Exemplo: arquivar um arquivo em /backup em uma instância Linux:

    • Run at Fixed Interval: Defina um intervalo (de 60 segundos a 7 dias) usando uma expressão de taxa. O intervalo representa o tempo entre execuções consecutivas, não a duração da execução. Por exemplo, um intervalo de 5 minutos com uma execução de 2 minutos significa que a próxima execução começa 3 minutos após o término da anterior. A primeira execução inicia após o intervalo decorrido desde a criação da tarefa. > Note: O intervalo deve ser maior que o tempo limite do comando.

    • Run Only Once at Specified Time: Defina data, hora e fuso horário. Exemplo: May 17, 2022, 17:30:50 com (GMT+08:00) Asia/Shanghai.

    • Run on Clock-based Schedule Cron Expression: Especifique uma expressão cron (com precisão de segundos) e um fuso horário. Intervalo mínimo: 10 segundos (deve exceder o período de tempo limite). Exemplo: 0 0 12 ? * WED 2022 com (GMT+08:00) Asia/Shanghai executa todas as quartas-feiras às 12:00:00 em 2022. Consulte Expressões Cron.

    Requisitos de versão: - {{ACS::InstanceId}} e {{ACS::InstanceName}} : Cada instância de destino deve executar a versão mínima do Cloud Assistant Agent listada acima. - {{ACS::InvokeId}} : Requer a versão mínima do Agent listada acima. - {{ACS::CommandId}} : Ao chamar a API RunCommand , requer a versão mínima do Agent listada acima. Para atualizar, consulte Instalar o Cloud Assistant Agent .

    Command source

    Opção

    Descrição

    Enter Command Content

    Escreva um novo comando.

    Select Saved Command

    Use um comando salvo existente.

    Parâmetro

    Descrição

    Versão mínima do Cloud Assistant Agent

    {{ACS::RegionId}}

    ID da região

    {{ACS::AccountId}}

    UID da conta Alibaba Cloud

    {{ACS::InstanceId}}

    ID da instância

    Linux >= 2.2.3.309, Windows >= 2.1.3.309

    {{ACS::InstanceName}}

    Nome da instância

    Linux >= 2.2.3.344, Windows >= 2.1.3.344

    {{ACS::InvokeId}}

    ID da tarefa de comando

    Linux >= 2.2.3.309, Windows >= 2.1.3.309

    {{ACS::CommandId}}

    ID do comando

    Linux >= 2.2.3.309, Windows >= 2.1.3.309

    Execution plan

    Opção

    Comportamento

    Immediate execution

    Executado ao clicar em Run ou Run and Save.

    After the next startup of the system

    Executado na próxima inicialização das instâncias associadas.

    After each system startup

    Executado sempre que as instâncias associadas forem iniciadas.

    Run on Schedule

    Executado conforme um cronograma definido. Veja as opções abaixo.

    Other parameters

    Parâmetro

    Descrição

    Command Name

    Nome para identificar o comando.

    Command Description

    Descrição da finalidade do comando.

    Username

    Usuário do SO que executará o comando. Padrão: root (Linux), system (Windows). Use os privilégios mínimos necessários. Consulte Executar comandos do Cloud Assistant como um usuário comum.

    Execution Path

    Diretório de trabalho. Padrão: /home (Linux), C:\Windows\system32 (Windows).

    Timeout

    Tempo máximo de execução em segundos. Padrão: 60. Mínimo: 10 (valores inferiores a 10 são ajustados para 10).

    Tag

    Par chave-valor para classificação. A opção Run and Save aplica a tag tanto ao comando quanto à tarefa de execução. A opção Run aplica a tag apenas ao comando.

    #!/bin/bash
    OF=/backup/my-backup-$(date +%Y%m%d).tgz
    tar -cf $OF {{file}}

    {{file}} é um parâmetro personalizado. Defina-o durante a execução (por exemplo, /app/usrcredential). Consulte Visualizar as configurações do sistema das instâncias ECS. Use parameters: Ative Use Parameters para definir parâmetros personalizados no formato {{key}}. São permitidos até 20 parâmetros personalizados por comando. O Cloud Assistant também fornece parâmetros de ambiente integrados resolvidos em tempo de execução. Opções de Run on Schedule:

  5. Em Select Instance e Select Managed Instances, selecione as instâncias de destino.

    Uma instância gerenciada é um servidor não-ECS administrado pelo Cloud Assistant. Consulte Instâncias gerenciadas pela Alibaba Cloud .
  6. Clique em Save.

Criar um comando usando a Alibaba Cloud CLI

Chame CreateCommand para criar um comando. O exemplo a seguir cria um comando chamado update que atualiza o SO em instâncias Linux.

aliyun ecs CreateCommand --RegionId 'cn-hangzhou' \
--CommandContent 'eXVtIHVwZGF0ZSAteQ==' \
--Type 'RunShellScript' \
--Name 'update' \
--Description 'update' \
--output cols=CommandId
Substitua os valores entre aspas simples pelos seus valores reais.

Principais parâmetros:

Parâmetro

Exemplo

Descrição

RegionId

cn-hangzhou

A região.

Name

update

O nome do comando.

Type

RunShellScript

O tipo de comando: RunShellScript (Linux Shell), RunBatScript (Windows Bat) ou RunPowerShellScript (Windows PowerShell).

CommandContent

eXVtIHVwZGF0ZSAteQ==

O conteúdo do comando codificado em Base64.

Description

update

A descrição do comando.

Para a referência completa de parâmetros, consulte CreateCommand.

Resposta de exemplo:

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

Próximos passos

Após criar um comando, visualize-o na aba My Commands. Para executá-lo em instâncias específicas, consulte Executar um comando.

Se você ativou a opção Use Parameters , insira os valores dos parâmetros em Command Parameters ao executar o comando.