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 Aufruf-Aktion, um das Auslösen von Downstream-Pipeline-Ausführungen und die Weitergabe 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)
+ [Richtlinienberechtigungen für die Servicerolle für die CodePipeline Aufrufaktion](#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 ihrer 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 genannte (aufrufende) Pipeline eine Ausführung `my-s3-pipeline` startet.
**SourceRevisions**
Erforderlich: Nein
Die Quellversionen, die die Zielpipeline verwenden soll, wenn sie von der aufrufenden Pipeline gestartet wird. Eine S3-Quellaktion stellt beispielsweise 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-Leitfaden.*
Das Mapping verwendet ein Zeichenkettenformat, 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-Leitfaden*.
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 Pipeline-Aufrufaktion beinhaltet\]](http://docs.aws.amazon.com/de_de/codepipeline/latest/userguide/images/example-pipeline-invoke-run.png)
Die folgende Abbildung zeigt ein Beispiel für die **Bearbeitungsseite** für die Aktion. Im folgenden Beispiel ist für die Pipeline mit dem Namen `s3-pipeline-test` eine Pipeline-Aufrufaktion 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 Quellrevisionsüberschreibung für die Quellüberschreibung S3\$1OBJECT\$1VERSION\$1ID mit dem angegebenen Revisionswert von. `zq8mjNYEexample`
![\[Die Aktionsseite „Aktion bearbeiten“ für eine neue Pipeline mit der Aktion „Pipeline aufrufen“\]](http://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.
## Richtlinienberechtigungen für die Servicerolle für die CodePipeline Aufrufaktion
Wenn die Aktion CodePipeline ausgeführt wird, erfordert die CodePipeline Dienstrollenrichtlinie die `codepipeline:StartPipelineExecution` Berechtigung, die entsprechend auf den ARN der Pipeline-Ressource beschränkt 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 Quellversionen manuell oder über den EventBridge Ereigniseingangstransformator gestartet wird.