View a markdown version of this page

Lambda イベントソースマッピング実行ブロック - Amazon Application Recovery Controller (ARC)
設定仕組み

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Lambda イベントソースマッピング実行ブロック

Lambda イベントソースマッピング実行ブロックを使用すると、復旧オペレーションの一部として Lambda イベントソースマッピングを有効または無効にできます。イベントソースマッピングは、Amazon Kinesis、Amazon DynamoDB Streams、Amazon Simple Queue Service、Amazon Managed Streaming for Apache Kafka (Amazon MSK) などのイベントソースから読み取り、レコードのバッチで Lambda 関数を呼び出す Lambda リソースです。

注記

この実行ブロックは、イベントソースマッピングのみを管理します。Amazon S3、Amazon Simple Notification Service、Amazon Simple Email Service などのサービスからのサービス側のイベント駆動型呼び出しである Lambda トリガーは、この実行ブロックではサポートされていません。

設定

このブロックは、一度に 1 つのイベントソースマッピングリソースに対して 1 つのアクションを実行 (有効または無効に) するように設定できます。

Lambda イベントソースマッピング実行ブロックを設定するには、次の値を入力します。

重要

実行ブロックを設定する前に、プランの実行ロールに正しい IAM ポリシーが設定されていることを確認してください。詳細については、「Lambda イベントソースマッピング実行ブロックサンプルポリシー」を参照してください。

  1. ステップ名: 名前を入力します。

  2. ステップの説明 (オプション): ステップの説明を入力します。

  3. アクション: このステップの実行時にイベントソースマッピングを有効または無効にするかどうかを選択します。

  4. Region-1 をアクティブ化/非アクティブ化するときに有効または無効にする Lambda イベントソースマッピング ARN: Region-1 をアクティブ化/非アクティブ化するときに実行するイベントソースマッピング ARN を入力します。

  5. Region-2 をアクティブ化/非アクティブ化するときに有効または無効にする Lambda イベントソースマッピング ARN: Region-2 をアクティブ化/非アクティブ化するときに実行するイベントソースマッピング ARN を入力します。

  6. タイムアウト: タイムアウト値を入力します。

  7. 不正な実行: 不正な (計画外の) 実行中にこの実行ブロックをスキップするかどうかを選択します。

次に、[ステップを保存] を選択します。

イベントソースマッピングは、プランが設定されているリージョンのいずれかに存在する必要があります。ただし、アクティブ化するリージョンとイベントソースマッピングが実行されるリージョンは一致する必要はありません。

たとえば、他のリージョンをアクティブ化するときに、非アクティブ化されたリージョンでイベント処理を無効にするには:

  • us-west-2 をアクティブ化するときに無効にするイベントソースマッピング ARN: arn:aws:lambda:us-east-1:123456789012:event-source-mapping:uuid-1。

  • us-east-1 をアクティブ化するときに無効にするイベントソースマッピング ARN: arn:aws:lambda:us-west-2:123456789012:event-source-mapping:uuid-2。

このブロックは、正常な実行モードと不正な実行モードの両方をサポートします。Ungraceful モードは、計画外のフェイルオーバーシナリオ向けに設計されています。通常、ステップが非アクティブ化されたリージョンでアクションを実行するように設定されている場合、この実行ブロックで不正な実行中にステップのスキップを有効にします。フェイルオーバー中に、リージョンの非アクティブ化でイベントの処理を停止し、リージョンのアクティブ化で処理を開始できます。これを実現するには、2 つの Lambda イベントソースマッピング実行ブロックをシーケンスでセットアップします。1 つはリージョンの非アクティブ化でイベントソースマッピングリソースを無効にし、もう 1 つはリージョンのアクティブ化でイベントソースマッピングリソースを有効にします。

仕組み

Lambda イベントソースマッピング実行ブロックは、Lambda 関数でイベントソースマッピングを有効または無効にします。プランの実行中に ブロックが呼び出されると、リージョンスイッチは Lambda UpdateEventSourceMapping API を呼び出して、指定された Lambda イベントソースマッピングに対して設定されたアクションを実行 (有効または無効に) します。その後、リージョンスイッチは、イベントソースマッピングがターゲット状態になるまで待機し、このステップのステータス (失敗のため完了または一時停止) を更新してから、プランの次のステップに進みます。マッピングがすでに目的の状態にある場合、リージョンスイッチはステップをすぐに完了としてマークします。不正な実行用に設定されたこの実行ブロックを含むプランが不正なモードで実行されると、プランはこのステップの実行をスキップします。