EventSourceMappingConfiguration
Amazon资源和 Lambda 函数之间的映射。有关详细信息,请参阅CreateEventSourceMapping。
目录
- BatchSize
-
Lambda 从流或队列中提取并发送到函数的每个批处理中的最大记录数。Lambda 在单次调用中将批处理中的所有记录传递给函数,最高可传递同步调用的负载上限 (6 MB)。
默认值:因服务而异。对于 Amazon SQS,默认值为 10。对于所有其他服务,默认值为 100。
相关设置:当将
BatchSize
设置为一个大于 10 的值时,必须至少将MaximumBatchingWindowInSeconds
设置为 1。类型:整数
有效范围:最小值为 1。最大值为 10000。
必需:否
- BisectBatchOnFunctionError
-
(仅限流)如果函数返回错误,则将批次拆分为两批并重试。默认值为 False。
类型:布尔值
必需:否
- DestinationConfig
-
(仅限流)丢弃的记录的 Amazon SQS 队列或 Amazon SNS 主题目标。
类型:DestinationConfig 对象
必需:否
- 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
-
(流和 Amazon SQS)定义用于确定 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
-
(仅限流)应用于事件源映射的当前响应类型枚举的列表。
类型:字符串数组
数组成员:最少 0 项。最多 1 项。
有效值:
ReportBatchItemFailures
必需:否
- LastModified
-
上次更新事件源映射或其状态更改的日期(以 Unix 时间秒为单位)。
类型:Timestamp
必需:否
- LastProcessingResult
-
函数的最后一次 Lambda 调用结果。
类型:字符串
必需:否
- MaximumBatchingWindowInSeconds
-
(流和 Amazon SQS 标准队列)Lambda 在调用函数之前收集记录的最长时间,以秒为单位。
默认值:0
相关设置:当将
BatchSize
设置为一个大于 10 的值时,必须至少将MaximumBatchingWindowInSeconds
设置为 1。类型:整数
有效范围:最小值为 0。最大值为 300。
必需:否
- MaximumRecordAgeInSeconds
-
(仅限流)丢弃超过指定期限的记录。原定设置值为 -1,该值将最大年龄设置为无限。将该值设置为无限后,Lambda 永远不会删除旧记录。
类型:整数
有效范围:最小值为 -1。最大值为 604800。
必需:否
- MaximumRetryAttempts
-
(仅限流)在指定重试次数后丢弃记录。原定设置值为 -1,该值将最大重试次数设置为无限。将 MaximumRetryAttempts 设置为无限后,Lambda 会重试失败的记录,直到事件源中的记录过期为止。
类型:整数
有效范围:最小值为 -1。最大值为 10000。
必需:否
- ParallelizationFactor
-
(仅限流)每个分区中同时处理的批次数。默认值是 1。
类型:整数
有效范围:最小值为 1。最大值为 10。
必需:否
- Queues
-
(Amazon MQ) 要使用的 Amazon MQ 代理目标队列的名称。
类型:字符串数组
数组成员:固定数量为 1 项。
长度限制:最小长度为 1。长度上限为 1000。
模式:
[\s\S]*
必需:否
- SelfManagedEventSource
-
适用于事件源的自行管理 Apache Kafka 集群。
类型:SelfManagedEventSource 对象
必需:否
- SourceAccessConfigurations
-
用于保护与定义事件源的身份验证协议数组 VPC 组件或虚拟化主机。
类型:SourceAccessConfiguration 对象数组
数组成员:最少 0 项。最多 22 项。
必需:否
- StartingPosition
-
在流中开始读取数据的位置。对于 Amazon Kinesis、Amazon DynamoDB 及 Amazon MSK 流源是必需的。
AT_TIMESTAMP
仅支持 Amazon Kinesis Streams。类型:字符串
有效值:
TRIM_HORIZON | LATEST | AT_TIMESTAMP
必需:否
- StartingPositionTimestamp
-
将
StartingPosition
设置为AT_TIMESTAMP
时,开始读取的时间(以 Unix 时间秒为单位)。类型:Timestamp
必需:否
- State
-
事件源映射的状态。此状态可以是以下值之一:
Creating
、Enabling
、Enabled
、Disabling
、Disabled
、Updating
或Deleting
。类型:字符串
必需:否
- StateTransitionReason
-
表明是用户还是 Lambda 对事件源映射进行了最后一次更改。
类型:字符串
必需:否
- Topics
-
Kafka 主题的名称。
类型:字符串数组
数组成员:固定数量为 1 项。
长度限制:最小长度为 1。长度上限为 249。
模式:
^[^.]([a-zA-Z0-9\-_.]+)
必需:否
- TumblingWindowInSeconds
-
(仅限流)处理窗口的持续时间(以秒为单位)。范围为 1-900 秒。
类型:整数
有效范围:最小值为 0。最大值为 900。
必需:否
- UUID
-
事件源映射的标识符。
类型:字符串
必需:否
另请参阅
有关在特定语言的Amazon软件开发工具包中使用此 API 的更多信息,请参阅以下内容: