

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Starten Sie eine Pipeline mit einer Quellrevisionsüberschreibung
<a name="pipelines-trigger-source-overrides"></a>

Sie können Overrides verwenden, um eine Pipeline mit einer bestimmten Quellrevisions-ID zu starten, die Sie für die Pipeline-Ausführung angeben. Wenn Sie beispielsweise eine Pipeline starten möchten, die eine bestimmte Commit-ID aus Ihrer CodeCommit Quelle verarbeitet, können Sie die Commit-ID als Override hinzufügen, wenn Sie Ihre Pipeline starten.

**Anmerkung**  
Sie können auch eine Quellüberschreibung mithilfe eines Eingabe-Transformationseintrags erstellen, um das `revisionValue` In EventBridge für Ihr Pipeline-Ereignis zu verwenden, wobei `revisionValue` das von der Quellereignisvariablen für Ihren Objektschlüssel, Ihren Commit oder Ihre Bild-ID abgeleitet wird. Weitere Informationen finden Sie in dem optionalen Schritt für die Eingabe der Eingabetransformation, der in den Verfahren unter [Amazon ECR-Quellaktionen und Ressourcen EventBridge](create-cwe-ecr-source.md)[Herstellen einer Verbindung zu Amazon S3-Quellaktionen mit einer für Ereignisse aktivierten Quelle](create-S3-source-events.md), oder enthalten ist[CodeCommit Quellaktionen und EventBridge](triggering.md).

Es gibt vier Arten der Quellrevision für`revisionType`: 
+ `COMMIT_ID`
+ `IMAGE_DIGEST`
+ `S3_OBJECT_VERSION_ID`
+ `S3_OBJECT_KEY`

**Anmerkung**  
Für die `IMAGE_DIGEST` Typen der Quellversionen `COMMIT_ID` und gilt die Quellrevisions-ID für den gesamten Inhalt des Repositorys in allen Zweigen.

**Anmerkung**  
Bei den Quellrevisionen `S3_OBJECT_VERSION_ID` und `S3_OBJECT_KEY` kann jeder der Typen unabhängig voneinander verwendet werden, oder sie können zusammen verwendet werden, um die Quelle mit einer bestimmten ObjectKey VersionID zu überschreiben. Für `S3_OBJECT_KEY` `AllowOverrideForS3ObjectKey` muss der Konfigurationsparameter auf gesetzt werden. `true` Weitere Informationen zu S3-Quellkonfigurationsparametern finden Sie unter[Konfigurationsparameter](action-reference-S3.md#action-reference-S3-config).

**Topics**
+ [Starten Sie eine Pipeline mit einer Quellrevisionsüberschreibung (Konsole)](#pipelines-trigger-source-overrides-console)
+ [Starten Sie eine Pipeline mit einem Source Revision Override (CLI)](#pipelines-trigger-source-overrides-cli)

## Starten Sie eine Pipeline mit einer Quellrevisionsüberschreibung (Konsole)
<a name="pipelines-trigger-source-overrides-console"></a>

**So starten Sie eine Pipeline und führen die letzte Revision manuell über eine Pipeline aus**

1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die CodePipeline Konsole unter [ http://console.aws.amazon.com/codesuite/codepipeline/home](https://console.aws.amazon.com/codesuite/codepipeline/home).

1. Wählen Sie im Feld **Name** den Namen der Pipeline aus, die Sie starten möchten. 

1. Wählen Sie auf der Seite mit den Pipeline-Details die Option Änderung ** veröffentlichen aus**. Wenn Sie ** Releasewechsel wählen, ** wird das ** Fenster ** Releasewechsel geöffnet. Wählen Sie für ** Quellversion überschreiben den Pfeil**, um das Feld zu erweitern. Geben Sie im Feld ** Quelle ** die Quell-Revision-ID ein. Wenn Ihre Pipeline beispielsweise eine CodeCommit Quelle hat, wählen Sie die Commit-ID aus dem Feld aus, das Sie verwenden möchten.  
![Ein Beispiel für den Bildschirm „Überschreibungen“ in CodePipeline.](https://docs.aws.amazon.com/de_de/codepipeline/latest/userguide/images/overrides.png)

## Starten Sie eine Pipeline mit einem Source Revision Override (CLI)
<a name="pipelines-trigger-source-overrides-cli"></a>

**Um eine Pipeline manuell zu starten und die angegebene Quell-Revisions-ID für ein Artefakt durch eine Pipeline laufen zu lassen**

1. Öffnen Sie ein Terminal (Linux, macOS oder Unix) oder eine Befehlszeile (Windows) und verwenden Sie die, AWS CLI um den **start-pipeline-execution** Befehl auszuführen. Geben Sie dabei den Namen der Pipeline an, die Sie starten möchten. Sie verwenden das **--source-revisions** Argument auch, um die Quell-Revisions-ID anzugeben. Die Quellrevision besteht aus ActionName, RevisionType und RevisionValue. Gültige RevisionType-Werte sind. `COMMIT_ID | IMAGE_DIGEST | S3_OBJECT_VERSION_ID | S3_OBJECT_KEY` 

   Um im folgenden Beispiel mit der Ausführung der angegebenen Änderung über eine Pipeline mit dem Namen zu beginnen**codecommit-pipeline**, gibt der folgende Befehl den Quellaktionsnamen Source, den Revisionstyp und die Commit-ID von `COMMIT_ID` an. `78a25c18755ccac3f2a9eec099dEXAMPLE`

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

1. Zeigen Sie das zurückgegebene Objekt an, um den Erfolg zu überprüfen. Dieser Befehl gibt eine Ausführungs-ID zurück, die in etwa wie folgt aussieht:

   ```
   {
       "pipelineExecutionId": {{"c53dbd42-This-Is-An-Example"}}
   }
   ```
**Anmerkung**  
Nachdem Sie die Pipeline gestartet haben, können Sie ihren Fortschritt in der CodePipeline Konsole oder durch Ausführen des **get-pipeline-state** Befehls überwachen. Weitere Informationen erhalten Sie unter [Pipelines anzeigen (Konsole)](pipelines-view-console.md) und [Anzeigen von der Pipeline-Details und des Verlaufs (CLI)](pipelines-view-cli.md).