EventSourceMappingConfiguration - Amazon Lambda
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

EventSourceMappingConfiguration

Amazon资源和 Lambda 函数之间的映射。有关详细信息,请参阅 CreateEventSourceMapping

内容

AmazonManagedKafkaEventSourceConfig

Amazon Managed Streaming for Apache Kafka (Amazon MSK) 事件源的特定配置设置。

类型:AmazonManagedKafkaEventSourceConfig 对象

必需:否

BatchSize

Lambda 从流或队列中提取并发送到函数的每个批处理中的最大记录数。Lambda 在单次调用中将批处理中的所有记录传递给函数,最高可传递同步调用的负载上限 (6 MB)。

默认值:因服务而异。对于 Amazon SQS,默认值为 10。对于所有其他服务,默认值为 100。

相关设置:当将 BatchSize 设置为一个大于 10 的值时,必须至少将 MaximumBatchingWindowInSeconds 设置为 1。

类型:整数

有效范围:最小值为 1。最大值为 10000。

必需:否

BisectBatchOnFunctionError

(仅限 Kinesis 和 DynamoDB Streams)如果函数返回错误,则将分处理拆分为两个并重试。默认值为 False。

类型:布尔值

必需:否

DestinationConfig

(仅限 Kinesis、DynamoDB Streams、Amazon MSK 和自行管理的 Apache Kafka 事件源)用于在 Lambda 处理事件后指定事件目标的配置对象。

类型:DestinationConfig 对象

必需:否

DocumentDBEventSourceConfig

DocumentB 事件源的特定配置设置。

类型:DocumentDBEventSourceConfig 对象

必需:否

EventSourceArn

事件源的 Amazon Resource Name (ARN)。

类型:字符串

模式:arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)

必需:否

FilterCriteria

定义用于确定 Lambda 是否应处理事件的筛选条件的对象。有关更多信息,请参阅 Lambda 事件筛选

类型:FilterCriteria 对象

必需:否

FunctionArn

Lambda 函数的 ARN。

类型:字符串

模式: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-_]+))?

必需:否

FunctionResponseTypes

(Kinesis、DynamoDB Streams 和 Amazon SQS)应用于事件源映射的当前响应类型枚举的列表。

类型:字符串数组

数组成员:最少 0 项。最多 1 项。

有效值:ReportBatchItemFailures

必需:否

LastModified

上次更新事件源映射或其状态更改的日期(以 Unix 时间秒为单位)。

类型:Timestamp

必需:否

LastProcessingResult

函数的最后一次 Lambda 调用结果。

类型:字符串

必需:否

MaximumBatchingWindowInSeconds

Lambda 在调用函数之前收集记录的最长时间,以秒为单位。您可以将 MaximumBatchingWindowInSeconds 配置为介于 0 秒到 300 秒之间的任意值,以秒的整数倍调整。

对于流和 Amazon SQS 事件源,默认批处理时段为 0 秒。对于 Amazon MSK、自行管理的 Apache Kafka、Amazon MQ 和 DocumentDB 事件源,默认批处理时间窗口为 500 毫秒。请注意,由于您只能以秒为增量更改 MaximumBatchingWindowInSeconds,所以在更改后无法恢复到 500 毫秒的默认批处理时段。要恢复原定设置的批处理时段,必须创建新的事件源映射。

相关设置:对于流和 Amazon SQS 事件源,当将 BatchSize 设置为大于 10 的值时,必须将 MaximumBatchingWindowInSeconds 至少设置为 1。

类型:整数

有效范围:最小值为 0。最大值为 300。

必需:否

MaximumRecordAgeInSeconds

(仅限 Kinesis 和 DynamoDB Streams)丢弃超过指定龄期的记录。原定设置值为 -1,该值将最大年龄设置为无限。将该值设置为无限后,Lambda 永远不会删除旧记录。

注意

最长记录期限的最小有效值为 60 秒。尽管小于 60 和大于 -1 的值都在参数的绝对范围内,但不允许使用它们

类型:整数

有效范围:最小值为 -1。最大值为 604800。

必需:否

MaximumRetryAttempts

(仅限 Kinesis 和 DynamoDB Streams)在指定重试次数后丢弃记录。原定设置值为 -1,该值将最大重试次数设置为无限。将 MaximumRetryAttempts 设置为无限后,Lambda 会重试失败的记录,直到事件源中的记录过期为止。

类型:整数

有效范围:最小值为 -1。最大值为 10000。

必需:否

ParallelizationFactor

(仅限 Kinesis 和 DynamoDB Streams)每个分片中同时处理的批处理数。默认值是 1。

类型:整数

有效范围:最小值为 1。最大值为 10。

必需:否

Queues

(Amazon MQ) 要使用的 Amazon MQ 代理目标队列的名称。

类型:字符串数组

数组成员:固定数量为 1 项。

长度限制:最小长度为 1。最大长度为 1000。

模式:[\s\S]*

必需:否

ScalingConfig

(仅限 Amazon SQS)事件源的扩缩配置。有关更多信息,请参阅为 Amazon SQS 事件源配置最大并发

类型:ScalingConfig 对象

必需:否

SelfManagedEventSource

适用于事件源的自行管理 Apache Kafka 集群。

类型:SelfManagedEventSource 对象

必需:否

SelfManagedKafkaEventSourceConfig

自行管理的 Apache Kafka 事件源的特定配置设置。

类型:SelfManagedKafkaEventSourceConfig 对象

必需:否

SourceAccessConfigurations

用于保护与定义事件源的身份验证协议数组 VPC 组件或虚拟化主机。

类型:SourceAccessConfiguration 对象数组

数组成员:最少 0 项。最多 22 项。

必需:否

StartingPosition

在流中开始读取数据的位置。对于 Amazon Kinesis 和 Amazon DynamoDB Streams 事件源,为必需项。仅 Amazon Kinesis 流、Amazon DocumentDB、Amazon MSK 和自行管理的 Apache Kafka 支持 AT_TIMESTAMP

类型:字符串

有效值:TRIM_HORIZON | LATEST | AT_TIMESTAMP

必需:否

StartingPositionTimestamp

StartingPosition 设置为 AT_TIMESTAMP 时,即开始读取的时间(以 Unix 时间秒为单位)。StartingPositionTimestamp 不能是未来时间。

类型:时间戳

必需:否

State

事件源映射的状态。此状态可以是以下值之一:CreatingEnablingEnabledDisablingDisabledUpdatingDeleting

类型:字符串

必需:否

StateTransitionReason

表明是用户还是 Lambda 对事件源映射进行了最后一次更改。

类型:字符串

必需:否

Topics

Kafka 主题的名称。

类型:字符串数组

数组成员:固定数量为 1 项。

长度限制:最小长度为 1。长度上限为 249。

模式:^[^.]([a-zA-Z0-9\-_.]+)

必需:否

TumblingWindowInSeconds

(仅限 Kinesis 和 DynamoDB Streams)DynamoDB 和 Kinesis Streams 事件源的处理时间窗口(以秒为单位)。值为 0 秒表示无滑动时间窗口。

类型:整数

有效范围:最小值为 0。最大值为 900。

必需:否

UUID

事件源映射的标识符。

类型:字符串

必需:否

另请参阅

有关在特定语言的 Amazon SDK 中使用此 API 的更多信息,请参阅以下内容: