

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 Quell-Revision-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)[Verbindung zu Amazon S3 S3-Quellaktionen mit einer für Ereignisse aktivierten Quelle herstellen](create-S3-source-events.md), oder enthalten ist[CodeCommit Quellaktionen und EventBridge](triggering.md).

Es gibt vier Arten von Quelltextrevisionen für`revisionType`: 
+ `COMMIT_ID`
+ `IMAGE_DIGEST`
+ `S3_OBJECT_VERSION_ID`
+ `S3_OBJECT_KEY`

**Anmerkung**  
Bei den Quellrevisionen `COMMIT_ID` und den `IMAGE_DIGEST` Typen gilt die Quellrevisions-ID für alle Inhalte im Repository in allen Zweigen.

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

**Topics**
+ [Starten Sie eine Pipeline mit einer Überschreibung der Quellversion (Konsole)](#pipelines-trigger-source-overrides-console)
+ [Starten Sie eine Pipeline mit einer Quellrevisionsüberschreibung (CLI)](#pipelines-trigger-source-overrides-cli)

## Starten Sie eine Pipeline mit einer Überschreibung der Quellversion (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 **Versionsänderung** auswählen, wird das Fenster **Versionsänderung** geöffnet. Wählen Sie für **Quellrevision überschreiben** den Pfeil, um das Feld zu erweitern. Geben Sie im Feld **Quelle** die Quell-Revision-ID ein. Wenn Ihre Pipeline beispielsweise über eine CodeCommit Quelle verfügt, wählen Sie die Commit-ID aus dem Feld aus, das Sie verwenden möchten.  
![\[Ein Beispiel für den Bildschirm „Überschreibungen“ in CodePipeline.\]](http://docs.aws.amazon.com/de_de/codepipeline/latest/userguide/images/overrides.png)

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

**Um eine Pipeline manuell zu starten und die angegebene Quell-Revision-ID für ein Artefakt über eine Pipeline auszuführen**

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-Revision-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 die Ausführung der angegebenen Änderung über eine Pipeline mit dem Namen zu starten**codecommit-pipeline**, gibt der folgende Befehl den Namen der Quellaktion 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).