

Amazon non CodeCatalyst è più aperta a nuovi clienti. I clienti esistenti possono continuare a utilizzare il servizio normalmente. Per ulteriori informazioni, consulta [Come migrare da CodeCatalyst](migration.md).

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Richiamo di una funzione Lambda utilizzando un flusso di lavoro
<a name="lam-invoke-action"></a>

Questa sezione descrive come richiamare una funzione utilizzando un flusso di lavoro. AWS Lambda CodeCatalyst A tale scopo, è necessario aggiungere l'azione di **AWS Lambda richiamo** al flusso di lavoro. L'azione **AWS Lambda invoke richiama** la funzione Lambda specificata.

[Oltre a richiamare la funzione, l'azione **AWS Lambda invoke** converte anche ogni chiave di primo livello nel payload di risposta ricevuto dalla funzione Lambda in una variabile di output del flusso di lavoro.](workflows-working-with-variables.md) È quindi possibile fare riferimento a queste variabili nelle azioni successive del flusso di lavoro. Se non desideri che tutte le chiavi di primo livello vengano convertite in variabili, puoi utilizzare i filtri per specificare quelle esatte. Per ulteriori informazioni, vedere la descrizione [ResponseFilters](lam-invoke-action-ref.md#lam.invoke.response.filters) della proprietà in. [AWS Lambda azione 'invoca' YAML](lam-invoke-action-ref.md) 

**Topics**
+ [Quando utilizzare questa azione](#lam-invoke-action-when-to-use)
+ [Immagine di runtime utilizzata dall'azione 'invoke'AWS Lambda](#lam-invoke-action-runtime)
+ [Esempio: richiamare una funzione Lambda](lam-invoke-action-example-workflow.md)
+ [Aggiungere l'AWS Lambda azione «invoca»](lam-invoke-action-add.md)
+ [variabili 'AWS Lambda invoke'](lam-invoke-action-variables.md)
+ [AWS Lambda azione 'invoca' YAML](lam-invoke-action-ref.md)

## Quando utilizzare questa azione
<a name="lam-invoke-action-when-to-use"></a>

Utilizza questa azione se desideri aggiungere funzionalità al flusso di lavoro incapsulate ed eseguite da una funzione Lambda.

Ad esempio, potresti volere che il tuo flusso di lavoro invii una `Build started` notifica a un canale Slack prima di iniziare una build dell'applicazione. In questo caso, il flusso di lavoro includerebbe un'azione di **AWS Lambda invoca** per richiamare una Lambda per inviare la notifica Slack e un'azione di [compilazione per creare l'applicazione](build-add-action.md).

Come altro esempio, potresti volere che il tuo flusso di lavoro esegua una scansione delle vulnerabilità dell'applicazione prima che venga distribuita. In questo caso, dovresti utilizzare un'azione di compilazione per creare l'applicazione, un'azione di richiamo per **AWS Lambda richiamare** una Lambda per la scansione delle vulnerabilità e un'azione di distribuzione per distribuire l'applicazione scansionata.

## Immagine di runtime utilizzata dall'azione 'invoke'AWS Lambda
<a name="lam-invoke-action-runtime"></a>

L'azione **AWS Lambda invoke** viene eseguita su un'immagine di [novembre 2022](build-images.md#build.previous-image). Per ulteriori informazioni, consulta [Immagini attive](build-images.md#build-curated-images).

# Esempio: richiamare una funzione Lambda
<a name="lam-invoke-action-example-workflow"></a>

Il seguente flusso di lavoro di esempio include l'azione **AWS Lambda invoke**, insieme a un'azione di distribuzione. Il flusso di lavoro invia una notifica Slack che indica l'avvio di una distribuzione, quindi distribuisce un'applicazione in AWS modo che utilizzi un modello. CloudFormation Il flusso di lavoro è costituito dai seguenti elementi costitutivi eseguiti in sequenza:
+ Un **trigger**: questo trigger avvia l'esecuzione automatica del flusso di lavoro quando invii una modifica al tuo repository di origine. Per ulteriori informazioni sui trigger, consulta [L'avvio di un flusso di lavoro viene eseguito automaticamente utilizzando i trigger](workflows-add-trigger.md).
+ Un'azione di **AWS Lambda richiamo** (`LambdaNotify`): all'attivazione, questa azione richiama la funzione `Notify-Start` Lambda nell' AWS account e nella regione specificati (e). `my-aws-account` `us-west-2` Alla chiamata, la funzione Lambda invia una notifica Slack che indica l'avvio di una distribuzione.
+ Un'azione **Deploy CloudFormation stack** (`Deploy`): al termine dell'azione di **AWS Lambda richiamo**, l'azione **Deploy CloudFormation stack esegue il template () per distribuire lo stack** di applicazioni. `cfn-template.yml` **Per ulteriori informazioni sull'azione Deploy stack, vedere. CloudFormation ** [Implementazione di uno stack CloudFormation](deploy-action-cfn.md)

**Nota**  
Il seguente esempio di flusso di lavoro è a scopo illustrativo e non funzionerà senza una configurazione aggiuntiva.

**Nota**  
Nel codice YAML che segue, puoi omettere le `Connections:` sezioni se lo desideri. **Se ometti queste sezioni, devi assicurarti che il ruolo specificato nel campo **Default IAM role** nel tuo ambiente includa le autorizzazioni e le policy di fiducia richieste dalle azioni dello stack **AWS Lambda invoke** e Deploy. CloudFormation ** Per ulteriori informazioni sulla configurazione di un ambiente con un ruolo IAM predefinito, consulta. [Creazione di un ambiente](deploy-environments-creating-environment.md) Per ulteriori informazioni sulle autorizzazioni e sulle politiche di fiducia richieste dalle azioni dello ** CloudFormation stack **AWS Lambda Invoke** e Deploy**, consulta la descrizione della `Role` proprietà nella e. [AWS Lambda azione 'invoca' YAML](lam-invoke-action-ref.md) [Azione 'Implementa CloudFormation stack' 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
```

# Aggiungere l'AWS Lambda azione «invoca»
<a name="lam-invoke-action-add"></a>

 Utilizza le seguenti istruzioni per aggiungere l'azione **AWS Lambda invoke** al tuo flusso di lavoro. 

**Prerequisito**  
Prima di iniziare, assicurati che la AWS Lambda funzione e il ruolo di esecuzione Lambda associato siano pronti e disponibili in. AWS Per ulteriori informazioni, consulta l'argomento relativo al [ruolo di esecuzione Lambda](https://docs.aws.amazon.com/lambda/latest/dg/lambda-intro-execution-role.html) nella Guida per gli *AWS Lambda sviluppatori*.

------
#### [ Visual ]

**Per aggiungere l'AWS Lambda azione 'invoke' utilizzando l'editor visuale**

1. [Apri la CodeCatalyst console all'indirizzo https://codecatalyst.aws/.](https://codecatalyst.aws/)

1. Scegliere il progetto.

1. **Nel riquadro di navigazione, scegli **CI/CD**, quindi scegli Flussi di lavoro.**

1. Scegli il nome del tuo flusso di lavoro. Puoi filtrare in base al nome del repository o del ramo di origine in cui è definito il flusso di lavoro oppure filtrare in base al nome o allo stato del flusso di lavoro.

1. Scegli **Modifica**.

1. Scegli **Visual**.

1. In alto a sinistra, scegli **\$1 Azioni** per aprire il catalogo delle azioni.

1. **Dall'elenco a discesa, scegli Amazon. CodeCatalyst**

1. Cerca l'azione di **AWS Lambda richiamo** ed esegui una delle seguenti operazioni:
   + Scegli il segno più (**\$1**) per aggiungere l'azione al diagramma del flusso di lavoro e apri il relativo riquadro di configurazione.

     Or
   + Scegli **AWS Lambda invoke**. Viene visualizzata la finestra di dialogo dei dettagli dell'azione. In questa finestra di dialogo:
     + (Facoltativo) Scegliete **Visualizza sorgente** per [visualizzare il codice sorgente dell'azione](workflows-view-source.md#workflows-view-source.title).
     + Scegli **Aggiungi al flusso di lavoro** per aggiungere l'azione al diagramma del flusso di lavoro e aprire il relativo riquadro di configurazione.

1. Nelle schede **Ingressi**, **Configurazione** e **Uscite**, completa i campi in base alle tue esigenze. Per una descrizione di ogni campo, consulta la. [AWS Lambda azione 'invoca' YAML](lam-invoke-action-ref.md) Questo riferimento fornisce informazioni dettagliate su ogni campo (e il valore della proprietà YAML corrispondente) così come appaiono sia nell'editor YAML che in quello visivo.

1. (Facoltativo) Scegliete **Convalida per convalidare il codice YAML** del flusso di lavoro prima di eseguire il commit.

1. **Scegliete **Commit**, inserite un messaggio di commit e scegliete nuovamente Commit.**

------
#### [ YAML ]

**Per aggiungere l'AWS Lambda azione 'invoke' utilizzando l'editor YAML**

1. [Apri la console all'indirizzo https://codecatalyst.aws/ CodeCatalyst .](https://codecatalyst.aws/)

1. Scegliere il progetto.

1. **Nel riquadro di navigazione, scegli **CI/CD**, quindi scegli Flussi di lavoro.**

1. Scegli il nome del tuo flusso di lavoro. Puoi filtrare in base al nome del repository o del ramo di origine in cui è definito il flusso di lavoro oppure filtrare in base al nome o allo stato del flusso di lavoro.

1. Scegli **Modifica**.

1. Scegli **YAML**.

1. In alto a sinistra, scegli **\$1 Azioni per aprire il catalogo delle azioni**.

1. **Dall'elenco a discesa, scegli Amazon. CodeCatalyst**

1. Cerca l'azione di **AWS Lambda richiamo** ed esegui una delle seguenti operazioni:
   + Scegli il segno più (**\$1**) per aggiungere l'azione al diagramma del flusso di lavoro e apri il relativo riquadro di configurazione.

     Or
   + Scegli **AWS Lambda invoke**. Viene visualizzata la finestra di dialogo dei dettagli dell'azione. In questa finestra di dialogo:
     + (Facoltativo) Scegliete **Visualizza sorgente** per [visualizzare il codice sorgente dell'azione](workflows-view-source.md#workflows-view-source.title).
     + Scegli **Aggiungi al flusso di lavoro** per aggiungere l'azione al diagramma del flusso di lavoro e aprire il relativo riquadro di configurazione.

1. Modifica le proprietà del codice YAML in base alle tue esigenze. Una spiegazione di ogni proprietà disponibile è fornita in. [AWS Lambda azione 'invoca' YAML](lam-invoke-action-ref.md)

1. (Facoltativo) Scegliete **Convalida per convalidare** il codice YAML del flusso di lavoro prima di eseguire il commit.

1. **Scegliete **Commit**, inserite un messaggio di commit e scegliete nuovamente Commit.**

------

# variabili 'AWS Lambda invoke'
<a name="lam-invoke-action-variables"></a>

Per impostazione predefinita, l'azione **AWS Lambda invoke** produce una variabile per chiave di primo livello nel payload di risposta Lambda.

Ad esempio, se il payload di risposta è simile al seguente:

```
responsePayload = {
  "name": "Saanvi",
  "location": "Seattle",
  "department": {
    "company": "Amazon",
    "team": "AWS"
  }
}
```

... allora l'azione genererebbe le seguenti variabili.


| Chiave | Valore | 
| --- | --- | 
|  nome  |  Saanvi  | 
|  location  |  Seattle  | 
|  department  |  \$1"azienda»: «Amazon», «team»: "AWS«\$1  | 

**Nota**  
È possibile modificare le variabili generate utilizzando la proprietà `ResponseFilters` YAML. Per ulteriori informazioni, consultare [ResponseFilters](lam-invoke-action-ref.md#lam.invoke.response.filters) nella [AWS Lambda azione 'invoca' YAML](lam-invoke-action-ref.md).

*Le variabili prodotte e impostate dall'azione 'AWS Lambda invoca' in fase di esecuzione sono note come variabili predefinite.*

Per informazioni su come fare riferimento a queste variabili in un flusso di lavoro, vedere. [Utilizzo di variabili predefinite](workflows-using-predefined-variables.md)

# AWS Lambda azione 'invoca' YAML
<a name="lam-invoke-action-ref"></a>

**Di seguito è riportata la definizione YAML dell'azione invoke.AWS Lambda ** Per informazioni su come utilizzare questa azione, consulta. [Richiamo di una funzione Lambda utilizzando un flusso di lavoro](lam-invoke-action.md)

Questa definizione di azione esiste come sezione all'interno di un file di definizione del flusso di lavoro più ampio. Per ulteriori informazioni su questo file, consulta [Definizione YAML del flusso di lavoro](workflow-reference.md).

**Nota**  
La maggior parte delle proprietà YAML che seguono hanno elementi dell'interfaccia utente corrispondenti nell'editor visivo. **Per cercare un elemento dell'interfaccia utente, usa Ctrl\$1F.** L'elemento verrà elencato con la proprietà YAML associata.

```
# The workflow definition starts here.
# See Proprietà di primo livello 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
<a name="lam.invoke.name"></a>

(Obbligatorio)

Specificare il nome dell'azione. Tutti i nomi delle azioni devono essere univoci all'interno del flusso di lavoro. I nomi delle azioni sono limitati a caratteri alfanumerici (a-z, A-Z, 0-9), trattini (-) e caratteri di sottolineatura (\$1). Gli spazi non sono consentiti. Non è possibile utilizzare le virgolette per abilitare caratteri e spazi speciali nei nomi delle azioni.

Default: `Lambda_Invoke_Action_Workflow_nn`.

**Interfaccia utente corrispondente: scheda di configurazione/nome dell'azione**

## Identifier
<a name="lam.invoke.identifier"></a>

(*LambdaInvoke*/**Identifier**)

(Obbligatorio)

Identifica l'azione. Non modificate questa proprietà a meno che non vogliate cambiare la versione. Per ulteriori informazioni, consulta [Specificare la versione dell'azione da utilizzare](workflows-action-versions.md).

Default: `aws/lambda-invoke@v1`.

**Interfaccia utente corrispondente: Workflow diagram/ LambdaInvoke \$1nn/ aws/lambda-invoke @v1 label**

## DependsOn
<a name="lam.invoke.dependson"></a>

(*LambdaInvoke*/**DependsOn**)

(Facoltativo)

Specificate un'azione, un gruppo di azioni o un gate che deve essere eseguito correttamente per eseguire questa azione.

Per ulteriori informazioni sulla funzionalità «dipende da», vedere. [Azioni di sequenziamento](workflows-depends-on.md)

**Interfaccia utente corrispondente: scheda Ingressi/Dipende da - opzionale**

## Compute
<a name="lam.invoke.computename"></a>

(*LambdaInvoke*/**Compute**)

(Facoltativo)

Il motore di calcolo utilizzato per eseguire le azioni del flusso di lavoro. È possibile specificare l'elaborazione a livello di flusso di lavoro o a livello di azione, ma non entrambi. Se specificata a livello di flusso di lavoro, la configurazione di calcolo si applica a tutte le azioni definite nel flusso di lavoro. A livello di flusso di lavoro, puoi anche eseguire più azioni sulla stessa istanza. Per ulteriori informazioni, consulta [Condivisione dell'elaborazione tra le azioni](compute-sharing.md).

Interfaccia utente corrispondente: *nessuna*

## Type
<a name="lam.invoke.computetype"></a>

(*LambdaInvoke*/Compute/**Type**)

(Richiesto [Compute](#lam.invoke.computename) se incluso)

Il tipo di motore di calcolo. È possibile utilizzare uno dei seguenti valori:
+ **EC2**(editor visivo) o `EC2` (editor YAML)

  Ottimizzato per la flessibilità durante le operazioni.
+ **Lambda** (editor visivo) o `Lambda` (editor YAML)

  Velocità di avvio delle azioni ottimizzate.

Per ulteriori informazioni sui tipi di calcolo, consulta [Tipi di calcolo](workflows-working-compute.md#compute.types).

**Interfaccia utente corrispondente: scheda di configurazione/tipo di calcolo**

## Fleet
<a name="lam.invoke.computefleet"></a>

(*LambdaInvoke*/Compute/**Fleet**)

(Facoltativo)

Specificate la macchina o il parco macchine che eseguiranno il flusso di lavoro o le azioni del flusso di lavoro. Con le flotte on-demand, all'avvio di un'azione, il flusso di lavoro fornisce le risorse necessarie e le macchine vengono distrutte al termine dell'azione. Esempi di flotte on-demand:,. `Linux.x86-64.Large` `Linux.x86-64.XLarge` Per ulteriori informazioni sulle flotte on-demand, vedere. [Proprietà del parco istanze on demand](workflows-working-compute.md#compute.on-demand)

Con le flotte assegnate, puoi configurare una serie di macchine dedicate per eseguire le azioni del flusso di lavoro. Queste macchine rimangono inattive, pronte a elaborare immediatamente le azioni. Per ulteriori informazioni sulle flotte rifornite, vedere. [Proprietà del parco istanze con provisioning](workflows-working-compute.md#compute.provisioned-fleets)

Se `Fleet` viene omesso, l'impostazione predefinita è. `Linux.x86-64.Large`

**Interfaccia utente corrispondente: scheda di configurazione/parco di calcolo**

## Timeout
<a name="lam.invoke.timeout"></a>

(*LambdaInvoke*/**Timeout**)

(Obbligatorio)

Specificate il periodo di tempo, in minuti (editor YAML) o ore e minuti (editor visivo), che l'azione può essere eseguita prima CodeCatalyst che termini l'azione. Il minimo è 5 minuti e il massimo è descritto in. [Quote per i flussi di lavoro in CodeCatalyst](workflows-quotas.md) Il timeout predefinito è lo stesso del timeout massimo.

**Interfaccia utente corrispondente: scheda di configurazione/timeout - opzionale**

## Inputs
<a name="lam.invoke.inputs"></a>

(*LambdaInvoke*/**Inputs**)

(Obbligatorio)

La `Inputs` sezione definisce i dati necessari all'azione di **AWS Lambda invocazione** durante l'esecuzione di un flusso di lavoro.

**Nota**  
**È consentito un solo input (fonte o artefatto) per AWS Lambda azione di invoca.** Le variabili non vengono conteggiate per questo totale.

Interfaccia utente corrispondente: **scheda Ingressi**

## Sources
<a name="lam.invoke.inputs.sources"></a>

(*LambdaInvoke*/Inputs/**Sources**)

(Obbligatorio se [RequestPayloadFile](#lam.invoke.request.payload.file)fornito)

Se desideri passare un file JSON del payload della richiesta all'azione **AWS Lambda invoke** e questo file di payload è archiviato in un repository di origine, specifica l'etichetta di tale repository di origine. Attualmente, l'unica etichetta supportata è. `WorkflowSource`

Se il file di payload della richiesta non è contenuto in un repository di origine, deve risiedere in un artefatto generato da un'altra azione.

Per ulteriori informazioni sul file di payload, vedere. [RequestPayloadFile](#lam.invoke.request.payload.file)

**Nota**  
Invece di specificare un file di payload, è possibile aggiungere il codice JSON del payload direttamente all'azione utilizzando la proprietà. `RequestPayload` Per ulteriori informazioni, consulta [RequestPayload](#lam.invoke.request.payload). 

Per ulteriori informazioni sulle origini, consulta [Connessione degli archivi di origine ai flussi di lavoro](workflows-sources.md).

**Interfaccia utente corrispondente: scheda Input/Sources - opzionale**

## Artifacts - input
<a name="lam.invoke.inputs.artifacts"></a>

(*LambdaInvoke*/Inputs/**Artifacts**)

(Obbligatorio se fornito [RequestPayloadFile](#lam.invoke.request.payload.file))

Se desideri passare un file JSON del payload della richiesta all'azione di **AWS Lambda invoke** e questo file di payload è contenuto in un elemento di [output di un'azione precedente, specifica l'artefatto](build-action-ref.md#build.outputs.artifacts) qui.

Per ulteriori informazioni sul file di payload, consulta. [RequestPayloadFile](#lam.invoke.request.payload.file)

**Nota**  
Invece di specificare un file di payload, è possibile aggiungere il codice JSON del payload direttamente all'azione utilizzando la proprietà. `RequestPayload` Per ulteriori informazioni, consulta [RequestPayload](#lam.invoke.request.payload). 

Per ulteriori informazioni sugli artefatti, inclusi esempi, vedere. [Condivisione di artefatti e file tra azioni](workflows-working-artifacts.md)

**Interfaccia utente corrispondente: scheda di configurazione/artefatti - opzionale**

## Variables - input
<a name="lam.invoke.inputs.variables"></a>

(*LambdaInvoke*/Inputs/**Variables**)

(Facoltativo)

Specificate una sequenza di name/value coppie che definisca le variabili di input che desiderate rendere disponibili all'azione. I nomi delle variabili sono limitati a caratteri alfanumerici (a-z, A-Z, 0-9), trattini (-) e caratteri di sottolineatura (\$1). Gli spazi non sono consentiti. Non è possibile utilizzare le virgolette per abilitare caratteri e spazi speciali nei nomi delle variabili.

Per ulteriori informazioni sulle variabili, inclusi esempi, vedere[Utilizzo delle variabili nei flussi di lavoro](workflows-working-with-variables.md).

Interfaccia utente corrispondente: scheda **Input/Variabili** - opzionale

## Environment
<a name="lam.invoke.environment"></a>

(*LambdaInvoke*/**Environment**)

(Obbligatorio)

Specificare l' CodeCatalyst ambiente da utilizzare con l'azione. L'azione si connette Account AWS all'Amazon VPC opzionale specificato nell'ambiente scelto. L'azione utilizza il ruolo IAM predefinito specificato nell'ambiente per connettersi a e utilizza il ruolo IAM specificato nella [connessione Amazon VPC](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-vpcs.add.html) per connettersi ad Amazon VPC. Account AWS

**Nota**  
Se il ruolo IAM predefinito non dispone delle autorizzazioni richieste dall'azione, puoi configurare l'azione per utilizzare un ruolo diverso. Per ulteriori informazioni, consulta [Modifica del ruolo IAM di un'azione](deploy-environments-switch-role.md).

Per ulteriori informazioni sugli ambienti, consulta [Implementazione in e Account AWS VPCs](deploy-environments.md) e[Creazione di un ambiente](deploy-environments-creating-environment.md).

**Interfaccia utente corrispondente: scheda di configurazione/ambiente**

## Name
<a name="lam.invoke.environment.name"></a>

(*LambdaInvoke*/Environment/**Name**)

(Richiesto se [Environment](#lam.invoke.environment) incluso)

Specificate il nome di un ambiente esistente che desiderate associare all'azione.

**Interfaccia utente corrispondente: scheda di configurazione/ambiente**

## Connections
<a name="lam.invoke.environment.connections"></a>

(*LambdaInvoke*/Environment/**Connections**)

(Facoltativo nelle versioni più recenti dell'azione; richiesto nelle versioni precedenti)

Specificare la connessione dell'account da associare all'azione. È possibile specificare al massimo una connessione a un account in`Environment`.

Se non si specifica una connessione all'account:
+ L'azione utilizza la Account AWS connessione e il ruolo IAM predefinito specificati nell'ambiente della CodeCatalyst console. Per informazioni sull'aggiunta di una connessione all'account e del ruolo IAM predefinito all'ambiente, consulta[Creazione di un ambiente](deploy-environments-creating-environment.md).
+ Il ruolo IAM predefinito deve includere le policy e le autorizzazioni richieste dall'azione. Per determinare quali sono tali politiche e autorizzazioni, consulta la descrizione della proprietà **Role nella documentazione** sulla definizione YAML dell'azione.

Per ulteriori informazioni sulle connessioni degli account, vedere. [Consentire l'accesso alle AWS risorse con connessione Account AWS](ipa-connect-account.md) Per informazioni sull'aggiunta di una connessione tramite account a un ambiente, vedere[Creazione di un ambiente](deploy-environments-creating-environment.md).

Interfaccia utente corrispondente: una delle seguenti a seconda della versione dell'azione:
+ (Versioni più recenti) tab/Environment/What La configurazione è attiva? *my-environment* **/three dot menu/ Cambia ruolo**
+ **(Versioni precedenti) Scheda di configurazione/' '/ connessione all'account Environment/account/role AWS **

## Name
<a name="lam.invoke.environment.connections.name"></a>

(*LambdaInvoke*/Environment/Connections/**Name**)

(Richiesto se è incluso[Connections](#lam.invoke.environment.connections))

Specificare il nome della connessione all'account.

Interfaccia utente corrispondente: una delle seguenti a seconda della versione dell'azione:
+ (Versioni più recenti) tab/Environment/What La configurazione è attiva? *my-environment* **/three dot menu/ Cambia ruolo**
+ **(Versioni precedenti) Scheda di configurazione/' '/ connessione all'account Environment/account/role AWS **

## Role
<a name="lam.invoke.environment.connections.role"></a>

(*LambdaInvoke*/Environment/Connections/**Role**)

(Richiesto se è incluso[Connections](#lam.invoke.environment.connections))

Specificate il nome del ruolo IAM utilizzato dall'azione **AWS Lambda invoke** per accedere AWS e richiamare la funzione Lambda. Assicurati di aver [aggiunto il ruolo al tuo CodeCatalyst spazio](ipa-connect-account-addroles.md) e che il ruolo includa le seguenti politiche.

Se non specifichi un ruolo IAM, l'azione utilizza il ruolo IAM predefinito elencato nell'[ambiente](deploy-environments.md) nella CodeCatalyst console. Se utilizzi il ruolo predefinito nell'ambiente, assicurati che abbia le seguenti politiche.
+ La seguente politica di autorizzazione:
**avvertimento**  
Limita le autorizzazioni a quelle mostrate nella seguente politica. L'utilizzo di un ruolo con autorizzazioni più ampie potrebbe rappresentare un rischio per la sicurezza.
+ La seguente politica di fiducia personalizzata:

**Nota**  
Puoi usare il `CodeCatalystWorkflowDevelopmentRole-spaceName` ruolo con questa azione, se lo desideri. Per ulteriori informazioni su questo ruolo, consulta [Creazione del **CodeCatalystWorkflowDevelopmentRole-*spaceName***ruolo per il tuo account e il tuo spazio](ipa-iam-roles.md#ipa-iam-roles-service-create). Tieni presente che il `CodeCatalystWorkflowDevelopmentRole-spaceName` ruolo dispone di autorizzazioni di accesso complete, il che può rappresentare un rischio per la sicurezza. Ti consigliamo di utilizzare questo ruolo solo in tutorial e scenari in cui la sicurezza è meno preoccupante. 

Interfaccia utente corrispondente: una delle seguenti a seconda della versione di azione:
+ (Versioni più recenti) tab/Environment/What La configurazione è attiva? *my-environment* **/three dot menu/ Cambia ruolo**
+ **(Versioni precedenti) Scheda di configurazione/' '/ Ruolo Environment/account/role**

## Configuration
<a name="lam.invoke.configuration"></a>

(*LambdaInvoke*/**Configuration**)

(Obbligatorio)

Una sezione in cui è possibile definire le proprietà di configurazione dell'azione.

Interfaccia utente corrispondente: scheda **Configurazione**

## Function
<a name="lam.invoke.function"></a>

(*LambdaInvoke*/Configuration/**Function**)

(Obbligatorio)

Specificate la AWS Lambda funzione che verrà richiamata da questa azione. Puoi specificare il nome della funzione o il relativo Amazon Resource Name (ARN). Puoi trovare il nome o l'ARN nella console Lambda.

**Nota**  
L' AWS account in cui risiede la funzione Lambda può essere diverso dall'account specificato in. `Connections:`

**Interfaccia utente corrispondente: scheda di configurazione/funzione**

## AWSRegion
<a name="lam.invoke.region"></a>

(*LambdaInvoke*/Configuration/**AWSRegion**)

(Obbligatorio)

Specificate la AWS regione in cui risiede la AWS Lambda funzione. Per un elenco dei codici regionali, consulta [Endpoint regionali](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints) in. *Riferimenti generali di AWS*

Interfaccia utente corrispondente: scheda di **configurazione/bucket di destinazione** - opzionale

## RequestPayload
<a name="lam.invoke.request.payload"></a>

(*LambdaInvoke*/Configuration/**RequestPayload**)

(Facoltativo)

Se vuoi passare un payload della richiesta all'azione **AWS Lambda invoke**, specifica qui il payload della richiesta, in formato JSON.

Esempio di payload della richiesta:

```
'{ "key": "value" }'
```

Se non vuoi passare un payload di richiesta alla tua funzione Lambda, ometti questa proprietà.

**Nota**  
Puoi specificare `RequestPayload` o `RequestPayloadFile`, ma non entrambi.

*Per ulteriori informazioni sul payload della richiesta, consulta l'argomento [Invoke nell'API Reference](https://docs.aws.amazon.com/lambda/latest/dg/API_Invoke.html).AWS Lambda *

Interfaccia utente corrispondente: scheda di configurazione/payload della **richiesta** - opzionale

## RequestPayloadFile
<a name="lam.invoke.request.payload.file"></a>

(*LambdaInvoke*/Configuration/**RequestPayloadFile**)

(Facoltativo)

Se desideri passare un payload della richiesta all'azione **AWS Lambda invoke**, specifica qui il percorso di questo file di payload della richiesta. Il file deve essere in formato JSON.

Il file di payload della richiesta può risiedere in un repository di origine o in un elemento di un'azione precedente. Il percorso del file è relativo al repository di origine o alla radice dell'artefatto.

Se non vuoi passare un payload di richiesta alla tua funzione Lambda, ometti questa proprietà.

**Nota**  
Puoi specificare `RequestPayload` o `RequestPayloadFile`, ma non entrambi.

*Per ulteriori informazioni sul file di payload della richiesta, consultate l'argomento [Invoke nell'API Reference](https://docs.aws.amazon.com/lambda/latest/dg/API_Invoke.html).AWS Lambda *

Interfaccia utente corrispondente: scheda di configurazione/file di **payload della richiesta** - opzionale

## ContinueOnError
<a name="lam.invoke.continue"></a>

(*LambdaInvoke*/Configuration/**RequestPayloadFile**)

(Facoltativo)

Specificate se desiderate contrassegnare l'azione di **AWS Lambda richiamo** come riuscita anche se la funzione richiamata fallisce. AWS Lambda Valuta la possibilità di impostare questa proprietà `true` per consentire l'avvio delle azioni successive nel flusso di lavoro nonostante l'errore Lambda.

L'impostazione predefinita prevede di fallire l'azione se la funzione Lambda fallisce («off» nell'editor visuale o `false` nell'editor YAML).

**Interfaccia utente corrispondente: scheda di configurazione/ Continua in caso di errore**

## LogType
<a name="lam.invoke.log.type"></a>

(*LambdaInvoke*/Configuration/**LogType**)

(Facoltativo)

Specificate se desiderate includere i log degli errori nella risposta della funzione Lambda dopo che è stata richiamata. **Puoi visualizzare questi registri nella scheda Registri dell'azione **Lambda** invoke nella console.** CodeCatalyst I valori possibili sono:
+ `Tail`— log di ritorno
+ `None`— non restituire i log

L'impostazione predefinita è **Tail.**

Per ulteriori informazioni sul tipo di registro, consulta l'argomento [Invoke](https://docs.aws.amazon.com/lambda/latest/dg/API_Invoke.html) nell'*AWS Lambda API Reference*.

Per ulteriori informazioni sulla visualizzazione dei log, consultare [Visualizzazione dello stato e dei dettagli dell'esecuzione del flusso di lavoro](workflows-view-run.md).

**Interfaccia utente corrispondente: scheda di configurazione/tipo di registro**

## ResponseFilters
<a name="lam.invoke.response.filters"></a>

(*LambdaInvoke*/Configuration/**ResponseFilters**)

(Facoltativo)

Specificate quali chiavi del payload di risposta Lambda desiderate convertire in variabili di output. È quindi possibile fare riferimento alle variabili di output nelle azioni successive del flusso di lavoro. Per ulteriori informazioni sulle variabili in CodeCatalyst, vedere[Utilizzo delle variabili nei flussi di lavoro](workflows-working-with-variables.md).

Ad esempio, se il payload di risposta è simile al seguente:

```
responsePayload = {
  "name": "Saanvi",
  "location": "Seattle",
  "department": {
    "company": "Amazon",
    "team": "AWS"
  }
}
```

... e i tuoi filtri di risposta hanno il seguente aspetto:

```
Configuration:
  ...
  ResponseFilters: '{"name": ".name", "company": ".department.company"}'
```

... quindi l'azione genera le seguenti variabili di output:


| Chiave | Valore | 
| --- | --- | 
|  nome  |  Saanvi  | 
|  company  |  Amazon  | 

È quindi possibile fare riferimento alle `company` variabili `name` and nelle azioni successive.

Se non si specifica alcuna chiave in`ResponseFilters`, l'azione converte ogni chiave di primo livello nella risposta Lambda in una variabile di output. Per ulteriori informazioni, consulta [variabili 'AWS Lambda invoke'](lam-invoke-action-variables.md).

Prendi in considerazione l'utilizzo di filtri di risposta per limitare le variabili di output generate solo a quelle che desideri effettivamente utilizzare.

Interfaccia utente corrispondente: scheda di **configurazione/filtri di risposta - opzionale**

## Outputs
<a name="lam.invoke.outputs"></a>

(*LambdaInvoke*/**Outputs**)

(Facoltativo)

Definisce i dati emessi dall'azione durante l'esecuzione di un flusso di lavoro.

Interfaccia utente corrispondente: **scheda Output**

## Artifacts
<a name="lam.invoke.outputs.artifacts"></a>

(*LambdaInvoke*/Outputs/**Artifacts**)

(Facoltativo)

Specificate gli artefatti generati dall'azione. È possibile fare riferimento a questi artefatti come input in altre azioni.

Per ulteriori informazioni sugli artefatti, inclusi esempi, vedere. [Condivisione di artefatti e file tra azioni](workflows-working-artifacts.md)

**Interfaccia utente corrispondente: Outputs tab/Artifacts/ Build artefact name**

## Name
<a name="lam.invoke.outputs.artifacts.name"></a>

(*LambdaInvoke*/Outputs/Artifacts/**Name**)

(Facoltativo)

Specificate il nome dell'elemento che conterrà il payload di risposta Lambda restituito dalla funzione Lambda. Il valore predefinito è `lambda_artifacts`. Se non specifichi un artefatto, il payload della risposta Lambda può essere visualizzato nei registri dell'azione, disponibili nella scheda **Registri dell'azione nella console**. CodeCatalyst Per ulteriori informazioni sulla visualizzazione dei log, consultare [Visualizzazione dello stato e dei dettagli dell'esecuzione del flusso di lavoro](workflows-view-run.md).

**Interfaccia utente corrispondente: Outputs tab/Artifacts/ Build artifact name**

## Files
<a name="lam.invoke.outputs.artifacts.files"></a>

(*LambdaInvoke*/Outputs/Artifacts/**Files**)

(Facoltativo)

Specificate i file da includere nell'artefatto. È necessario specificare `lambda-response.json` in modo che venga incluso il file del payload della risposta Lambda.

**Interfaccia utente corrispondente: Outputs tab/Artifacts/ Files prodotti da build**