Skip to content

Lambda  >  Structures  >  OnFailure

OnFailure

Structure Class

OnFailure dataclass

A destination for events that failed processing. For more information, see Adding a destination.

Attributes

destination class-attribute instance-attribute 
destination: str | None = None

The Amazon Resource Name (ARN) of the destination resource.

To retain records of failed invocations from Kinesis, DynamoDB, self-managed Apache Kafka, or Amazon MSK, you can configure an Amazon SNS topic, Amazon SQS queue, Amazon S3 bucket, or Kafka topic as the destination.

Note

Amazon SNS destinations have a message size limit of 256 KB. If the combined size of the function request and response payload exceeds the limit, Lambda will drop the payload when sending OnFailure event to the destination. For details on this behavior, refer to Retaining records of asynchronous invocations.

To retain records of failed invocations from Kinesis, DynamoDB, self-managed Kafka or Amazon MSK, you can configure an Amazon SNS topic, Amazon SQS queue, or Amazon S3 bucket as the destination.