sam local invoke

ローカル AWS Lambda 関数を一度呼び出し、呼び出しが完了した後に終了します。

このコマンドを使用すると、デフォルトでAWS SAMCLIは、現在の作業ディレクトリがプロジェクトのルートディレクトリであると仮定します。-AWS SAMCLIはまず、sam buildコマンドで、.aws-samサブフォルダ、および名前付きtemplate.yamlまたはtemplate.yml。次に、AWS SAMCLIは、という名前のテンプレートファイルを検索しようとしますtemplate.yamlまたはtemplate.yml現在の作業ディレクトリで。指定すると、--templateオプションAWS SAMCLIのデフォルトの動作はオーバーライドされ、AWS SAMテンプレートと、それが指すローカルリソースです。

ネストされたアプリケーションまたはスタックの関数を呼び出すには、アプリケーションまたはスタックの論理 ID と、関数論理 ID をStackLogicalId/FunctionLogicalId。

-sam local invokeコマンドは、Amazon Simple Storage Service (Amazon S3) や Amazon Kinesis イベントなどの非同期イベントを処理するサーバーレス関数を開発する場合に便利です。テストケースのスクリプトを作成する場合にも便利です。イベント本体を渡すには、--eventパラメータ。イベントの詳細については、以下を参照してください。イベント()AWS Lambda開発者ガイド。イベントメッセージの形式の詳細については、AWSサービスの詳細については、他のサービスでの使用()AWS Lambda開発者ガイド。

ランタイム出力（ログなど）はstderrLambda 関数の結果はに出力されます。stdout。

注記

に 2 つ以上の関数が定義されている場合AWS SAMテンプレートを使用するには、FUNCTION_LOGICAL_ID呼び出す関数の。

使用:

sam local invoke [OPTIONS] [FUNCTION_LOGICAL_ID]

オプション:

オプション	説明
-e, --event PATH	呼び出されたときに Lambda 関数に渡されるイベントデータを含む JSON ファイル。このオプションを指定しない場合、イベントは想定されません。から JSON を入力するにはstdinには、値「-」を渡す必要があります。イベントメッセージの形式の詳細については、AWSサービスの詳細については、他のサービスでの使用()AWS Lambda開発者ガイド。
--no-event	空のイベントを使用して関数を呼び出します。
-t, --template PATH	-AWS SAMテンプレートファイル。 注意: このオプションを指定すると、AWS SAMは、テンプレートとそれが指すローカルリソースのみをロードします。
-n, --env-vars PATH	Lambda 関数の環境変数の値を含む JSON ファイル。環境変数ファイルの詳細については、「」を参照してください。環境変数ファイル。
--parameter-overrides	(オプション) 以下の文字列です。AWS CloudFormationパラメータは、キーと値のペアとしてエンコードされたオーバーライドします。と同じ形式を使用します。AWS Command Line Interface(AWS CLI). 例:'ParameterKey=KeyPairName,ParameterValue=MyKey ParameterKey=InstanceType,ParameterValue=t1.micro'。
-d, --debug-port TEXT	指定すると、Lambda 関数コンテナをデバッグモードで起動し、このポートをローカルホストに公開します。
--debugger-path TEXT	Lambda コンテナにマウントされたデバッガーへのホストパス。
--debug-args TEXT	デバッガに渡す追加の引数。
-v, --docker-volume-basedir TEXT	AWS SAM ファイルが存在するベースディレクトリの場所。Docker がリモートマシンで実行されている場合は、AWS SAMファイルが存在し、リモートマシンと一致するようにこの値を変更します。
--docker-network TEXT	Lambda Docker コンテナが接続する必要のある既存の Docker ネットワークの名前または ID、およびデフォルトのブリッジネットワークです。これを指定しない場合、Lambda コンテナはデフォルトのブリッジ Docker ネットワークにのみ接続します。
--container-env-vars	（オプション）ローカルでデバッグするときに、環境変数を Lambda 関数イメージコンテナに渡します。
-l, --log-file TEXT	ランタイムログを送信するログファイル。
--layer-cache-basedir DIRECTORY	テンプレートが使用するレイヤーがダウンロードされる場所、ベースディレクトリの場所を指定します。
--skip-pull-image	するかどうかを指定します。AWS SAMCLI は Lambda ランタイムの最新の Docker イメージのプルダウンをスキップする必要があります。
--force-image-build	するかどうかを指定します。AWS SAMCLI は Layer を使用して Lambda 関数を呼び出すために使用されるイメージを再構築する必要があります。
--profile TEXT	認証情報ファイルから特定のプロファイルで、AWS認証情報。
--region TEXT	-AWSデプロイ先リージョン。たとえば、us-east-1 です。
--config-file PATH	使用するデフォルトのパラメータ値が含まれている設定ファイルのパスとファイル名。デフォルト値はです。samconfig.tomlプロジェクトディレクトリのルートにあります。設定ファイルについて詳しくは、AWS SAMCLI 設定ファイル を参照してください。
--config-env TEXT	使用する設定ファイル内のデフォルトのパラメータ値を指定する環境名。デフォルト値はです。設定ファイルについて詳しくは、AWS SAMCLI 設定ファイル を参照してください。
--shutdown	シャットダウン動作の拡張処理をテストするために、呼び出しが完了した後にシャットダウンイベントをエミュレートします。
--container-host TEXT	ローカルでエミュレートされた Lambda コンテナのホスト。デフォルト値は localhost です。あなたが実行したい場合AWS SAMCLIをmacOS Dockerコンテナで使用する場合は、host.docker.internal。コンテナを別のホストで実行する場合AWS SAMCLI では、リモートホストの IP アドレスを指定できます。
--container-host-interface TEXT	コンテナポートがバインドするホストネットワークインターフェースの IP アドレス。デフォルト値は 127.0.0.1 です。を使用する0.0.0.0を使用してすべてのインターフェイスにバインドします。
--debug	デバッグログをオンにして、AWS SAMCLI が生成し、タイムスタンプを表示します。
--help	このメッセージを表示して終了します。