ALIYUN::ECS::Command - Criar comandos do Cloud Assistant | ROS - Resource Orchestration Service: Central de Documentação do Alibaba Cloud

Sintaxe

{
  "Type": "ALIYUN::ECS::Command",
  "Properties": {
    "Name": String,
    "WorkingDir": String,
    "CommandContent": String,
    "Timeout": Integer,
    "Type": String,
    "Description": String,
    "EnableParameter": Boolean,
    "Tags": List,
    "Launcher": String
    "ResourceGroupId": String,
    "ContentEncoding": String
  }
}

Propriedades

Propriedade	Tipo	Obrigatória	Editável	Descrição	Restrição
Name	String	Não	Sim	Nome do comando.	De 1 a 128 caracteres. Aceita todos os conjuntos de caracteres.
WorkingDir	String	Não	Sim	Diretório de trabalho do comando na instância ECS.	Valores padrão: Linux: `/root` (diretório home do usuário root). Windows: diretório do processo do Cloud Assistant Agent, como `C:\Windows\System32`. Nota Ao definir um valor diferente do padrão, verifique se o diretório existe na instância.
CommandContent	String	Não	Não	Conteúdo do comando codificado em Base64.	Deve estar codificado em Base64. Tamanho máximo: 18 KB. Para usar parâmetros personalizados, defina `EnableParameter` como true. Parâmetros personalizados usam o formato `{{}}`. O sistema ignora espaços e quebras de linha ao redor dos nomes de parâmetros em `{{}}`. Limite de 20 parâmetros personalizados. Os nomes de parâmetros aceitam apenas `letras, dígitos, hifens (-) e sublinhados (_)`, não diferenciam maiúsculas de minúsculas e não podem usar o prefixo `ACS::` para especificar parâmetros de ambiente não integrados. Comprimento máximo do nome: 64 bytes. É possível especificar parâmetros de ambiente integrados como parâmetros personalizados em um comando. Durante a execução, o Cloud Assistant usa automaticamente os valores dos parâmetros de ambiente correspondentes. Os seguintes parâmetros de ambiente integrados estão disponíveis: `{{ACS::RegionId}}`: ID da região. `{{ACS::AccountId}}`: UID da conta Alibaba Cloud. `{{ACS::InstanceId}}`: ID da instância. Para execução em múltiplas instâncias, requer o Cloud Assistant Agent: Linux: 2.2.3.309 Windows: 2.1.3.309 `{{ACS::InstanceName}}`: nome da instância. Para execução em múltiplas instâncias, requer o Cloud Assistant Agent: Linux: 2.2.3.344 Windows: 2.1.3.344 `{{ACS::InvokeId}}`: ID da tarefa de comando. Para especificar `{{ACS::InvokeId}}` como variável de ambiente integrada, a versão do Cloud Assistant Agent deve ser igual ou superior a: Linux: 2.2.3.309 Windows: 2.1.3.309 `{{ACS::CommandId}}`: ID do comando. Ao chamar a operação RunCommand, requer o Cloud Assistant Agent: Linux: 2.2.3.309 Windows: 2.1.3.309
Launcher	String	Não	Não	Lançador para execução do script.	Tamanho máximo: 1 KB.
Timeout	Integer	Não	Sim	Tempo limite de execução do comando na instância ECS.	Se o comando exceder esse período, o Cloud Assistant Agent encerrará o processo cancelando seu PID. Valor padrão: 60. Unidade: segundos.
Type	String	Sim	Não	Tipo do comando.	Valores válidos: RunBatScript: comando em lote, aplicável a instâncias Windows. RunPowerShellScript: comando PowerShell, aplicável a instâncias Windows. RunShellScript: comando shell, aplicável a instâncias Linux.
Description	String	Não	Sim	Descrição do comando.	De 1 a 512 caracteres. Aceita todos os conjuntos de caracteres.
EnableParameter	Boolean	Não	Não	Indica se o comando usa parâmetros personalizados.	Valores válidos: true false (padrão)
Tags	List	Não	Não	Tags do recurso. Limite: 20.	Para mais informações, consulte Propriedades de Tags.
ContentEncoding	String	Não	Não	Modo de codificação do conteúdo do comando.	Valores válidos: PlainText: sem codificação. Base64 (padrão): codificação Base64. Nota Valores inválidos assumem Base64 como padrão.
ResourceGroupId	String	Não	Sim	ID do grupo de recursos ao qual o comando pertence.	Nenhuma.

Sintaxe de Tags

"Tags": [
  {
    "Key": String,
    "Value": String
  }
]

Propriedades de Tags

Propriedade	Tipo	Obrigatória	Editável	Descrição	Restrição
Key	String	Sim	Não	Chave da tag.	A chave da tag deve ter de 1 a 128 caracteres e não pode conter http:// ou https://. Não pode começar com aliyun ou acs:.
Value	String	Não	Não	Valor da tag.	O valor da tag pode ter até 128 caracteres e não pode conter http:// ou https://. Não pode começar com aliyun ou acs:.

Valores de retorno

Fn::GetAtt

CommandId: ID do comando.

Nota

Execute o comando apenas uma vez. Para mais informações, consulte ALIYUN::ECS::RunCommand.

Exemplos

Formato `YAML`

ROSTemplateFormatVersion: '2015-09-01'
Parameters: {}
Resources:
  Command:
    Type: ALIYUN::ECS::Command
    Properties:
      CommandContent:
        Fn::Base64Encode: |
          #!/bin/bash
          echo "hello" >> /root/test.sh
      Type: RunShellScript
      Name:
        Ref: ALIYUN::StackName
Outputs:
  CommandId:
    Description: The id of command created.
    Value:
      Fn::GetAtt:
        - Command
        - CommandId

Formato `JSON`

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
  },
  "Resources": {
    "Command": {
      "Type": "ALIYUN::ECS::Command",
      "Properties": {
        "CommandContent": {
          "Fn::Base64Encode": "#!/bin/bash\necho \"hello\" >> /root/test.sh\n"
        },
        "Type": "RunShellScript",
        "Name": {
          "Ref": "ALIYUN::StackName"
        }
      }
    }
  },
  "Outputs": {
    "CommandId": {
      "Description": "The id of command created.",
      "Value": {
        "Fn::GetAtt": [
          "Command",
          "CommandId"
        ]
      }
    }
  }
}

Sintaxe

Propriedades

Sintaxe de Tags

Propriedades de Tags

Valores de retorno

Exemplos

Formato YAML

Formato JSON

Formato `YAML`

Formato `JSON`