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á.

# Iniciar um pipeline com uma substituição da revisão de origem
<a name="pipelines-trigger-source-overrides"></a>

É possível usar substituições para iniciar um pipeline com um ID de revisão de origem específico fornecido para a execução do pipeline. Por exemplo, se você quiser iniciar um pipeline que processará uma ID de confirmação específica da sua CodeCommit fonte, você pode adicionar a ID de confirmação como uma substituição ao iniciar seu pipeline.

**nota**  
Você também pode criar uma substituição de origem usando a entrada de transformação de entrada para usar o `revisionValue` in EventBridge para seu evento de pipeline, onde o `revisionValue` é derivado da variável de evento de origem para sua chave de objeto, confirmação ou ID de imagem. Para saber mais, consulte a etapa opcional da entrada da transformação de entrada incluída nos procedimentos em [Recursos e ações de origem do Amazon ECR EventBridge](create-cwe-ecr-source.md), [Conexão a ações de origem do Amazon S3 com uma fonte habilitada para eventos](create-S3-source-events.md) ou [CodeCommit ações de origem e EventBridge](triggering.md).

Há quatro tipos de revisão de origem para `revisionType`: 
+ `COMMIT_ID`
+ `IMAGE_DIGEST`
+ `S3_OBJECT_VERSION_ID`
+ `S3_OBJECT_KEY`

**nota**  
Para os tipos de revisões de origem `COMMIT_ID` e `IMAGE_DIGEST`, o ID de revisão de origem se aplica a todo o conteúdo no repositório, em todas as ramificações.

**nota**  
Para os `S3_OBJECT_KEY` tipos `S3_OBJECT_VERSION_ID` e as revisões da fonte, qualquer um dos tipos pode ser usado de forma independente ou pode ser usado em conjunto para substituir a fonte por um ID de versão específico ObjectKey . Para `S3_OBJECT_KEY`, o parâmetro de configuração `AllowOverrideForS3ObjectKey` precisa ser definido como `true`. Para ter mais informações sobre os parâmetros de configuração de origem do S3, consulte [Parâmetros de configuração](action-reference-S3.md#action-reference-S3-config).

**Topics**
+ [Iniciar um pipeline com uma substituição de revisão de origem (console)](#pipelines-trigger-source-overrides-console)
+ [Iniciar um pipeline com uma substituição da revisão de origem (CLI)](#pipelines-trigger-source-overrides-cli)

## Iniciar um pipeline com uma substituição de revisão de origem (console)
<a name="pipelines-trigger-source-overrides-console"></a>

**Para iniciar manualmente um pipeline e executar a revisão mais recente por meio de um pipeline**

1. Faça login no Console de gerenciamento da AWS e abra o CodePipeline console em [http://console.aws.amazon. com/codesuite/codepipeline/home](https://console.aws.amazon.com/codesuite/codepipeline/home).

1. Em **Name**, escolha o nome do pipeline que você deseja iniciar. 

1. Na página de detalhes do pipeline, escolha **Lançar alteração**. Selecionar **Lançar alteração** abre a janela **Lançar alteração**. Em **Substituição da revisão de origem**, selecione a seta para expandir o campo. Em **Origem**, insira o ID da revisão de origem. Por exemplo, se seu pipeline tiver uma CodeCommit fonte, escolha o ID do commit no campo que você deseja usar.  
![\[Um exemplo da tela de substituições em. CodePipeline\]](http://docs.aws.amazon.com/pt_br/codepipeline/latest/userguide/images/overrides.png)

## Iniciar um pipeline com uma substituição da revisão de origem (CLI)
<a name="pipelines-trigger-source-overrides-cli"></a>

**Como iniciar manualmente um pipeline e executar o ID de revisão de origem especificado para um artefato por meio de um pipeline**

1. Abra um terminal (Linux, macOS ou Unix) ou prompt de comando (Windows) e use a AWS CLI para executar o comando **start-pipeline-execution**, especificando o nome do pipeline que você deseja iniciar. Também é necessário o argumento **--source-revisions** para fornecer o ID da revisão de origem. A revisão de origem é composta por actionName, revisionType e revisionValue. Os valores válidos de revisionType são `COMMIT_ID | IMAGE_DIGEST | S3_OBJECT_VERSION_ID | S3_OBJECT_KEY`. 

   No exemplo a seguir, para começar a executar a alteração especificada por meio de um pipeline chamado **codecommit-pipeline**, o comando a seguir especifica um nome de ação de origem, um tipo de revisão de `COMMIT_ID` e um ID de confirmação de `78a25c18755ccac3f2a9eec099dEXAMPLE`.

   ```
   aws codepipeline start-pipeline-execution --name codecommit-pipeline --source-revisions actionName=Source,revisionType=COMMIT_ID,revisionValue=78a25c18755ccac3f2a9eec099dEXAMPLE --region us-west-1
   ```

1. Para confirmar se tudo deu certo, visualize o objeto retornado. Este comando retorna um ID de execução semelhante a:

   ```
   {
       "pipelineExecutionId": "c53dbd42-This-Is-An-Example"
   }
   ```
**nota**  
Depois de iniciar o pipeline, você pode monitorar seu progresso no CodePipeline console ou executando o **get-pipeline-state** comando. Para obter mais informações, consulte [Visualizar pipelines (console)](pipelines-view-console.md) e [Visualizar detalhes e histórico do pipeline (CLI)](pipelines-view-cli.md).