Lambda SnapStart のアクティブ化と管理

Lambda コンソールの関数ページを開きます。

関数の名前を選択します。

[Configuration] (設定) を選択してから、[General configuration] (一般設定) を選択します。

[General configuration] (一般設定) ペインで [Edit] (編集) を選択します。

[Edit basic settings] (基本設定を編集) ページの [SnapStart] で、[Published versions] (発行済みバージョン) を選択します。

[Save] を選択します。

関数バージョンを発行します。Lambda がコードを初期化し、初期化された実行環境のスナップショットを作成してから、低レイテンシーアクセスのためにスナップショットをキャッシュします。

関数バージョンを呼び出します。

--snap-start オプションを指定した update-function-configuration コマンドを実行して、関数設定を更新します。

aws lambda update-function-configuration \
  --function-name my-function \
  --snap-start ApplyOn=PublishedVersions

publish-version コマンドを使用して、関数バージョンを発行します。

aws lambda publish-version \
  --function-name my-function

バージョン番号を指定した get-function-configuration コマンドを実行して、その関数バージョンに対して SnapStart がアクティブ化されていることを確認します。以下の例では、バージョン 1 が指定されています。

aws lambda get-function-configuration \
  --function-name my-function:1

レスポンスで OptimizationStatus が On、State が Active になっていれば、指定された関数バージョンで SnapStart がアクティブ化されており、スナップショットを利用できます。

"SnapStart": { 
    "ApplyOn": "PublishedVersions",
    "OptimizationStatus": "On"
 },
 "State": "Active",

バージョンを指定した invoke コマンドを実行して、関数バージョンを呼び出します。以下の例は、バージョン 1 を呼び出します。

aws lambda invoke \
  --cli-binary-format raw-in-base64-out \
  --function-name my-function:1 \
  --payload '{ "name": "Bob" }' \
  response.json

AWS CLI バージョン 2 を使用している場合、cli-binary-format オプションは必須です。これをデフォルト設定にするには、aws configure set cli-binary-format raw-in-base64-out を実行します。詳細については、バージョン 2 の AWS Command Line Interface ユーザーガイドの「AWS CLI でサポートされているグローバルコマンドラインオプション」を参照してください。

--snap-start オプションを指定した create-function コマンドを実行して、関数を作成します。--role には、実行ロールの Amazon リソースネーム (ARN) を指定します。

aws lambda create-function \
  --function-name my-function \
  --runtime "java21" \
  --zip-file fileb://my-function.zip \
  --handler my-function.handler \
  --role arn:aws:iam::111122223333:role/lambda-ex \
  --snap-start ApplyOn=PublishedVersions

publish-version コマンドを使用して、バージョンを作成します。

aws lambda publish-version \
  --function-name my-function

バージョン番号を指定した get-function-configuration コマンドを実行して、その関数バージョンに対して SnapStart がアクティブ化されていることを確認します。以下の例では、バージョン 1 が指定されています。

aws lambda get-function-configuration \
  --function-name my-function:1

レスポンスで OptimizationStatus が On、State が Active になっていれば、指定された関数バージョンで SnapStart がアクティブ化されており、スナップショットを利用できます。

"SnapStart": { 
     "ApplyOn": "PublishedVersions",
     "OptimizationStatus": "On"
  },
  "State": "Active",

バージョンを指定した invoke コマンドを実行して、関数バージョンを呼び出します。以下の例は、バージョン 1 を呼び出します。

aws lambda invoke \
  --cli-binary-format raw-in-base64-out \
  --function-name my-function:1 \
  --payload '{ "name": "Bob" }' \
  response.json

AWS CLI バージョン 2 を使用している場合、cli-binary-format オプションは必須です。これをデフォルト設定にするには、aws configure set cli-binary-format raw-in-base64-out を実行します。詳細については、バージョン 2 の AWS Command Line Interface ユーザーガイドの「AWS CLI でサポートされているグローバルコマンドラインオプション」を参照してください。

以下のいずれかを実行します。

• SnapStart パラメータを設定した CreateFunction API アクションを使用して、SnapStart がアクティブ化された新しい関数を作成します。

• 既存の関数に対する SnapStart は、SnapStart パラメータを指定した UpdateFunctionConfiguration アクションを使用してアクティブ化します。

PublishVersion アクションを使用して、関数バージョンを発行します。Lambda がコードを初期化し、初期化された実行環境のスナップショットを作成してから、低レイテンシーアクセスのためにスナップショットをキャッシュします。

getFunctionConfiguration アクションを使用して、関数バージョンに対して SnapStart がアクティブ化されていることを確認します。バージョン番号を指定して、そのバージョンに対して SnapStart がアクティブ化されていることを確認します。レスポンスで OptimizationStatus が On、State が Active になっていれば、指定された関数バージョンで SnapStart がアクティブ化されており、スナップショットを利用できます。

"SnapStart": { 
        "ApplyOn": "PublishedVersions",
        "OptimizationStatus": "On"
     },
     "State": "Active",

Invoke アクションを使用して、関数バージョンを呼び出します。