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. # AWS CodePipeline Aktionsreferenz aufrufen Sie verwenden eine CodePipeline Aufrufaktion, um das Auslösen von Downstream-Pipeline-Ausführungen und die Übergabe von Pipeline-Variablen und Quellrevisionen zwischen Pipelines zu vereinfachen. **Anmerkung** Diese Aktion wird nur für Pipelines vom Typ V2 unterstützt. **Topics** + [Aktionstyp](#action-reference-PipelineInvoke-type) + [Konfigurationsparameter](#action-reference-PipelineInvoke-parameters) + [Input artifacts (Eingabeartefakte)](#action-reference-PipelineInvoke-input) + [Ausgabeartefakte](#action-reference-PipelineInvoke-output) + [Berechtigungen für die Aktion zum CodePipeline Aufrufen der Aktion „Dienst“](#action-reference-PipelineInvoke-permissions-action) + [Aktionsdeklaration](#action-reference-PipelineInvoke-example) + [Weitere Informationen finden Sie auch unter](#action-reference-PipelineInvoke-links) ## Aktionstyp + Kategorie: `Invoke` + Eigentümer: `AWS` + Anbieter: `CodePipeline` + Version: `1` ## Konfigurationsparameter **PipelineName** Erforderlich: Ja Der Name der Pipeline, die bei der Ausführung die aktuelle Zielpipeline startet. Sie müssen die aufrufende Pipeline bereits erstellt haben. Die Aktion startet die `s3-pipeline-test` (Ziel-) Pipeline, wenn die angegebene (aufrufende) Pipeline eine Ausführung `my-s3-pipeline` startet. **SourceRevisions** Erforderlich: Nein Die Quellrevisionen, die die Zielpipeline verwenden soll, wenn sie von der aufrufenden Pipeline gestartet wird. Beispielsweise stellt eine S3-Quellaktion Ausgabevariablen wie die S3-Versions-ID und den Objektschlüssel bereit. Sie können einen Revisionswert angeben, der verwendet werden soll, wenn die Pipeline aufgerufen wird. Für die CLI geben Sie Quellrevisionen als serialisierte JSON-Zeichenfolge an. Weitere Informationen zur Verwendung von Quellrevisionsüberschreibungen finden Sie [ SourceRevisionOverride ](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_SourceRevisionOverride.html) im * CodePipeline API-Handbuch. * Das Mapping verwendet ein Zeichenfolgenformat, wie im folgenden Beispiel gezeigt: ``` [{"actionName":"Source","revisionType":"S3_OBJECT_VERSION_ID","revision Value":"zq8mjNEXAMPLE"}] ``` **Variablen** Erforderlich: Nein Die Namen und Werte der Variablen, die die Aktion unterstützen soll. Für die CLI geben Sie Variablen als serialisierte JSON-Zeichenfolge an. Weitere Informationen zur Verwendung von Pipeline-Variablen finden Sie [ PipelineVariable ](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_PipelineVariable.html) im * CodePipeline API-Handbuch*. Das Mapping verwendet ein Zeichenkettenformat, wie im folgenden Beispiel gezeigt: ``` [{"name":"VAR1","value":"VALUE1"}] ``` Die folgende Abbildung zeigt ein Beispiel für die Aktion, die einer Pipeline in der Konsole hinzugefügt wurde. ![Eine Pipeline mit einer S3-Quelle und einer Build-Phase, die die Aktion zum Aufrufen der Pipeline enthält](https://docs.aws.amazon.com/de_de/codepipeline/latest/userguide/images/example-pipeline-invoke-run.png) Die folgende Abbildung zeigt ein Beispiel für die ** Seite ** „Bearbeiten“ für die Aktion. Im folgenden Beispiel ist für die Pipeline mit dem Namen `s3-pipeline-test` eine Aktion zum Aufrufen einer Pipeline konfiguriert, wie für die Konsole gezeigt. Die Aktion startet die `s3-pipeline-test` Pipeline, wenn die angegebene Pipeline eine Ausführung `my-s3-pipeline` abgeschlossen hat. Das Beispiel zeigt, dass die Quellversion für die Quellcodeüberschreibung der S3\_OBJECT\_VERSION\_ID mit dem angegebenen Revisionswert von überschrieben wird. `zq8mjNYEexample` ![Die Aktionsseite „Bearbeiten“ für eine neue Pipeline mit der Aktion zum Aufrufen der Pipeline](https://docs.aws.amazon.com/de_de/codepipeline/latest/userguide/images/example-pipeline-invoke-edit.png) ## Input artifacts (Eingabeartefakte) + **Anzahl der Artefakte: ** `0` + **Beschreibung:** Eingabe-Artefakte sind für diesen Aktionstyp nicht gültig. ## Ausgabeartefakte + **Anzahl der Artefakte: ** `0` + **Beschreibung: ** Ausgabeartefakte gelten nicht für diesen Aktionstyp. ## Berechtigungen für die Aktion zum CodePipeline Aufrufen der Aktion „Dienst“ Wenn die Aktion CodePipeline ausgeführt wird, erfordert die CodePipeline Servicerollenrichtlinie die entsprechende `codepipeline:StartPipelineExecution` Berechtigung, die entsprechend auf den ARN der Pipeline-Ressource heruntergeregelt ist, um den Zugriff mit den geringsten Rechten aufrechtzuerhalten. ``` { "Sid": "StatementForPipelineInvokeAction", "Effect": "Allow", "Action": "codepipeline:StartPipelineExecution", "Resource": [ "arn:aws:codepipeline:{{region}}:{{AccountId}}:{{pipelineName}}" ] } ``` ## Aktionsdeklaration ------ #### [ YAML ] ``` name: Invoke-pipeline actionTypeId: category: Invoke owner: AWS provider: CodePipeline version: '1' runOrder: 2 configuration: PipelineName: my-s3-pipeline SourceRevisions: '[{"actionName":"Source","revisionType":"S3_OBJECT_VERSION_ID","revision Value":"zq8mjNEXAMPLE"}]' Variables: '[{"name":"VAR1","value":"VALUE1"}]' ``` ------ #### [ JSON ] ``` { "name": "Invoke-pipeline", "actionTypeId": { "category": "Invoke", "owner": "AWS", "provider": "CodePipeline", "version": "1" }, "runOrder": 2, "configuration": { "PipelineName": "my-s3-pipeline", "SourceRevisions": "[{\"actionName\":\"Source\",\"revisionType\":\"S3_OBJECT_VERSION_ID\",\"revisionValue\":\"zq8mjNEXAMPLE\"}]", "Variables": "[{\"name\":\"VAR1\",\"value\":\"VALUE1\"}]" } }, ``` ------ ## Weitere Informationen finden Sie auch unter Die folgenden verwandten Ressourcen bieten Ihnen nützliche Informationen für die Arbeit mit dieser Aktion. + [Starten Sie eine Pipeline mit einer Quellrevisionsüberschreibung](pipelines-trigger-source-overrides.md)— In diesem Abschnitt wird beschrieben, wie eine Pipeline mit Quellrevisionen manuell oder über den EventBridge Event-Input-Transformator gestartet wird.