Amazon CodeCatalyst ist nicht mehr offen für Neukunden. Bestandskunden können den Service weiterhin wie gewohnt nutzen. Weitere Informationen finden Sie unter [Wie migriert man von CodeCatalyst](migration.md).
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.
# Aufrufen einer Lambda-Funktion mithilfe eines Workflows
In diesem Abschnitt wird beschrieben, wie eine AWS Lambda Funktion mithilfe eines Workflows aufgerufen wird. CodeCatalyst Um dies zu erreichen, müssen Sie die **AWS Lambda Aufrufaktion zu** Ihrem Workflow hinzufügen. Die **AWS Lambda Aufruf-Aktion** ruft die Lambda-Funktion auf, die Sie angeben.
**[Die Aufruf-Aktion ruft nicht nur Ihre Funktion auf, sondern konvertiert auch jeden Schlüssel der AWS Lambda obersten Ebene in der Antwortnutzlast, die von der Lambda-Funktion empfangen wurde, in eine Workflow-Ausgabevariable.](workflows-working-with-variables.md)** Auf diese Variablen kann dann in nachfolgenden Workflow-Aktionen verwiesen werden. Wenn Sie nicht möchten, dass alle Schlüssel der obersten Ebene in Variablen umgewandelt werden, können Sie Filter verwenden, um die genauen Schlüssel anzugeben. Weitere Informationen finden Sie in der Beschreibung der [ResponseFilters](lam-invoke-action-ref.md#lam.invoke.response.filters) [Aktion 'AWS Lambda aufrufen' YAML](lam-invoke-action-ref.md) Immobilie.
**Topics**
+ [Wann sollte diese Aktion verwendet werden](#lam-invoke-action-when-to-use)
+ [Runtime-Image, das von der Aktion „Aufrufen“ verwendet wird AWS Lambda](#lam-invoke-action-runtime)
+ [Beispiel: Eine Lambda-Funktion aufrufen](lam-invoke-action-example-workflow.md)
+ [Aktion „AWS Lambda Aufrufen“ hinzufügen](lam-invoke-action-add.md)
+ [Variablen 'AWS Lambda aufrufen'](lam-invoke-action-variables.md)
+ [Aktion 'AWS Lambda aufrufen' YAML](lam-invoke-action-ref.md)
## Wann sollte diese Aktion verwendet werden
Verwenden Sie diese Aktion, wenn Sie Ihrem Workflow Funktionen hinzufügen möchten, die in einer Lambda-Funktion gekapselt sind und von dieser ausgeführt werden.
Beispielsweise möchtest du vielleicht, dass dein Workflow eine `Build started` Benachrichtigung an einen Slack-Channel sendet, bevor du einen Build deiner Anwendung startest. In diesem Fall würde dein Workflow eine **AWS Lambda Aufrufaktion zum Aufrufen** eines Lambdas zum Versenden der Slack-Benachrichtigung und eine [Build-Aktion](build-add-action.md) zum Erstellen deiner Anwendung beinhalten.
Als weiteres Beispiel könnten Sie möchten, dass Ihr Workflow einen Schwachstellenscan Ihrer Anwendung durchführt, bevor sie bereitgestellt wird. In diesem Fall würden Sie eine Build-Aktion verwenden, um Ihre Anwendung zu erstellen, eine **AWS Lambda Aufruf-Aktion**, um ein Lambda aufzurufen, um nach Sicherheitslücken zu suchen, und eine Bereitstellungsaktion, um die gescannte Anwendung bereitzustellen.
## Runtime-Image, das von der Aktion „Aufrufen“ verwendet wird AWS Lambda
Die **AWS Lambda Aufruf-Aktion** wird auf einem Image [vom November 2022](build-images.md#build.previous-image) ausgeführt. Weitere Informationen finden Sie unter [Aktive Bilder](build-images.md#build-curated-images).
# Beispiel: Eine Lambda-Funktion aufrufen
Der folgende Beispiel-Workflow umfasst die Aktion „**AWS Lambda Aufrufen**“ zusammen mit einer Aktion „Bereitstellen“. Der Workflow sendet eine Slack-Benachrichtigung, die angibt, dass eine Bereitstellung gestartet wurde, und stellt dann AWS mithilfe einer Vorlage eine Anwendung bereit. CloudFormation Der Workflow besteht aus den folgenden Bausteinen, die nacheinander ausgeführt werden:
+ Ein **Trigger** — Dieser Trigger startet die Workflow-Ausführung automatisch, wenn Sie eine Änderung an Ihr Quell-Repository übertragen. Weitere Informationen zu Auslösern finden Sie unter [Automatisches Starten einer Workflow-Ausführung mithilfe von Triggern](workflows-add-trigger.md).
+ Eine **AWS Lambda Aufrufaktion** (`LambdaNotify`) — Beim Auslösen ruft diese Aktion die `Notify-Start` Lambda-Funktion im angegebenen AWS Konto und in der angegebenen Region (`my-aws-account`, und) auf. `us-west-2` Beim Aufruf sendet die Lambda-Funktion eine Slack-Benachrichtigung, die darauf hinweist, dass ein Deployment gestartet wurde.
+ Eine ** CloudFormation Stack-Aktion bereitstellen** (`Deploy`) — Nach Abschluss der Aufruf-Aktion führt **AWS Lambda die Stack-Aktion** **Deploy die Vorlage (`cfn-template.yml`) aus, um deinen CloudFormation Anwendungsstapel** bereitzustellen. Weitere Informationen zur Aktion ** CloudFormation Stack bereitstellen** finden Sie unter[Einen CloudFormation Stack bereitstellen](deploy-action-cfn.md).
**Anmerkung**
Das folgende Workflow-Beispiel dient der Veranschaulichung und funktioniert ohne zusätzliche Konfiguration nicht.
**Anmerkung**
Im folgenden YAML-Code können Sie die `Connections:` Abschnitte weglassen, wenn Sie möchten. **Wenn Sie diese Abschnitte weglassen, müssen Sie sicherstellen, dass die im Feld **Standard-IAM-Rolle** angegebene Rolle in Ihrer Umgebung die Berechtigungen und Vertrauensrichtlinien enthält, die für die Stack-Aktionen **AWS Lambda Invoke** und Deploy erforderlich sind. CloudFormation ** Weitere Informationen zum Einrichten einer Umgebung mit einer Standard-IAM-Rolle finden Sie unter. [Erstellen einer Umgebung](deploy-environments-creating-environment.md) Weitere Informationen zu den Berechtigungen und Vertrauensrichtlinien, die für die ** CloudFormation Stack-Aktionen „**AWS Lambda Aufrufen**“ und „Bereitstellen**“ erforderlich sind, finden Sie in der Beschreibung der `Role` Eigenschaft im Dokument und. [Aktion 'AWS Lambda aufrufen' YAML](lam-invoke-action-ref.md) [Aktion CloudFormation 'Stack bereitstellen' YAML](deploy-action-ref-cfn.md)
```
Name: codecatalyst-lamda-invoke-workflow
SchemaVersion: 1.0
Triggers:
- Type: PUSH
Branches:
- main
Actions:
LambdaNotify:
Identifier: aws/lambda-invoke@v1
Environment:
Name: my-production-environment
Connections:
- Name: my-aws-account
Role: codecatalyst-lambda-invoke-role
Inputs:
Sources:
- WorkflowSource
Configuration:
Function: Notify-Start
AWSRegion: us-west-2
Deploy:
Identifier: aws/cfn-deploy@v1
Environment:
Name: my-production-environment
Connections:
- Name: my-aws-account
Role: codecatalyst-deploy-role
Inputs:
Sources:
- WorkflowSource
Configuration:
name: my-application-stack
region: us-west-2
role-arn: arn:aws:iam::111122223333:role/StackRole
template: ./cfn-template.yml
capabilities: CAPABILITY_IAM,CAPABILITY_AUTO_EXPAND
```
# Aktion „AWS Lambda Aufrufen“ hinzufügen
Verwenden Sie die folgenden Anweisungen, um die **AWS Lambda Aufrufaktion zu Ihrem Workflow hinzuzufügen.**
**Voraussetzung**
Bevor Sie beginnen, stellen Sie sicher, dass Ihre AWS Lambda Funktion und die zugehörige Lambda-Ausführungsrolle bereit und verfügbar sind. AWS Weitere Informationen finden Sie im Thema [Lambda-Ausführungsrolle](https://docs.aws.amazon.com/lambda/latest/dg/lambda-intro-execution-role.html) im *AWS Lambda Developer Guide*.
------
#### [ Visual ]
**So fügen Sie die Aktion „AWS Lambda Aufrufen“ mit dem visuellen Editor hinzu**
1. [Öffnen Sie die CodeCatalyst Konsole unter https://codecatalyst.aws/.](https://codecatalyst.aws/)
1. Wählen Sie Ihr Projekt.
1. **Wählen Sie im Navigationsbereich **CI/CD** und dann Workflows aus.**
1. Wählen Sie den Namen Ihres Workflows. Sie können nach dem Quell-Repository oder dem Branch-Namen filtern, in dem der Workflow definiert ist, oder nach Workflow-Namen oder -Status filtern.
1. Wählen Sie **Bearbeiten** aus.
1. Wählen Sie **Visual**.
1. Wählen Sie oben links **\$1 Aktionen**, um den Aktionskatalog zu öffnen.
1. Wählen Sie in der Drop-down-Liste **Amazon** aus CodeCatalyst.
1. Suchen Sie nach der **AWS Lambda Aufrufaktion** und führen Sie einen der folgenden Schritte aus:
+ Wählen Sie das Pluszeichen (**\$1**), um die Aktion zum Workflow-Diagramm hinzuzufügen und den zugehörigen Konfigurationsbereich zu öffnen.
Oder
+ Wählen Sie **AWS Lambda Aufrufen**. Das Dialogfeld mit den Aktionsdetails wird angezeigt. In diesem Dialogfeld:
+ (Optional) Wählen Sie „**Quelltext** [anzeigen“, um den Quellcode der Aktion](workflows-view-source.md#workflows-view-source.title) anzuzeigen.
+ Wählen Sie **Zum Workflow** hinzufügen, um die Aktion zum Workflow-Diagramm hinzuzufügen und den zugehörigen Konfigurationsbereich zu öffnen.
1. Füllen Sie auf den Registerkarten **Eingaben**, **Konfiguration** und **Ausgaben** die Felder nach Ihren Bedürfnissen aus. Eine Beschreibung der einzelnen Felder finden Sie unter[Aktion 'AWS Lambda aufrufen' YAML](lam-invoke-action-ref.md). Diese Referenz enthält detaillierte Informationen zu jedem Feld (und dem entsprechenden YAML-Eigenschaftswert), wie es sowohl im YAML- als auch im visuellen Editor angezeigt wird.
1. (Optional) Wählen Sie „**Validieren**“, um den YAML-Code des Workflows vor dem Commit zu überprüfen.
1. Wählen Sie **Commit**, geben Sie eine Commit-Nachricht ein und wählen Sie erneut **Commit**.
------
#### [ YAML ]
**Um die Aktion „AWS Lambda Aufrufen“ mit dem YAML-Editor hinzuzufügen**
1. [Öffnen Sie die CodeCatalyst Konsole unter https://codecatalyst.aws/.](https://codecatalyst.aws/)
1. Wählen Sie Ihr Projekt.
1. **Wählen Sie im Navigationsbereich **CI/CD** und dann Workflows aus.**
1. Wählen Sie den Namen Ihres Workflows. Sie können nach dem Quell-Repository oder dem Branch-Namen filtern, in dem der Workflow definiert ist, oder nach Workflow-Namen oder -Status filtern.
1. Wählen Sie **Bearbeiten** aus.
1. Wählen Sie **YAML.**
1. Wählen Sie links oben **\$1 Aktionen, um den Aktionskatalog** zu öffnen.
1. Wählen Sie in der Drop-down-Liste **Amazon** aus CodeCatalyst.
1. Suchen Sie nach der **AWS Lambda Aufrufaktion** und führen Sie einen der folgenden Schritte aus:
+ Wählen Sie das Pluszeichen (**\$1**), um die Aktion zum Workflow-Diagramm hinzuzufügen und den zugehörigen Konfigurationsbereich zu öffnen.
Oder
+ Wählen Sie **AWS Lambda Aufrufen**. Das Dialogfeld mit den Aktionsdetails wird angezeigt. In diesem Dialogfeld:
+ (Optional) Wählen Sie „**Quelltext** [anzeigen“, um den Quellcode der Aktion](workflows-view-source.md#workflows-view-source.title) anzuzeigen.
+ Wählen Sie **Zum Workflow** hinzufügen, um die Aktion zum Workflow-Diagramm hinzuzufügen und den zugehörigen Konfigurationsbereich zu öffnen.
1. Ändern Sie die Eigenschaften im YAML-Code nach Ihren Bedürfnissen. Eine Erläuterung der einzelnen verfügbaren Eigenschaften finden Sie in der[Aktion 'AWS Lambda aufrufen' YAML](lam-invoke-action-ref.md).
1. (Optional) Wählen Sie „**Validieren**“, um den YAML-Code des Workflows vor dem Commit zu überprüfen.
1. Wählen Sie **Commit**, geben Sie eine Commit-Nachricht ein und wählen Sie erneut **Commit**.
------
# Variablen 'AWS Lambda aufrufen'
Standardmäßig erzeugt die **AWS Lambda Aufrufaktion** eine Variable pro Schlüssel der obersten Ebene in der Lambda-Antwortnutzlast.
Wenn die Antwortnutzlast beispielsweise wie folgt aussieht:
```
responsePayload = {
"name": "Saanvi",
"location": "Seattle",
"department": {
"company": "Amazon",
"team": "AWS"
}
}
```
... dann würde die Aktion die folgenden Variablen generieren.
| Key (Schlüssel) | Value (Wert) |
| --- | --- |
| Name | Saanvi |
| location | Seattle |
| Abteilung | \$1"Firma“: „Amazon“, „Team“: "AWS„\$1 |
**Anmerkung**
Sie können mithilfe der `ResponseFilters` YAML-Eigenschaft ändern, welche Variablen generiert werden. Weitere Informationen finden Sie unter [ResponseFilters](lam-invoke-action-ref.md#lam.invoke.response.filters) im [Aktion 'AWS Lambda aufrufen' YAML](lam-invoke-action-ref.md).
*Die Variablen, die von der Aktion „AWS Lambda Aufrufen“ zur Laufzeit erzeugt und gesetzt werden, werden als vordefinierte Variablen bezeichnet.*
Hinweise zum Verweisen auf diese Variablen in einem Workflow finden Sie unter. [Verwenden vordefinierter Variablen](workflows-using-predefined-variables.md)
# Aktion 'AWS Lambda aufrufen' YAML
**Im Folgenden finden Sie die YAML-Definition der Aufruf-Aktion.AWS Lambda ** Informationen zur Verwendung dieser Aktion finden Sie unter. [Aufrufen einer Lambda-Funktion mithilfe eines Workflows](lam-invoke-action.md)
Diese Aktionsdefinition ist als Abschnitt in einer umfassenderen Workflow-Definitionsdatei vorhanden. Weitere Informationen über diese Datei finden Sie unter [YAML-Workflow-Definition](workflow-reference.md).
**Anmerkung**
Die meisten der folgenden YAML-Eigenschaften haben entsprechende Benutzeroberflächenelemente im visuellen Editor. Verwenden Sie **Strg\$1F**, um nach einem UI-Element zu suchen. Das Element wird mit der zugehörigen YAML-Eigenschaft aufgelistet.
```
# The workflow definition starts here.
# See Eigenschaften der obersten Ebene for details.
Name: MyWorkflow
SchemaVersion: 1.0
Actions:
# The action definition starts here.
LambdaInvoke\$1nn:
Identifier: aws/lambda-invoke@v1
DependsOn:
- dependent-action
Compute:
Type: EC2 | Lambda
Fleet: fleet-name
Timeout: timeout-minutes
Inputs:
# Specify a source or an artifact, but not both.
Sources:
- source-name-1
Artifacts:
- request-payload
Variables:
- Name: variable-name-1
Value: variable-value-1
- Name: variable-name-2
Value: variable-value-2
Environment:
Name: environment-name
Connections:
- Name: account-connection-name
Role: iam-role-name
Configuration:
Function: my-function|function-arn
AWSRegion: us-west-2
# Specify RequestPayload or RequestPayloadFile, but not both.
RequestPayload: '{"firstname": "Li", lastname: "Jean", "company": "ExampleCo", "team": "Development"}'
RequestPayloadFile: my/request-payload.json
ContinueOnError: true|false
LogType: Tail|None
ResponseFilters: '{"name": ".name", "company": ".department.company"}'
Outputs:
Artifacts:
- Name: lambda_artifacts
Files:
- "lambda-response.json"
```
## LambdaInvoke
(Erforderlich)
Geben Sie den Namen der Aktion an. Alle Aktionsnamen müssen innerhalb des Workflows eindeutig sein. Aktionsnamen sind auf alphanumerische Zeichen (a-z, A-Z, 0-9), Bindestriche (-) und Unterstriche (\$1) beschränkt. Leerzeichen sind nicht erlaubt. Sie können keine Anführungszeichen verwenden, um Sonderzeichen und Leerzeichen in Aktionsnamen zuzulassen.
Standard: `Lambda_Invoke_Action_Workflow_nn`.
Entsprechende Benutzeroberfläche: Registerkarte „**Konfiguration/Aktionsname“**
## Identifier
(*LambdaInvoke*/**Identifier**)
(Erforderlich)
Identifiziert die Aktion. Ändern Sie diese Eigenschaft nur, wenn Sie die Version ändern möchten. Weitere Informationen finden Sie unter [Angabe der zu verwendenden Aktionsversion](workflows-action-versions.md).
Standard: `aws/lambda-invoke@v1`.
**Entsprechende Benutzeroberfläche: Workflow-Diagram/ LambdaInvoke \$1nn/ aws/lambda-invoke @v1 label**
## DependsOn
(*LambdaInvoke*/**DependsOn**)
(Optional)
Geben Sie eine Aktion, eine Aktionsgruppe oder ein Gate an, die erfolgreich ausgeführt werden müssen, damit diese Aktion ausgeführt werden kann.
Weitere Hinweise zur Funktion „Hängt davon ab“ finden Sie unter. [Aktionen sequenzieren](workflows-depends-on.md)
Entsprechende Benutzeroberfläche: Registerkarte „Eingaben“/„**Hängt davon ab**“ — optional
## Compute
(*LambdaInvoke*/**Compute**)
(Optional)
Die Rechen-Engine, mit der Ihre Workflow-Aktionen ausgeführt wurden. Sie können die Berechnung entweder auf Workflow-Ebene oder auf Aktionsebene angeben, aber nicht beide. Wenn auf Workflow-Ebene angegeben, gilt die Rechenkonfiguration für alle im Workflow definierten Aktionen. Auf Workflow-Ebene können Sie auch mehrere Aktionen auf derselben Instanz ausführen. Weitere Informationen finden Sie unter [Rechenleistung für mehrere Aktionen gemeinsam nutzen](compute-sharing.md).
Entsprechende Benutzeroberfläche: *keine*
## Type
(*LambdaInvoke*/Compute/**Type**)
(Erforderlich, wenn [Compute](#lam.invoke.computename) es enthalten ist)
Der Typ der Compute Engine. Sie können einen der folgenden Werte verwenden:
+ **EC2**(visueller Editor) oder `EC2` (YAML-Editor)
Optimiert für Flexibilität bei Aktionsläufen.
+ **Lambda** (visueller Editor) oder `Lambda` (YAML-Editor)
Optimierte Startgeschwindigkeiten für Aktionen.
Weitere Informationen zu Datentypen finden Sie unter [Berechnungstypen](workflows-working-compute.md#compute.types).
Entsprechende Benutzeroberfläche: Registerkarte „**Konfiguration/Berechnungstyp**“
## Fleet
(*LambdaInvoke*/Compute/**Fleet**)
(Optional)
Geben Sie die Maschine oder Flotte an, auf der Ihr Workflow oder Ihre Workflow-Aktionen ausgeführt werden sollen. Bei bedarfsgesteuerten Flotten stellt der Workflow zu Beginn einer Aktion die benötigten Ressourcen bereit, und die Maschinen werden zerstört, wenn die Aktion abgeschlossen ist. Beispiele für Flotten auf Abruf:`Linux.x86-64.Large`,. `Linux.x86-64.XLarge` Weitere Informationen zu Flotten auf Abruf finden Sie unter. [Eigenschaften von On-Demand-Flotten](workflows-working-compute.md#compute.on-demand)
Bei bereitgestellten Flotten konfigurieren Sie eine Reihe von dedizierten Maschinen, um Ihre Workflow-Aktionen auszuführen. Diese Maschinen bleiben im Leerlauf und sind bereit, Aktionen sofort zu verarbeiten. Weitere Informationen zu bereitgestellten Flotten finden Sie unter. [Eigenschaften von bereitgestellten Flotten](workflows-working-compute.md#compute.provisioned-fleets)
Wenn `Fleet` es weggelassen wird, ist die Standardeinstellung. `Linux.x86-64.Large`
Entsprechende Benutzeroberfläche: Registerkarte „Konfiguration“/„Flotte **berechnen**“
## Timeout
(*LambdaInvoke*/**Timeout**)
(Erforderlich)
Geben Sie an, wie lange die Aktion in Minuten (YAML-Editor) oder Stunden und Minuten (visueller Editor) ausgeführt werden kann, bevor die Aktion CodeCatalyst beendet wird. Das Minimum beträgt 5 Minuten und das Maximum ist unter beschrieben[Kontingente für Workflows in CodeCatalyst](workflows-quotas.md). Das Standard-Timeout entspricht dem maximalen Timeout.
**Entsprechende Benutzeroberfläche: Registerkarte „Konfiguration/Timeout“ — optional**
## Inputs
(*LambdaInvoke*/**Inputs**)
(Erforderlich)
Der `Inputs` Abschnitt definiert die Daten, die die **AWS Lambda Aufrufaktion während** einer Workflow-Ausführung benötigt.
**Anmerkung**
Pro **AWS Lambda Aufrufaktion** ist nur eine Eingabe (entweder eine Quelle oder ein Artefakt) zulässig. Variablen werden auf diese Summe nicht angerechnet.
Entsprechende Benutzeroberfläche: Registerkarte „**Eingaben**“
## Sources
(*LambdaInvoke*/Inputs/**Sources**)
([RequestPayloadFile](#lam.invoke.request.payload.file)Erforderlich, falls angegeben)
Wenn Sie eine JSON-Datei mit Anforderungs-Payload an die **AWS Lambda Aufruf-Aktion** übergeben möchten und diese Payload-Datei in einem Quell-Repository gespeichert ist, geben Sie das Label dieses Quell-Repositorys an. Derzeit ist das einzige unterstützte Label. `WorkflowSource`
Wenn Ihre Anforderungs-Payload-Datei nicht in einem Quell-Repository enthalten ist, muss sie sich in einem Artefakt befinden, das durch eine andere Aktion generiert wurde.
Weitere Hinweise zur Payload-Datei finden Sie unter. [RequestPayloadFile](#lam.invoke.request.payload.file)
**Anmerkung**
Anstatt eine Payload-Datei anzugeben, können Sie den JSON-Code der Payload mithilfe der Eigenschaft direkt zur Aktion hinzufügen. `RequestPayload` Weitere Informationen finden Sie unter [RequestPayload](#lam.invoke.request.payload).
Weitere Informationen zu Quellen finden Sie unter [Quell-Repositorys mit Workflows verbinden](workflows-sources.md).
**Entsprechende Benutzeroberfläche: Registerkarte „Eingaben“/„Quellen“ — optional**
## Artifacts - input
(*LambdaInvoke*/Inputs/**Artifacts**)
(Erforderlich, falls [RequestPayloadFile](#lam.invoke.request.payload.file)angegeben)
Wenn Sie eine JSON-Datei mit Anforderungs-Payload an die **AWS Lambda Aufruf-Aktion übergeben möchten und diese Payload-Datei in einem Ausgabeartefakt** [einer vorherigen Aktion enthalten ist, geben Sie dieses Artefakt](build-action-ref.md#build.outputs.artifacts) hier an.
Weitere Hinweise zur Payload-Datei finden Sie unter. [RequestPayloadFile](#lam.invoke.request.payload.file)
**Anmerkung**
Anstatt eine Payload-Datei anzugeben, können Sie den JSON-Code der Payload mithilfe der Eigenschaft direkt zur Aktion hinzufügen. `RequestPayload` Weitere Informationen finden Sie unter [RequestPayload](#lam.invoke.request.payload).
Weitere Informationen zu Artefakten, einschließlich Beispielen, finden Sie unter. [Artefakte und Dateien zwischen Aktionen teilen](workflows-working-artifacts.md)
Entsprechende Benutzeroberfläche: Registerkarte „Konfiguration“/„**Artefakte“ — optional**
## Variables - input
(*LambdaInvoke*/Inputs/**Variables**)
(Optional)
Geben Sie eine Sequenz von name/value Paaren an, die die Eingabevariablen definieren, die Sie für die Aktion verfügbar machen möchten. Variablennamen sind auf alphanumerische Zeichen (a-z, A-Z, 0-9), Bindestriche (-) und Unterstriche (\$1) beschränkt. Leerzeichen sind nicht erlaubt. Sie können keine Anführungszeichen verwenden, um Sonderzeichen und Leerzeichen in Variablennamen zuzulassen.
Weitere Informationen zu Variablen, einschließlich Beispielen, finden Sie unter[Verwenden von Variablen in Workflows](workflows-working-with-variables.md).
Entsprechende Benutzeroberfläche: Registerkarte „Eingaben“/„**Variablen“ — optional**
## Environment
(*LambdaInvoke*/**Environment**)
(Erforderlich)
Geben Sie die CodeCatalyst Umgebung an, die für die Aktion verwendet werden soll. Die Aktion stellt eine Verbindung mit der AWS-Konto optionalen Amazon VPC her, die in der ausgewählten Umgebung angegeben ist. Die Aktion verwendet die in der Umgebung angegebene Standard-IAM-Rolle, um sich mit der Amazon VPC zu verbinden AWS-Konto, und verwendet die in der [Amazon VPC-Verbindung angegebene IAM-Rolle, um eine Verbindung zur Amazon VPC](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-vpcs.add.html) herzustellen.
**Anmerkung**
Wenn die Standard-IAM-Rolle nicht über die für die Aktion erforderlichen Berechtigungen verfügt, können Sie die Aktion so konfigurieren, dass sie eine andere Rolle verwendet. Weitere Informationen finden Sie unter [Die IAM-Rolle einer Aktion ändern](deploy-environments-switch-role.md).
Weitere Informationen zu Umgebungen finden Sie unter [Einsatz in AWS-Konten und VPCs](deploy-environments.md) und[Erstellen einer Umgebung](deploy-environments-creating-environment.md).
**Entsprechende Benutzeroberfläche: Registerkarte „Konfiguration/Umgebung“**
## Name
(*LambdaInvoke*/Environment/**Name**)
(Erforderlich, falls [Environment](#lam.invoke.environment) enthalten)
Geben Sie den Namen einer vorhandenen Umgebung an, die Sie der Aktion zuordnen möchten.
**Entsprechende Benutzeroberfläche: Registerkarte „Konfiguration/Umgebung“**
## Connections
(*LambdaInvoke*/Environment/**Connections**)
(Optional in neueren Versionen der Aktion; in älteren Versionen erforderlich)
Geben Sie die Kontoverbindung an, die der Aktion zugeordnet werden soll. Sie können unter maximal eine Kontoverbindung angeben`Environment`.
Wenn Sie keine Kontoverbindung angeben:
+ Die Aktion verwendet die AWS-Konto Verbindung und die Standard-IAM-Rolle, die in der Umgebung in der CodeCatalyst Konsole angegeben sind. Informationen zum Hinzufügen einer Kontoverbindung und einer Standard-IAM-Rolle zur Umgebung finden Sie unter. [Erstellen einer Umgebung](deploy-environments-creating-environment.md)
+ Die Standard-IAM-Rolle muss die Richtlinien und Berechtigungen enthalten, die für die Aktion erforderlich sind. **Informationen zu diesen Richtlinien und Berechtigungen finden Sie in der Beschreibung der Role-Eigenschaft in der YAML-Definitionsdokumentation der Aktion.**
Weitere Informationen zu Kontoverbindungen finden Sie unter[Ermöglichen des Zugriffs auf AWS Ressourcen mit verbundenen AWS-Konten](ipa-connect-account.md). Hinweise zum Hinzufügen einer Kontoverbindung zu einer Umgebung finden Sie unter[Erstellen einer Umgebung](deploy-environments-creating-environment.md).
Entsprechende Benutzeroberfläche: Je nach Aktionsversion eine der folgenden Optionen:
+ (Neuere Versionen) tab/Environment/What Die Konfiguration ist da*my-environment*? **/Dreipunktmenü/ Rolle wechseln**
+ **(Ältere Versionen) Registerkarte „Konfiguration“/„/Kontoverbindung Environment/account/role AWS **
## Name
(*LambdaInvoke*/Environment/Connections/**Name**)
(Erforderlich, falls enthalten[Connections](#lam.invoke.environment.connections))
Geben Sie den Namen der Kontoverbindung an.
Entsprechende Benutzeroberfläche: Je nach Aktionsversion eine der folgenden Optionen:
+ (Neuere Versionen) tab/Environment/What Die Konfiguration ist da*my-environment*? **/Dreipunktmenü/ Rolle wechseln**
+ **(Ältere Versionen) Registerkarte „Konfiguration“/„/Kontoverbindung Environment/account/role AWS **
## Role
(*LambdaInvoke*/Environment/Connections/**Role**)
(Erforderlich, falls enthalten[Connections](#lam.invoke.environment.connections))
Geben Sie den Namen der IAM-Rolle an, mit der die **AWS Lambda Aufrufaktion** auf Ihre Lambda-Funktion zugreift AWS und sie aufruft. Stellen Sie sicher, dass Sie [die Rolle zu Ihrem CodeCatalyst Bereich hinzugefügt](ipa-connect-account-addroles.md) haben und dass die Rolle die folgenden Richtlinien enthält.
Wenn Sie keine IAM-Rolle angeben, verwendet die Aktion die Standard-IAM-Rolle, die in der [Umgebung](deploy-environments.md) in der CodeCatalyst Konsole aufgeführt ist. Wenn Sie die Standardrolle in der Umgebung verwenden, stellen Sie sicher, dass sie über die folgenden Richtlinien verfügt.
+ Die folgende Berechtigungsrichtlinie:
**Warnung**
Beschränken Sie die Berechtigungen auf die in der folgenden Richtlinie angegebenen. Die Verwendung einer Rolle mit umfassenderen Berechtigungen kann ein Sicherheitsrisiko darstellen.
+ Die folgende benutzerdefinierte Vertrauensrichtlinie:
**Anmerkung**
Sie können die `CodeCatalystWorkflowDevelopmentRole-spaceName` Rolle mit dieser Aktion verwenden, wenn Sie möchten. Weitere Informationen über diese Rolle finden Sie unter [Die **CodeCatalystWorkflowDevelopmentRole-*spaceName***Rolle für Ihr Konto und Ihren Bereich erstellen](ipa-iam-roles.md#ipa-iam-roles-service-create). Beachten Sie, dass die `CodeCatalystWorkflowDevelopmentRole-spaceName` Rolle über volle Zugriffsberechtigungen verfügt, was ein Sicherheitsrisiko darstellen kann. Wir empfehlen, diese Rolle nur in Tutorials und Szenarien zu verwenden, in denen die Sicherheit weniger wichtig ist.
Entsprechende Benutzeroberfläche: Je nach Aktionsversion eine der folgenden Optionen:
+ (Neuere Versionen) tab/Environment/What Die Konfiguration ist da*my-environment*? **/Dreipunktmenü/ Rolle wechseln**
+ **(Ältere Versionen) Registerkarte Environment/account/role „Konfiguration“ /' '/ Rolle**
## Configuration
(*LambdaInvoke*/**Configuration**)
(Erforderlich)
Ein Abschnitt, in dem Sie die Konfigurationseigenschaften der Aktion definieren können.
Entsprechende Benutzeroberfläche: Registerkarte „**Konfiguration**“
## Function
(*LambdaInvoke*/Configuration/**Function**)
(Erforderlich)
Geben Sie die AWS Lambda Funktion an, die durch diese Aktion aufgerufen werden soll. Sie können den Namen der Funktion oder ihren Amazon-Ressourcennamen (ARN) angeben. Sie finden den Namen oder ARN in der Lambda-Konsole.
**Anmerkung**
Das AWS Konto, in dem sich die Lambda-Funktion befindet, kann sich von dem unter angegebenen Konto unterscheiden. `Connections:`
**Entsprechende Benutzeroberfläche: Registerkarte „Konfiguration/Funktion“**
## AWSRegion
(*LambdaInvoke*/Configuration/**AWSRegion**)
(Erforderlich)
Geben Sie die AWS Region an, in der sich Ihre AWS Lambda Funktion befindet. Eine Liste der Regionscodes finden Sie unter [Regionale Endpunkte](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints) in der. *Allgemeine AWS-Referenz*
Entsprechende Benutzeroberfläche: Registerkarte „Konfiguration“/„**Ziel-Bucket**“ — optional
## RequestPayload
(*LambdaInvoke*/Configuration/**RequestPayload**)
(Optional)
Wenn Sie eine Anforderungsnutzlast an die **AWS Lambda Aufrufaktion** übergeben möchten, geben Sie die Anforderungsnutzlast hier im JSON-Format an.
Beispiel für eine Payload einer Anfrage:
```
'{ "key": "value" }'
```
Wenn Sie keine Anforderungsnutzlast an Ihre Lambda-Funktion übergeben möchten, lassen Sie diese Eigenschaft weg.
**Anmerkung**
Sie können `RequestPayload` oder `RequestPayloadFile` angeben, aber nicht beides.
*Weitere Informationen zur Payload der Anfrage finden Sie im Thema [Invoke](https://docs.aws.amazon.com/lambda/latest/dg/API_Invoke.html) in der API-Referenz.AWS Lambda *
Entsprechende Benutzeroberfläche: Registerkarte „Konfiguration“/Payload „**Anfrage**“ — optional
## RequestPayloadFile
(*LambdaInvoke*/Configuration/**RequestPayloadFile**)
(Optional)
Wenn Sie eine Anforderungs-Payload an die **AWS Lambda Aufruf-Aktion übergeben möchten, geben Sie hier** den Pfad zu dieser Anforderungs-Payload-Datei an. Die Datei muss im JSON-Format sein.
Die Payload-Datei der Anfrage kann sich in einem Quell-Repository oder in einem Artefakt aus einer früheren Aktion befinden. Der Dateipfad bezieht sich auf das Quell-Repository oder das Artefakt-Stammverzeichnis.
Wenn Sie keine Anforderungsnutzlast an Ihre Lambda-Funktion übergeben möchten, lassen Sie diese Eigenschaft weg.
**Anmerkung**
Sie können `RequestPayload` oder `RequestPayloadFile` angeben, aber nicht beides.
*Weitere Informationen zur Payload-Datei für Anfragen finden Sie im Thema [Invoke in der API-Referenz](https://docs.aws.amazon.com/lambda/latest/dg/API_Invoke.html).AWS Lambda *
Entsprechende Benutzeroberfläche: Registerkarte „Konfiguration“/**Payload-Datei anfordern** — optional
## ContinueOnError
(*LambdaInvoke*/Configuration/**RequestPayloadFile**)
(Optional)
Geben Sie an, ob Sie die **AWS Lambda Aufrufaktion** auch dann als erfolgreich markieren möchten, wenn die AWS Lambda aufgerufene Funktion fehlschlägt. Erwägen Sie, diese Eigenschaft auf `true` zu setzen, damit nachfolgende Aktionen in Ihrem Workflow trotz des Lambda-Fehlers gestartet werden können.
Standardmäßig schlägt die Aktion fehl, wenn die Lambda-Funktion fehlschlägt („off“ im Visual Editor oder `false` im YAML-Editor).
**Entsprechende Benutzeroberfläche: Registerkarte „Konfiguration“/Bei Fehler fortfahren**
## LogType
(*LambdaInvoke*/Configuration/**LogType**)
(Optional)
Geben Sie an, ob Sie Fehlerprotokolle in die Antwort der Lambda-Funktion aufnehmen möchten, nachdem sie aufgerufen wurde. Sie können diese Protokolle auf der Registerkarte **Protokolle** der **Lambda-Aufrufaktion** in der CodeCatalyst Konsole anzeigen. Die möglichen Werte sind:
+ `Tail`— Logs zurückgeben
+ `None`— gibt keine Logs zurück
Die Standardeinstellung ist **Tail**.
Weitere Informationen zum Protokolltyp finden Sie im Thema [Invoke](https://docs.aws.amazon.com/lambda/latest/dg/API_Invoke.html) in der *AWS Lambda API-Referenz.*
Weitere Informationen zum Anzeigen von Protokollen finden Sie unter [Status und Details der Workflow-Ausführung anzeigen](workflows-view-run.md).
**Entsprechende Benutzeroberfläche: Registerkarte „Konfiguration“ /Protokolltyp**
## ResponseFilters
(*LambdaInvoke*/Configuration/**ResponseFilters**)
(Optional)
Geben Sie an, welche Schlüssel in der Payload der Lambda-Antwort Sie in Ausgabevariablen konvertieren möchten. Sie können dann in nachfolgenden Aktionen in Ihrem Workflow auf die Ausgabevariablen verweisen. Weitere Informationen zu Variablen in CodeCatalyst finden Sie unter[Verwenden von Variablen in Workflows](workflows-working-with-variables.md).
Wenn Ihre Antwort-Payload beispielsweise wie folgt aussieht:
```
responsePayload = {
"name": "Saanvi",
"location": "Seattle",
"department": {
"company": "Amazon",
"team": "AWS"
}
}
```
... und deine Antwortfilter sehen so aus:
```
Configuration:
...
ResponseFilters: '{"name": ".name", "company": ".department.company"}'
```
... dann generiert die Aktion die folgenden Ausgangsvariablen:
| Key (Schlüssel) | Value (Wert) |
| --- | --- |
| Name | Saanvi |
| company | Amazon |
Sie können dann in nachfolgenden Aktionen auf die `company` Variablen `name` und verweisen.
Wenn Sie keine Schlüssel in angeben`ResponseFilters`, konvertiert die Aktion jeden Schlüssel der obersten Ebene in der Lambda-Antwort in eine Ausgabevariable. Weitere Informationen finden Sie unter [Variablen 'AWS Lambda aufrufen'](lam-invoke-action-variables.md).
Erwägen Sie die Verwendung von Antwortfiltern, um die generierten Ausgabevariablen auf diejenigen zu beschränken, die Sie tatsächlich verwenden möchten.
Entsprechende Benutzeroberfläche: Registerkarte „**Konfiguration/Antwortfilter“ — optional**
## Outputs
(*LambdaInvoke*/**Outputs**)
(Optional)
Definiert die Daten, die von der Aktion während eines Workflow-Laufs ausgegeben werden.
Entsprechende Benutzeroberfläche: Registerkarte „**Ausgaben**“
## Artifacts
(*LambdaInvoke*/Outputs/**Artifacts**)
(Optional)
Geben Sie die durch die Aktion generierten Artefakte an. Sie können diese Artefakte als Eingabe in anderen Aktionen referenzieren.
Weitere Informationen zu Artefakten, einschließlich Beispielen, finden Sie unter[Artefakte und Dateien zwischen Aktionen teilen](workflows-working-artifacts.md).
**Entsprechende Benutzeroberfläche: Registerkarte Ausgaben/Artefakte/ Name des Build-Artefakts**
## Name
(*LambdaInvoke*/Outputs/Artifacts/**Name**)
(Optional)
Geben Sie den Namen des Artefakts an, das die Lambda-Antwortnutzlast enthält, die von der Lambda-Funktion zurückgegeben wird. Der Standardwert ist `lambda_artifacts`. Wenn Sie kein Artefakt angeben, kann die Payload der Lambda-Antwort in den Protokollen der Aktion angezeigt werden, die auf der Registerkarte **Protokolle** für die Aktion in der Konsole verfügbar sind. CodeCatalyst Weitere Informationen zum Anzeigen von Protokollen finden Sie unter [Status und Details der Workflow-Ausführung anzeigen](workflows-view-run.md).
**Entsprechende Benutzeroberfläche: Gibt die Registerkarte „Artifacts/Name des Build-Artefakts“ aus**
## Files
(*LambdaInvoke*/Outputs/Artifacts/**Files**)
(Optional)
Geben Sie die Dateien an, die in das Artefakt aufgenommen werden sollen. Sie müssen angeben, `lambda-response.json` dass die Payload-Datei für die Lambda-Antwort eingeschlossen wird.
**Entsprechende Benutzeroberfläche: Gibt die Tab/Artifacts/Dateien aus, die vom Build erzeugt wurden**