AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
Configures options for asynchronous invocation on a function, version, or alias. If a configuration already exists for a function, version, or alias, this operation overwrites it. If you exclude any settings, they are removed. To set one option without affecting existing settings for other options, use UpdateFunctionEventInvokeConfig.
By default, Lambda retries an asynchronous invocation twice if the function returns an error. It retains events in a queue for up to six hours. When an event fails all processing attempts or stays in the asynchronous invocation queue for too long, Lambda discards it. To retain discarded events, configure a dead-letter queue with UpdateFunctionConfiguration.
To send an invocation record to a queue, topic, function, or event bus, specify a destination. You can configure separate destinations for successful invocations (on-success) and events that fail all processing attempts (on-failure). You can configure destinations in addition to or instead of a dead-letter queue.
For .NET Core this operation is only available in asynchronous form. Please refer to PutFunctionEventInvokeConfigAsync.
Namespace: Amazon.Lambda
Assembly: AWSSDK.Lambda.dll
Version: 3.x.y.z
public abstract PutFunctionEventInvokeConfigResponse PutFunctionEventInvokeConfig( PutFunctionEventInvokeConfigRequest request )
Container for the necessary parameters to execute the PutFunctionEventInvokeConfig service method.
| Exception | Condition |
|---|---|
| InvalidParameterValueException | One of the parameters in the request is not valid. |
| ResourceConflictException | The resource already exists, or another operation is in progress. |
| ResourceNotFoundException | The resource specified in the request does not exist. |
| ServiceException | The Lambda service encountered an internal error. |
| TooManyRequestsException | The request throughput limit was exceeded. For more information, see Lambda quotas. |
The following example sets a maximum event age of one hour and disables retries for the specified function.
var response = client.PutFunctionEventInvokeConfig(new PutFunctionEventInvokeConfigRequest
{
FunctionName = "my-function",
MaximumEventAgeInSeconds = 3600,
MaximumRetryAttempts = 0
});
DestinationConfig destinationConfig = response.DestinationConfig;
string functionArn = response.FunctionArn;
DateTime lastModified = response.LastModified;
int maximumEventAgeInSeconds = response.MaximumEventAgeInSeconds;
int maximumRetryAttempts = response.MaximumRetryAttempts;
.NET Framework:
Supported in: 4.5, 4.0, 3.5