リクエストの構文 URI リクエストパラメータリクエストボディレスポンスの構文レスポンス要素エラー以下の資料も参照してください。

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"
      }
   },
   "EventSourceArn": "string",
   "FilterCriteria": { 
      "Filters": [ 
         { 
            "Pattern": "string"
         }
      ]
   },
   "FunctionArn": "string",
   "FunctionResponseTypes": [ "string" ],
   "LastModified": number,
   "LastProcessingResult": "string",
   "MaximumBatchingWindowInSeconds": number,
   "MaximumRecordAgeInSeconds": number,
   "MaximumRetryAttempts": number,
   "ParallelizationFactor": number,
   "Queues": [ "string" ],
   "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 です。最大値は 10,000 です。

BisectBatchOnFunctionError

(ストリームのみ) 関数がエラーを返した場合は、バッチを 2 つに分割して再試行します。デフォルト値は false です。

型: ブール値

DestinationConfig

(ストリームのみ) 廃棄されたレコードの Amazon SQS キューまたは Amazon SNS トピックの送信先。

タイプ: DestinationConfig オブジェクト

EventSourceArn

イベントソースの Amazon リソースネーム (ARN)。

型: 文字列

Pattern: 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。

型: 文字列

Pattern: 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

(ストリーミングと Amazon SQS) イベントソースマッピングに適用されている現在のレスポンスタイプの列挙型のリスト。

型: 文字列の配列

配列メンバー: 最小数は 0 項目です。最大数は 1 項目です。

有効な ReportBatchItemFailures 値:

LastModified

イベントソースマッピングが最後に更新された日付、またはその状態が変更された日付 (Unix タイム秒単位)。

タイプ: タイムスタンプ

LastProcessingResult

関数の最後の Lambda 呼び出しの結果。

型: 文字列

MaximumBatchingWindowInSeconds

Lambda が関数を呼び出すまで費やすレコード収集の最大時間 (秒)。MaximumBatchingWindowInSeconds は、秒単位で 0 秒から 300 秒までの任意の値に設定できます。

ストリームと Amazon SQS イベントソースの場合、バッチ処理ウィンドウはデフォルトで 0 秒に設定されます。Amazon MSK、セルフマネージド Apache Kafka、および Amazon MQ イベントソースの場合、バッチ処理ウィンドウはデフォルトで 500 ミリ秒に設定されます。MaximumBatchingWindowInSeconds は秒単位の増分でしか変更できないため、バッチ処理ウィンドウのデフォルト値 (500 ミリ秒) を変更すると、元に戻せなくなることに注意してください。デフォルトのバッチ処理ウィンドウを復元するには、新しいイベントソースマッピングを作成する必要があります。

関連設定: ストリームとAmazon SQS イベントソースの場合、BatchSize を 10 より大きい値に設定する場合は、MaximumBatchingWindowInSeconds を 1 以上に設定する必要があります。

型: 整数

値の範囲: 最小値は 0 です。最大値は 300 です。

MaximumRecordAgeInSeconds