Variáveis de sistema de automação
Os runbooks do AWS Systems Manager Automation usam as variáveis a seguir. Para obter um exemplo de como essas variáveis são usadas, visualize a origem JSON do runbook AWS-UpdateWindowsAmi
.
Para visualizar a origem JSON do runbook AWS-UpdateWindowsAmi
Abra o console AWS Systems Manager em https://console.aws.amazon.com/systems-manager/
. -
No painel de navegação, escolha Documents.
-
Na lista de documentos, use a barra de pesquisa ou os números à direita da barra de pesquisa para escolher o runbook
AWS-UpdateWindowsAmi
. -
Escolha a guia Conteúdo.
Variáveis do sistema
Runbooks do Automation oferecem suporte para as seguintes variáveis de sistema:
Variável | Detalhes |
---|---|
|
O ID da Conta da AWS do usuário ou do perfil no qual o Automation é executado. |
|
A data (no runtime), no formato aaaa-MM-dd. |
|
A data e a hora (no runtime), no formato aaaa-MM-dd_HH.mm.ss. |
|
A partição na qual o recurso está. Para Regiões da AWS padrão, a partição é |
|
A região em que o runbook é executado. Por exemplo, us-east-2. |
Variáveis de automação
Runbooks do Automation oferecem suporte para as seguintes variáveis de automação:
Variável | Detalhes |
---|---|
|
O identificador exclusivo atribuído à automação atual. Por exemplo, . |
Terminologia
Os termos a seguir descrevem como as variáveis e os parâmetros são resolvidos.
Prazo | Definição | Exemplo |
---|---|---|
ARN constante |
Um nome do recurso da Amazon (ARN) válido sem variáveis. |
|
Parâmetro do runbook |
Um parâmetro definido no nível do runbook (por exemplo, |
|
Variável de sistema |
Uma variável geral substituída no runbook quando uma parte dele é avaliada. |
|
Variável de automação |
Uma variável relativa à execução de automação substituída no runbook quando uma parte dele for avaliada. |
|
Parâmetro do Systems Manager |
Uma variável definida no AWS Systems Manager Parameter Store. Ele não pode ser referenciado diretamente na entrada da etapa. Podem ser necessárias permissões para acessar o parâmetro. |
|
Cenários compatíveis
Cenário | Comentários | Exemplo |
---|---|---|
|
Uma verificação de autorização é realizada para verificar se o usuário de chamada tem permissão para transmitir a |
|
Parâmetro do runbook fornecido para o |
Devem ser definidos na lista de parâmetros do runbook. |
|
Valor fornecido para o parâmetro do runbook no início. |
O cliente fornece o valor a ser usado para um parâmetro. Quaisquer entradas fornecidas na inicialização precisam ser definidas na lista de parâmetros do runbook. |
As entradas para iniciar a execução da automação incluem: |
Parâmetro do Systems Manager referenciado no conteúdo do runbook. |
A variável existe na conta do cliente ou é um parâmetro acessível publicamente, e o |
|
Variável de sistema referenciada na definição de etapa |
Uma variável de sistema é substituída no runbook quando a automação é iniciada. O valor injetado no runbook é relativo a quando ocorre a substituição. Ou seja, o valor de uma variável de tempo injetado na etapa 1 é diferente do valor injetado na etapa 3 devido ao tempo necessário para executar as etapas intermediárias. As variáveis do sistema não precisam ser definidas na lista de parâmetros do runbook. |
|
Variável de automação referenciada na definição de etapa. |
As variáveis de automação não precisam ser definidas na lista de parâmetros do runbook. A única variável de Automação com suporte é automation:EXECUTION_ID. |
|
Consulte a saída da etapa anterior na próxima definição de etapa. |
Este é o redirecionamento de parâmetros. A saída de uma etapa anterior é referenciada usando a sintaxe |
|
Cenários não compatíveis
Cenário | Comentário | Exemplo |
---|---|---|
Parâmetro do Systems Manager fornecido para o |
Sem suporte. |
|
Parâmetro do Systems Manager referenciado diretamente na entrada da etapa. |
Retorna a exceção |
|
Definição de etapa variável |
A definição de uma etapa no runbook é construída por variáveis. |
|
Referência cruzada de parâmetros do runbook |
O usuário fornece um parâmetro de entrada na hora de início, que é uma referência a outro parâmetro no runbook. |
|
Expansão de vários níveis |
O runbook define uma variável que é avaliada como o nome de uma variável. Ela fica dentro dos delimitadores de variáveis (ou seja, {{ }}) e é expandida para o valor dessa variável/parâmetro. |
|
Referenciar a saída de uma etapa do runbook que é um tipo de variável diferente |
O usuário faz referência à saída de uma etapa do runbook anterior em uma etapa subsequente. A saída é um tipo de variável que não atende aos requisitos da ação na etapa subsequente. |
|