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

Configura opciones para la [invocación asíncrona](https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html) en una función, una versión o un alias. Si ya existe una configuración para una función, versión o alias, esta operación lo sobrescribe. Si excluye cualquier configuración, se eliminan. Para establecer una opción sin afectar a las configuraciones existentes de otras opciones, utilice [UpdateFunctionEventInvokeConfig](API_UpdateFunctionEventInvokeConfig.md).

De forma predeterminada, Lambda reintenta una invocación asíncrona dos veces si la función devuelve un error. Conserva los eventos en una cola durante un máximo de seis horas. Cuando un evento falla todos los intentos de procesamiento o permanece en la cola de invocación asincrónica durante demasiado tiempo, Lambda lo descarta. Para conservar los eventos descartados, configure una cola de mensajes fallidos con [UpdateFunctionConfiguration](API_UpdateFunctionConfiguration.md).

Para enviar un registro de invocación a una cola, un tema, una función o un bus de eventos, especifique un [destino](https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html#invocation-async-destinations). Puede configurar destinos separados para las invocaciones exitosas (en éxito) y los eventos que no se procesaron correctamente (en error). Puede configurar destinos además, o en lugar, de una cola de mensajes fallidos.

## Sintaxis de la solicitud
<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
}
```

## Parámetros de solicitud del URI
<a name="API_PutFunctionEventInvokeConfig_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [FunctionName](#API_PutFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-request-FunctionName"></a>
El nombre de función de Lambda, la versión o el alias.  

**Formatos de nombre**
+  **Nombre de la función**: `my-function` (solo nombre), `my-function:v1` (con alias).
+  **ARN de la función**: `arn:aws:lambda:us-west-2:123456789012:function:my-function`.
+  **ARN parcial**: `123456789012:function:my-function`.
Puede incluir un número de versión o alias en cualquiera de los formatos. La limitación de longitud se aplica únicamente al ARN completo. Si solo especifica el nombre de la función, se limita a 64 caracteres de longitud.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 140 caracteres.  
Patrón: `(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-_]+))?`   
Obligatorio: sí

 ** [Qualifier](#API_PutFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-request-Qualifier"></a>
Un número de versión o nombre de alias.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 128.  
Patrón: `(|[a-zA-Z0-9$_-]+)` 

## Cuerpo de la solicitud
<a name="API_PutFunctionEventInvokeConfig_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [DestinationConfig](#API_PutFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-request-DestinationConfig"></a>
Un destino para eventos después de que se hayan enviado a una función para su procesamiento.  

**Destinos**
+  **Función**: el nombre de recurso de Amazon (ARN) de una función de Lambda.
+  **Cola**: el ARN de una cola de SQS estándar.
+  **Tema**: el ARN de un tema de SNS estándar.
+  **Bus de eventos** - El ARN de un bus de eventos de Amazon EventBridge.
Tipo: objeto [DestinationConfig](API_DestinationConfig.md)  
Obligatorio: no

 ** [MaximumEventAgeInSeconds](#API_PutFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-request-MaximumEventAgeInSeconds"></a>
La antigüedad máxima de una solicitud que Lambda envía a una función para su procesamiento.  
Tipo: entero  
Rango válido: valor mínimo de 60. Valor máximo de 21600.  
Obligatorio: no

 ** [MaximumRetryAttempts](#API_PutFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-request-MaximumRetryAttempts"></a>
El número máximo de veces que se debe volver a intentar cuando la función devuelve un error.  
Tipo: entero  
Rango válido: valor mínimo de 0. Valor máximo de 2.  
Obligatorio: no

## Sintaxis de la respuesta
<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
}
```

## Elementos de respuesta
<a name="API_PutFunctionEventInvokeConfig_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [DestinationConfig](#API_PutFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-response-DestinationConfig"></a>
Un destino para eventos después de que se hayan enviado a una función para su procesamiento.  

**Destinos**
+  **Función**: el nombre de recurso de Amazon (ARN) de una función de Lambda.
+  **Cola**: el ARN de una cola de SQS estándar.
+  **Tema**: el ARN de un tema de SNS estándar.
+  **Bus de eventos** - El ARN de un bus de eventos de Amazon EventBridge.
Tipo: objeto [DestinationConfig](API_DestinationConfig.md)

 ** [FunctionArn](#API_PutFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-response-FunctionArn"></a>
El nombre de recurso de Amazon (ARN) de la función.  
Tipo: String  
Patrón: `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 fecha y hora en las que se actualizó por última vez la configuración, en segundos de tiempo Unix.  
Tipo: marca temporal

 ** [MaximumEventAgeInSeconds](#API_PutFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-response-MaximumEventAgeInSeconds"></a>
La antigüedad máxima de una solicitud que Lambda envía a una función para su procesamiento.  
Tipo: entero  
Rango válido: valor mínimo de 60. Valor máximo de 21600.

 ** [MaximumRetryAttempts](#API_PutFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-response-MaximumRetryAttempts"></a>
El número máximo de veces que se debe volver a intentar cuando la función devuelve un error.  
Tipo: entero  
Rango válido: valor mínimo de 0. Valor máximo de 2.

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

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** InvalidParameterValueException **   
Uno de los parámetros de la solicitud no es válido.  
Código de estado HTTP: 400

 ** ResourceConflictException **   
El recurso ya existe o hay otra operación en marcha.  
Código de estado HTTP: 409

 ** ResourceNotFoundException **   
El recurso especificado en la solicitud no existe.  
Código de estado HTTP: 404

 ** ServiceException **   
El servicio AWS Lambda detectó un error interno.  
Código de estado HTTP: 500

 ** TooManyRequestsException **   
Se ha superado el límite de rendimiento de la solicitud. Para obtener más información, consulte [Cuotas de Lambda](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).  
Código de estado HTTP: 429

## Véase también
<a name="API_PutFunctionEventInvokeConfig_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [AWS SDK para .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [SDK de AWS para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/PutFunctionEventInvokeConfig)