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

プラン評価の一環として評価されるもの

リージョンスイッチがプランを評価すると、リージョンスイッチは Lambda イベントソースマッピング実行ブロックの設定とアクセス許可に対していくつかのチェックを実行します。リージョン切り替えは、以下が正しいことを確認します。

  • イベントソースマッピングは、ARN に埋め込まれたリージョンに存在します。

  • イベントソースマッピングに関連付けられた Lambda 関数が存在します。

  • イベントソースマッピング ARN の埋め込みリージョンは、プランで設定されたリージョンの 1 つです。

  • 有効化アクションの場合: Lambda 関数はスロットリングされません (プロビジョニングされた同時実行は 0 に設定されません）。

  • アクションを有効にする場合: Lambda 関数はアクティブ状態です。

リージョンスイッチは、プランの IAM ロールにイベントソースマッピングを管理するために必要なアクセス許可があることも検証します。リージョン切り替え実行ブロックに必要なアクセス許可の詳細については、「ARC でのリージョン切り替えのアイデンティティベースのポリシーの例」を参照してください。

Lambda イベントソースマッピング実行ブロックを適切に機能させるには、正しい IAM アクセス許可が不可欠です。これらの検証のいずれかが失敗した場合、リージョン切り替えは問題があることを示す警告を返し、アクセス許可または設定の問題を解決するのに役立つ特定のエラーメッセージを提供します。