GetEventSourceMapping

事件源映射的标识符。

必需：是

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

类型：AmazonManagedKafkaEventSourceConfig 对象

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

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

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

类型：整数

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

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

类型：布尔值

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

类型：DestinationConfig 对象

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

类型：DocumentDBEventSourceConfig 对象

事件源的 Amazon Resource Name (ARN)。

类型：字符串

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

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

类型：FilterCriteria 对象

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

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

类型：字符串数组

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

有效值：ReportBatchItemFailures

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

类型：时间戳

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

类型：字符串

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。

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

类型：整数

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

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

类型：整数

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

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

类型：整数

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

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

类型：字符串数组

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

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

模式：[\s\S]*

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

类型：ScalingConfig 对象

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

类型：SelfManagedEventSource 对象

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

类型：SelfManagedKafkaEventSourceConfig 对象

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

类型：SourceAccessConfiguration 对象数组

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

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

类型：字符串

有效值：TRIM_HORIZON | LATEST | AT_TIMESTAMP

将 StartingPosition 设置为 AT_TIMESTAMP 时，即开始读取的时间（以 Unix 时间秒为单位）。StartingPositionTimestamp 不能是未来时间。

类型：时间戳

事件源映射的状态。此状态可以是以下值之一：Creating、Enabling、Enabled、Disabling、Disabled、Updating 或 Deleting。

类型：字符串

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

类型：字符串

Kafka 主题的名称。

类型：字符串数组

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

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

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

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

类型：整数

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

事件源映射的标识符。

类型：字符串

请求中的参数之一无效。

HTTP 状态代码：400

请求中指定的资源不存在。

HTTP 状态代码：404

Amazon Lambda 服务遇到了内部错误。

HTTP 状态代码：500

超出了请求吞吐量限制。有关更多信息，请参阅 Lambda 限额。

HTTP 状态代码：429