sam local invoke - AWS Serverless Application Model

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

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 このメッセージを表示して終了します。