A Amazon não CodeCatalyst está mais aberta a novos clientes. Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte [Como migrar do CodeCatalyst](migration.md).

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Referência a uma variável predefinida
<a name="workflows-working-with-variables-reference-output-vars"></a>

Você pode referenciar variáveis predefinidas em qualquer ação dentro de um CodeCatalyst fluxo de trabalho da Amazon.

Use as instruções a seguir para referenciar uma variável predefinida em um fluxo de trabalho.

Para ter mais informações sobre variáveis predefinidas, consulte [Usar variáveis predefinidas](workflows-using-predefined-variables.md).

**Pré-requisito**  
Determine o nome da variável predefinida que você deseja referenciar, como `CommitId`. Para obter mais informações, consulte [Determinação de quais variáveis predefinidas seu fluxo de trabalho emite](workflows-working-with-variables-determine-output-vars.md).

------
#### [ Visual ]

*Não disponível. Escolha YAML para visualizar as instruções YAML.*

------
#### [ YAML ]

**Como fazer referência a uma variável predefinida (editor YAML)**

1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Selecione o projeto.

1. No painel de navegação, escolha **CI/CD** e **Fluxos de trabalho**.

1. Selecione o nome do fluxo de trabalho. É possível filtrar pelo nome do repositório ou da ramificação de origem em que o fluxo de trabalho está definido, ou filtrar pelo nome ou o status do fluxo de trabalho.

1. Escolha **Editar**.

1. Selecione **YAML**.

1. Em uma CodeCatalyst ação, adicione a referência de variável predefinida usando a seguinte sintaxe:

   ```
   ${{{action-group-name}}.{{action-name-or-WorkflowSource}}.{{variable-name}}}
   ```

   Substitua:
   + {{action-group-name}}com o nome do grupo de ação.
**nota**  
Você pode omitir {{action-group-name}} se não houver um grupo de ações ou se a variável for produzida por uma ação no mesmo grupo de ações.
   + {{action-name-or-WorkflowSource}}com:

     O nome da ação que gera a variável.

     or

     `WorkflowSource`, se a variável for `BranchName` ou `CommitId`.
   + {{variable-name}}com o nome da variável.

   Por exemplo:

   ```
   MySecondAction:
       Configuration:
         Steps:
           - Run: echo ${MyFirstECSAction.cluster}
   ```

   Outro exemplo:

   ```
   MySecondAction:
       Configuration:
         Steps:
           - Run: echo ${WorkflowSource.CommitId}
   ```

   Para obter mais exemplos, consulte [Exemplos de referência de variáveis predefinidas](workflows-predefined-examples.md). Para ter mais informações, consulte [Definição do YAML do fluxo de trabalho](workflow-reference.md) para sua ação.

1. (Opcional) Selecione **Validar** para validar o código YAML do fluxo de trabalho antes de confirmar.

1. Selecione **Confirmar**, insira uma mensagem de confirmação e escolha **Confirmar** novamente.

------