# CreateEventSourceMapping イベントソースと AWS Lambda 関数間のマッピングを作成します。Lambda は、イベントソースから項目を読み込み、関数を呼び出します。さまざまなイベントソースの設定方法の詳細については、以下のトピックを参照してください。 + [ Amazon DynamoDB Streams](https://docs.aws.amazon.com/lambda/latest/dg/with-ddb.html#services-dynamodb-eventsourcemapping) + [ Amazon Kinesis](https://docs.aws.amazon.com/lambda/latest/dg/with-kinesis.html#services-kinesis-eventsourcemapping) + [ Amazon SQS](https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html#events-sqs-eventsource) + [ Amazon MQ と RabbitMQ](https://docs.aws.amazon.com/lambda/latest/dg/with-mq.html#services-mq-eventsourcemapping) + [ Amazon MSK](https://docs.aws.amazon.com/lambda/latest/dg/with-msk.html) + [ Apache Kafka](https://docs.aws.amazon.com/lambda/latest/dg/kafka-smaa.html) + [ Amazon DocumentDB](https://docs.aws.amazon.com/lambda/latest/dg/with-documentdb.html) 以下のエラー処理オプションは、ストリーミングソース (DynamoDB および Kinesis) でのみ使用できます。 + `BisectBatchOnFunctionError` – 関数がエラーを返す場合は、バッチを 2 つに分割して再試行します。 + `DestinationConfig` – 廃棄されたレコードを Amazon SQS キューまたは Amazon SNS トピックに送信します。 + `MaximumRecordAgeInSeconds` – 指定された経過期間よりも古いレコードを廃棄します。デフォルト値は無制限 (-1) です。無制限 (-1) に設定すると、失敗したレコードはレコードの有効期限が切れるまで再試行されます。 + `MaximumRetryAttempts` – 指定された再試行数の後でレコードを廃棄します。デフォルト値は無制限 (-1) です。無制限 (-1) に設定すると、失敗したレコードはレコードの有効期限が切れるまで再試行されます。 + `ParallelizationFactor` – 各シャードからの複数のバッチを同時に処理します。各イベントソースに適用される設定パラメータについては、次のトピックを参照してください。 + [ Amazon DynamoDB Streams](https://docs.aws.amazon.com/lambda/latest/dg/with-ddb.html#services-ddb-params) + [ Amazon Kinesis](https://docs.aws.amazon.com/lambda/latest/dg/with-kinesis.html#services-kinesis-params) + [ Amazon SQS](https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html#services-sqs-params) + [ Amazon MQ と RabbitMQ](https://docs.aws.amazon.com/lambda/latest/dg/with-mq.html#services-mq-params) + [ Amazon MSK](https://docs.aws.amazon.com/lambda/latest/dg/with-msk.html#services-msk-parms) + [ Apache Kafka](https://docs.aws.amazon.com/lambda/latest/dg/with-kafka.html#services-kafka-parms) + [ Amazon DocumentDB](https://docs.aws.amazon.com/lambda/latest/dg/with-documentdb.html#docdb-configuration) ## リクエストの構文 ``` POST /2015-03-31/event-source-mappings/ HTTP/1.1 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" }, "Enabled": boolean, "EventSourceArn": "string", "FilterCriteria": { "Filters": [ { "Pattern": "string" } ] }, "FunctionName": "string", "FunctionResponseTypes": [ "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, "Topics": [ "string" ], "TumblingWindowInSeconds": number } ``` ## URI リクエストパラメータリクエストでは URI パラメータを使用しません。 ## リクエストボディリクエストは以下の JSON 形式のデータを受け入れます。 ** [AmazonManagedKafkaEventSourceConfig](#API_CreateEventSourceMapping_RequestSyntax) ** Amazon Managed Streaming for Apache Kafka (Amazon MSK) のイベントソースに関する特定の設定です。型: [AmazonManagedKafkaEventSourceConfig](API_AmazonManagedKafkaEventSourceConfig.md) オブジェクト必須: いいえ ** [BatchSize](#API_CreateEventSourceMapping_RequestSyntax) ** Lambda がストリームまたはキューから取り出し、関数に送信する各バッチ内の最大レコード数。Lambda は、同期呼び出しのペイロード上限 (6 MB) まで、バッチ内のすべてのレコードを単一の呼び出しで関数に渡します。 + **Amazon Kinesis** – デフォルトで 100。最大 10,000。 + **Amazon DynamoDB Streams** – デフォルトで 100。最大 10,000。 + **Amazon Simple Queue Service** – デフォルトで 10。標準キューの場合、最大値は 10,000 です。FIFO キューの場合、最大値は 10 です。 + **Amazon Managed Streaming for Apache Kafka** - デフォルトで 100。最大 10,000。 + **セルフマネージド型の Apache Kafka** – デフォルトで 100。最大 10,000。 + **Amazon MQ (ActiveMQ と RabbitMQ)** – デフォルトで 100。最大 10,000。 + **DocumentDB** – デフォルトは 100 です。最大 10,000。タイプ: 整数値の範囲: 最小値は 1 です。最大値は 10,000 です。必須: いいえ ** [BisectBatchOnFunctionError](#API_CreateEventSourceMapping_RequestSyntax) ** (Kinesis および DynamoDB Streams のみ) 関数がエラーを返した場合は、バッチを 2 つに分割して再試行します。型: ブール必須: いいえ ** [DestinationConfig](#API_CreateEventSourceMapping_RequestSyntax) ** (Kinesis、DynamoDB Streams、Amazon MSK、およびセルフマネージド Kafka のみ) Lambda がイベントを処理した後のイベントの送信先を指定する設定オブジェクト。型: [DestinationConfig](API_DestinationConfig.md) オブジェクト必須: いいえ ** [DocumentDBEventSourceConfig](#API_CreateEventSourceMapping_RequestSyntax) ** DocumentDB イベントソースの特定の構成設定。型: [DocumentDBEventSourceConfig](API_DocumentDBEventSourceConfig.md) オブジェクト必須: いいえ ** [Enabled](#API_CreateEventSourceMapping_RequestSyntax) ** true の場合、イベントソースマッピングがアクティブになります。false の場合、Lambda がポーリングと呼び出しを一時停止します。デフォルト: True 型: ブール必須: いいえ ** [EventSourceArn](#API_CreateEventSourceMapping_RequestSyntax) ** イベントソースの Amazon リソースネーム (ARN) です。 + **Amazon Kinesis** – データストリームまたはストリームコンシューマーの ARN。 + **Amazon DynamoDB Streams** – ストリームの ARN。 + **Amazon Simple Queue Service** – キューの ARN。 + **Amazon Managed Streaming for Apache Kafka** — クラスターの ARN または VPC 接続の ARN ([クロスアカウントイベントソースマッピング](https://docs.aws.amazon.com/lambda/latest/dg/with-msk.html#msk-multi-vpc)用)。 + **Amazon MQ** – ブローカーの ARN。 + **Amazon DocumentDB** – DocumentDB 変更ストリームの ARN。型: 文字列パターン: `arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)` 必須: いいえ ** [FilterCriteria](#API_CreateEventSourceMapping_RequestSyntax) ** Lambda がイベントを処理する必要があるかどうかを判断するフィルター条件を定義するオブジェクトです。詳細については、[Lambda イベントフィルタリング](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html)を参照してください。型: [FilterCriteria](API_FilterCriteria.md) オブジェクト必須: いいえ ** [FunctionName](#API_CreateEventSourceMapping_RequestSyntax) ** Lambda 関数の名前 **名前の形式** + **関数名** – `MyFunction`。 + **関数 ARN** – `arn:aws:lambda:us-west-2:123456789012:function:MyFunction`。 + **バージョンまたはエイリアス ARN** – `arn:aws:lambda:us-west-2:123456789012:function:MyFunction:PROD`。 + **部分的な ARN** – `123456789012:function:MyFunction`。完全な ARN にのみ適用される長さの制限関数名のみを指定する場合、64 文字の長さに制限されます。型: 文字列長さの制限: 最小長は 1 です。最大長は 140 です。 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](#API_CreateEventSourceMapping_RequestSyntax) ** (Kinesis、DynamoDB Streams、Amazon SQS) イベントソースマッピングに適用されている現在のレスポンスタイプの列挙型のリスト。型: 文字列の配列配列メンバー: 最小数は 0 項目です。最大数は 1 項目です。有効な値: `ReportBatchItemFailures` 必須：いいえ ** [MaximumBatchingWindowInSeconds](#API_CreateEventSourceMapping_RequestSyntax) ** 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](#API_CreateEventSourceMapping_RequestSyntax) ** (Kinesis および DynamoDB Streams のみ) 指定した経過期間よりも古いレコードを破棄します。デフォルト値は無制限 (-1) です。タイプ: 整数値の範囲: 最小値は -1 です。最大値は 604,800 です。必須: いいえ ** [MaximumRetryAttempts](#API_CreateEventSourceMapping_RequestSyntax) ** (Kinesis および DynamoDB Streams のみ) 指定した再試行数の後でレコードを破棄します。デフォルト値は無制限 (-1) です。無制限 (-1) に設定すると、失敗したレコードはレコードの有効期限が切れるまで再試行されます。型: 整数値の範囲: 最小値は -1 です。最大値は 10,000 です。必須: いいえ ** [ParallelizationFactor](#API_CreateEventSourceMapping_RequestSyntax) ** (Kinesis および DynamoDB Streams のみ) 各シャードから同時に処理するバッチの数。型: 整数値の範囲: 最小値は 1 です。最大値は 10 です。必須: いいえ ** [Queues](#API_CreateEventSourceMapping_RequestSyntax) ** (MQ) 消費する Amazon MQ ブローカーの送信先キューの名前。タイプ: 文字列の配列配列メンバー: 定数は 1 項目です。長さの制限: 最小長は 1 です。最大長は 1,000 です。パターン: `[\s\S]*` 必須: いいえ ** [ScalingConfig](#API_CreateEventSourceMapping_RequestSyntax) ** (Amazon SQS のみ) イベントソースのスケーリング設定です。詳細については、「[Configuring maximum concurrency for Amazon SQS event sources](https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html#events-sqs-max-concurrency)」(Amazon SQS イベントソースの最大同時実行数の設定) を参照してください。型: [ScalingConfig](API_ScalingConfig.md) オブジェクト必須: いいえ ** [SelfManagedEventSource](#API_CreateEventSourceMapping_RequestSyntax) ** レコードを受信するセルフマネージド Apache Kafka クラスター。型: [SelfManagedEventSource](API_SelfManagedEventSource.md) オブジェクト必須: いいえ ** [SelfManagedKafkaEventSourceConfig](#API_CreateEventSourceMapping_RequestSyntax) ** セルフマネージド Apache Kafka イベントソースの特定の設定。型: [SelfManagedKafkaEventSourceConfig](API_SelfManagedKafkaEventSourceConfig.md) オブジェクト必須: いいえ ** [SourceAccessConfigurations](#API_CreateEventSourceMapping_RequestSyntax) ** 認証プロトコルの配列またはイベントソースの保護に必要な VPC コンポーネント。タイプ: [SourceAccessConfiguration](API_SourceAccessConfiguration.md) オブジェクトの配列配列メンバー: 最小数は 0 項目です。最大数は 22 項目です。必須: いいえ ** [StartingPosition](#API_CreateEventSourceMapping_RequestSyntax) ** 読み取りを開始するストリームの場所です。Amazon Kinesis および Amazon DynamoDB Streams イベントソースに必要です。`AT_TIMESTAMP` は、Amazon Kinesis ストリーム、Amazon DocumentDB、Amazon MSK、およびセルフマネージド Apache Kafka でのみサポートされます。型: 文字列有効な値: `TRIM_HORIZON | LATEST | AT_TIMESTAMP` 必須：いいえ ** [StartingPositionTimestamp](#API_CreateEventSourceMapping_RequestSyntax) ** `StartingPosition` が `AT_TIMESTAMP` に設定されている場合、読み取りを開始する時間 (Unix 時間単位) です。`StartingPositionTimestamp` を現在よりも先の日時に指定することはできません。タイプ：タイムスタンプ必須: いいえ ** [Topics](#API_CreateEventSourceMapping_RequestSyntax) ** Kafka トピックの名前。タイプ: 文字列の配列配列メンバー: 定数は 1 項目です。長さの制限: 最小長は 1 です。最大長は 249 です。パターン: `^[^.]([a-zA-Z0-9\-_.]+)` 必須: いいえ ** [TumblingWindowInSeconds](#API_CreateEventSourceMapping_RequestSyntax) ** (Kinesis および DynamoDB Streams のみ) DynamoDB および Kinesis Streams イベントソースの処理ウィンドウの期間 (秒)。値が 0 秒である場合、タンブリングウィンドウがないことを示します。型: 整数値の範囲: 最小値は 0 です。最大値は 900 です。必須: いいえ ## レスポンスの構文 ``` HTTP/1.1 202 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 202 レスポンスが返されます。サービスから以下のデータが JSON 形式で返されます。 ** [AmazonManagedKafkaEventSourceConfig](#API_CreateEventSourceMapping_ResponseSyntax) ** Amazon Managed Streaming for Apache Kafka (Amazon MSK) のイベントソースに関する特定の設定です。型: [AmazonManagedKafkaEventSourceConfig](API_AmazonManagedKafkaEventSourceConfig.md) オブジェクト ** [BatchSize](#API_CreateEventSourceMapping_ResponseSyntax) ** Lambda がストリームまたはキューから取り出し、関数に送信する各バッチ内の最大レコード数。Lambda は、同期呼び出しのペイロード上限 (6 MB) まで、バッチ内のすべてのレコードを単一の呼び出しで関数に渡します。デフォルト値: サービスによって異なります。Amazon SQS の場合、デフォルトは 10 です。他のすべてのサービスでは、デフォルトは 100 です。関連設定: `BatchSize` を 10 より大きい値に設定する場合は、`MaximumBatchingWindowInSeconds` を 1 以上に設定する必要があります。型: 整数値の範囲: 最小値は 1 です。最大値は 10,000 です。 ** [BisectBatchOnFunctionError](#API_CreateEventSourceMapping_ResponseSyntax) ** (Kinesis および DynamoDB Streams のみ) 関数がエラーを返した場合は、バッチを 2 つに分割して再試行します。デフォルト値は false です。型: ブール ** [DestinationConfig](#API_CreateEventSourceMapping_ResponseSyntax) ** (Kinesis、DynamoDB Streams、Amazon MSK、およびセルフマネージド Apache Kafka イベントソースのみ) Lambda がイベントを処理した後のイベントの送信先を指定する設定オブジェクト。型: [DestinationConfig](API_DestinationConfig.md) オブジェクト ** [DocumentDBEventSourceConfig](#API_CreateEventSourceMapping_ResponseSyntax) ** DocumentDB イベントソースの特定の構成設定。型: [DocumentDBEventSourceConfig](API_DocumentDBEventSourceConfig.md) オブジェクト ** [EventSourceArn](#API_CreateEventSourceMapping_ResponseSyntax) ** イベントソースの Amazon リソースネーム (ARN)。型: 文字列パターン: `arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)` ** [FilterCriteria](#API_CreateEventSourceMapping_ResponseSyntax) ** Lambda がイベントを処理する必要があるかどうかを判断するフィルター条件を定義するオブジェクトです。詳細については、[Lambda イベントフィルタリング](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html)を参照してください。型: [FilterCriteria](API_FilterCriteria.md) オブジェクト ** [FunctionArn](#API_CreateEventSourceMapping_ResponseSyntax) ** 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](#API_CreateEventSourceMapping_ResponseSyntax) ** (Kinesis、DynamoDB Streams、Amazon SQS) イベントソースマッピングに適用されている現在のレスポンスタイプの列挙型のリスト。型: 文字列の配列配列メンバー: 最小数は 0 項目です。最大数は 1 項目です。有効な値: `ReportBatchItemFailures` ** [LastModified](#API_CreateEventSourceMapping_ResponseSyntax) ** イベントソースマッピングが最後に更新された日付、またはその状態が変更された日付 (Unix タイム秒単位)。型: Timestamp ** [LastProcessingResult](#API_CreateEventSourceMapping_ResponseSyntax) ** 関数の最後の Lambda 呼び出しの結果。型: 文字列 ** [MaximumBatchingWindowInSeconds](#API_CreateEventSourceMapping_ResponseSyntax) ** 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](#API_CreateEventSourceMapping_ResponseSyntax) ** (Kinesis および DynamoDB Streams のみ) 指定した経過期間よりも古いレコードを破棄します。デフォルト値は -1 で、最大経過時間は無限です。値が無限に設定されている場合、Lambda が古いレコードを廃棄することはありません。最大レコード保存期間の最小有効値は 60 秒です。60 未満で -1 より大きい値はパラメータの絶対範囲内ですが、指定できません。型: 整数値の範囲: 最小値は -1 です。最大値は 604,800 です。 ** [MaximumRetryAttempts](#API_CreateEventSourceMapping_ResponseSyntax) ** (Kinesis および DynamoDB Streams のみ) 指定した再試行数の後でレコードを破棄します。デフォルト値の -1 により、最大再試行回数は無限に設定されます。MaximumRetryAttempts が無限の場合、Lambda はイベントソースでレコードの有効期限が切れるまで、失敗したレコードを再試行します。タイプ: 整数値の範囲: 最小値は -1 です。最大値は 10,000 です。 ** [ParallelizationFactor](#API_CreateEventSourceMapping_ResponseSyntax) ** (Kinesis および DynamoDB Streams のみ) 各シャードから同時に処理するバッチの数。デフォルト値は 1 です。タイプ: 整数値の範囲: 最小値は 1 です。最大値は 10 です。 ** [Queues](#API_CreateEventSourceMapping_ResponseSyntax) ** (Amazon MQ) 消費する Amazon MQ ブローカーの送信先キューの名前。タイプ: 文字列の配列配列メンバー: 定数は 1 項目です。長さの制限: 最小長は 1 です。最大長は 1,000 です。パターン: `[\s\S]*` ** [ScalingConfig](#API_CreateEventSourceMapping_ResponseSyntax) ** (Amazon SQS のみ) イベントソースのスケーリング設定です。詳細については、「[Configuring maximum concurrency for Amazon SQS event sources](https://docs.aws.amazon.com/lambda/latest/dg/with-sqs.html#events-sqs-max-concurrency)」(Amazon SQS イベントソースの最大同時実行数の設定) を参照してください。型: [ScalingConfig](API_ScalingConfig.md) オブジェクト ** [SelfManagedEventSource](#API_CreateEventSourceMapping_ResponseSyntax) ** イベントソースのセルフマネージド Apache Kafka クラスター。型: [SelfManagedEventSource](API_SelfManagedEventSource.md) オブジェクト ** [SelfManagedKafkaEventSourceConfig](#API_CreateEventSourceMapping_ResponseSyntax) ** セルフマネージド Apache Kafka イベントソースの特定の設定。型: [SelfManagedKafkaEventSourceConfig](API_SelfManagedKafkaEventSourceConfig.md) オブジェクト ** [SourceAccessConfigurations](#API_CreateEventSourceMapping_ResponseSyntax) ** 認証プロトコルの配列、VPC コンポーネント、イベントソースを保護して定義する仮想ホスト。タイプ: [SourceAccessConfiguration](API_SourceAccessConfiguration.md) オブジェクトの配列配列メンバー: 最小数は 0 項目です。最大数は 22 項目です。 ** [StartingPosition](#API_CreateEventSourceMapping_ResponseSyntax) ** 読み取りを開始するストリームの場所です。Amazon Kinesis および Amazon DynamoDB Streams イベントソースに必要です。`AT_TIMESTAMP` は、Amazon Kinesis ストリーム、Amazon DocumentDB、Amazon MSK、およびセルフマネージド Apache Kafka でのみサポートされます。型: 文字列有効な値: `TRIM_HORIZON | LATEST | AT_TIMESTAMP` ** [StartingPositionTimestamp](#API_CreateEventSourceMapping_ResponseSyntax) ** `StartingPosition` が `AT_TIMESTAMP` に設定されている場合、読み取りを開始する時間 (Unix 時間単位) です。`StartingPositionTimestamp` を現在よりも先の日時に指定することはできません。型: Timestamp ** [State](#API_CreateEventSourceMapping_ResponseSyntax) ** イベントソースマッピングの状態。次のうちの 1 つになる可能性があります: `Creating`、`Enabling`、`Enabled`、`Disabling`、`Disabled`、`Updating`、`Deleting`。型: 文字列 ** [StateTransitionReason](#API_CreateEventSourceMapping_ResponseSyntax) ** ユーザーまたは Lambda がイベントソースマッピングを最後に変更したかどうかを示します。型: 文字列 ** [Topics](#API_CreateEventSourceMapping_ResponseSyntax) ** Kafka トピックの名前。タイプ: 文字列の配列配列メンバー: 定数は 1 項目です。長さの制限: 最小長は 1 です。最大長は 249 です。パターン: `^[^.]([a-zA-Z0-9\-_.]+)` ** [TumblingWindowInSeconds](#API_CreateEventSourceMapping_ResponseSyntax) ** (Kinesis および DynamoDB Streams のみ) DynamoDB および Kinesis Streams イベントソースの処理ウィンドウの期間 (秒)。値が 0 秒である場合、タンブリングウィンドウがないことを示します。型: 整数値の範囲: 最小値は 0 です。最大値は 900 です。 ** [UUID](#API_CreateEventSourceMapping_ResponseSyntax) ** イベントソースマッピングの識別子。型: 文字列 ## エラーすべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** InvalidParameterValueException ** リクエストに含まれているパラメータの 1 つが無効です。 HTTP ステータスコード：400 ** ResourceConflictException ** リソースが既に存在しているか、別のオペレーションが進行中です。 HTTP ステータスコード: 409 ** ResourceNotFoundException ** リクエストで指定されたリソースは存在しません。 HTTP ステータスコード: 404 ** ServiceException ** AWS Lambda サービスで内部エラーが発生しました。 HTTP ステータスコード: 500 ** TooManyRequestsException ** リクエストスループット制限を超えました。詳細については、「[Lambda クォータ](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests)」を参照してください。 HTTP ステータスコード: 429 ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + 「[AWS コマンドラインインターフェイス](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/CreateEventSourceMapping)」 + 「[AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/CreateEventSourceMapping)」 + 「[AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/CreateEventSourceMapping)」 + 「[AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/CreateEventSourceMapping)」 + 「[AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/CreateEventSourceMapping)」 + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/CreateEventSourceMapping) + 「[AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/CreateEventSourceMapping)」 + 「[AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/CreateEventSourceMapping)」 + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/CreateEventSourceMapping)