GetEventSourceMapping

傳回有關事件來源映射的詳細資訊。您可以從 ListEventSourceMappings 的輸出中獲取映射的識別符。

請求語法


GET /2015-03-31/event-source-mappings/UUID HTTP/1.1

URI 請求參數

請求會使用下列 URI 參數。

UUID

事件來源映射的識別符。

必要：是

請求主體

請求沒有請求主體。

回應語法


HTTP/1.1 200
Content-type: application/json

{
   "AmazonManagedKafkaEventSourceConfig": { 
      "ConsumerGroupId": "string"
   },
   "BatchSize": number,
   "BisectBatchOnFunctionError": boolean,
   "DestinationConfig": { 
      "OnFailure": { 
         "Destination": "string"
      },
      "OnSuccess": { 
         "Destination": "string"
      }
   },
   "DocumentDBEventSourceConfig": { 
      "CollectionName": "string",
      "DatabaseName": "string",
      "FullDocument": "string"
   },
   "EventSourceArn": "string",
   "FilterCriteria": { 
      "Filters": [ 
         { 
            "Pattern": "string"
         }
      ]
   },
   "FunctionArn": "string",
   "FunctionResponseTypes": [ "string" ],
   "LastModified": number,
   "LastProcessingResult": "string",
   "MaximumBatchingWindowInSeconds": number,
   "MaximumRecordAgeInSeconds": number,
   "MaximumRetryAttempts": number,
   "ParallelizationFactor": number,
   "Queues": [ "string" ],
   "ScalingConfig": { 
      "MaximumConcurrency": number
   },
   "SelfManagedEventSource": { 
      "Endpoints": { 
         "string" : [ "string" ]
      }
   },
   "SelfManagedKafkaEventSourceConfig": { 
      "ConsumerGroupId": "string"
   },
   "SourceAccessConfigurations": [ 
      { 
         "Type": "string",
         "URI": "string"
      }
   ],
   "StartingPosition": "string",
   "StartingPositionTimestamp": number,
   "State": "string",
   "StateTransitionReason": "string",
   "Topics": [ "string" ],
   "TumblingWindowInSeconds": number,
   "UUID": "string"
}

回應元素

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

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 卡夫卡事件來源) 一種組態物件，可在 Lambda 處理事件後指定事件的目的地。

類型：DestinationConfig 物件

DocumentDBEventSourceConfig

DocumentDB 事件來源的具體組態設定。

類型：DocumentDBEventSourceConfig 物件

EventSourceArn

事件來源的 Amazon Resource Name (ARN)。

類型：String

模式：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。

類型：String

模式：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