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à.

# PutFunctionEventInvokeConfig
<a name="API_PutFunctionEventInvokeConfig"></a>

Configura le opzioni per l'[invocazione asincrona](https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html) su una funzione, una versione o un alias. Se esiste già una configurazione per una funzione, una versione o un alias, questa operazione la sovrascrive. Se si escludono delle impostazioni, queste verranno rimosse. Per impostare un'opzione senza influire sulle impostazioni esistenti per altre opzioni, utilizza [UpdateFunctionEventInvokeConfig](API_UpdateFunctionEventInvokeConfig.md).

Per impostazione predefinita, Lambda tenta un'invocazione asincrona due volte se la funzione restituisce un errore. Mantiene gli eventi in coda per un massimo di sei ore. Quando un evento fallisce tutti i tentativi di elaborazione o rimane nella coda di invocazione asincrona per troppo tempo, Lambda lo scarta. Per mantenere gli eventi scartati, configura una coda DLQ con [UpdateFunctionConfiguration](API_UpdateFunctionConfiguration.md).

Per inviare un record di chiamata a una coda, un argomento, una funzione o un bus di eventi, specifica una [destinazione](https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html#invocation-async-destinations). È possibile configurare destinazioni separate per invocazioni riuscite (con esito positivo) ed eventi per i quali non riescono tutti i tentativi di elaborazione (con esito negativo). È possibile configurare le destinazioni in aggiunta a o al posto di una coda DLQ.

## Sintassi della richiesta
<a name="API_PutFunctionEventInvokeConfig_RequestSyntax"></a>

```
PUT /2019-09-25/functions/FunctionName/event-invoke-config?Qualifier=Qualifier HTTP/1.1
Content-type: application/json

{
   "DestinationConfig": { 
      "OnFailure": { 
         "Destination": "string"
      },
      "OnSuccess": { 
         "Destination": "string"
      }
   },
   "MaximumEventAgeInSeconds": number,
   "MaximumRetryAttempts": number
}
```

## Parametri della richiesta URI
<a name="API_PutFunctionEventInvokeConfig_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [FunctionName](#API_PutFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-request-FunctionName"></a>
Il nome, la versione o l'alias della funzione Lambda.  

**Formati di nome**
+  **Nome della funzione**: `my-function` (solo nome), `my-function:v1` (con alias).
+  ** Function ARN (ARN funzione LAM)** - `arn:aws:lambda:us-west-2:123456789012:function:my-function`.
+  **ARN parziale** - `123456789012:function:my-function`.
Puoi aggiungere un numero di versione o un alias a qualsiasi formato. Il vincolo di lunghezza si applica solo all'ARN completo. Se specifichi solo il nome della funzione, questo avrà un limite di lunghezza di 64 caratteri.  
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 140.  
Modello: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}(-gov)?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?`   
Campo obbligatorio: sì

 ** [Qualifier](#API_PutFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-request-Qualifier"></a>
Un numero di versione o un nome alias.  
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 128 caratteri.  
Modello: `(|[a-zA-Z0-9$_-]+)` 

## Corpo della richiesta
<a name="API_PutFunctionEventInvokeConfig_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [DestinationConfig](#API_PutFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-request-DestinationConfig"></a>
Una destinazione per gli eventi dopo che sono stati inviati a una funzione per l'elaborazione.  

**Destinazioni**
+  **Funzione** - Amazon Resource Name (ARN) di una funzione Lambda.
+  **Coda**: l'ARN di una coda SQS standard.
+  **Argomento**: l'ARN di un argomento SNS standard.
+  **Event Bus**: l'ARN di un bus di EventBridge eventi Amazon.
Tipo: oggetto [DestinationConfig](API_DestinationConfig.md)  
Campo obbligatorio: no

 ** [MaximumEventAgeInSeconds](#API_PutFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-request-MaximumEventAgeInSeconds"></a>
L'età massima di una richiesta inviata da Lambda a una funzione per l'elaborazione.  
Tipo: integer  
Intervallo valido: valore minimo pari a 60. Valore massimo pari a 21600.  
Campo obbligatorio: no

 ** [MaximumRetryAttempts](#API_PutFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-request-MaximumRetryAttempts"></a>
Il numero massimo di ripetizioni consentite quando la funzione restituisce un errore.  
Tipo: integer  
Intervallo valido: valore minimo di 0. Valore massimo pari a 2.  
Campo obbligatorio: no

## Sintassi della risposta
<a name="API_PutFunctionEventInvokeConfig_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "DestinationConfig": { 
      "OnFailure": { 
         "Destination": "string"
      },
      "OnSuccess": { 
         "Destination": "string"
      }
   },
   "FunctionArn": "string",
   "LastModified": number,
   "MaximumEventAgeInSeconds": number,
   "MaximumRetryAttempts": number
}
```

## Elementi di risposta
<a name="API_PutFunctionEventInvokeConfig_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [DestinationConfig](#API_PutFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-response-DestinationConfig"></a>
Una destinazione per gli eventi dopo che sono stati inviati a una funzione per l'elaborazione.  

**Destinazioni**
+  **Funzione** - Amazon Resource Name (ARN) di una funzione Lambda.
+  **Coda**: l'ARN di una coda SQS standard.
+  **Argomento**: l'ARN di un argomento SNS standard.
+  **Event Bus**: l'ARN di un bus di EventBridge eventi Amazon.
Tipo: oggetto [DestinationConfig](API_DestinationConfig.md)

 ** [FunctionArn](#API_PutFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-response-FunctionArn"></a>
L'Amazon Resource Name (ARN) della funzione.  
Tipo: stringa  
Modello: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}(-gov)?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?` 

 ** [LastModified](#API_PutFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-response-LastModified"></a>
La data e l'ora dell'ultimo aggiornamento della configurazione, in secondi di tempo Unix.  
Tipo: Timestamp

 ** [MaximumEventAgeInSeconds](#API_PutFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-response-MaximumEventAgeInSeconds"></a>
L'età massima di una richiesta inviata da Lambda a una funzione per l'elaborazione.  
Tipo: integer  
Intervallo valido: valore minimo pari a 60. Valore massimo pari a 21600.

 ** [MaximumRetryAttempts](#API_PutFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-response-MaximumRetryAttempts"></a>
Il numero massimo di ripetizioni consentite quando la funzione restituisce un errore.  
Tipo: integer  
Intervallo valido: valore minimo di 0. Valore massimo pari a 2.

## Errori
<a name="API_PutFunctionEventInvokeConfig_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** InvalidParameterValueException **   
Uno dei parametri della richiesta non è valido.  
Codice di stato HTTP: 400

 ** ResourceConflictException **   
La risorsa esiste già o è in corso un'altra operazione.  
Codice di stato HTTP: 409

 ** ResourceNotFoundException **   
La risorsa specificata nella richiesta non esiste.  
Codice di stato HTTP: 404

 ** ServiceException **   
Il servizio AWS Lambda ha riscontrato un errore interno.  
Codice di stato HTTP: 500

 ** TooManyRequestsException **   
È stato superato il limite di throughput della richiesta. Per ulteriori informazioni, consulta la pagina relativa alle [quote di ](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).  
Codice di stato HTTP: 429

## Vedi anche
<a name="API_PutFunctionEventInvokeConfig_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue:
+  [Interfaccia a riga di comando AWS](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [SDK AWS per .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [SDK AWS per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [SDK AWS per Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [SDK AWS per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [AWSSDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [SDK AWS per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [SDK AWS per Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [SDK AWS per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/PutFunctionEventInvokeConfig)