sam local invoke

呼び出す Lambda 関数の ID。

この引数はオプションです。アプリケーションに 1 つの Lambda 関数が含まれている場合、CLI AWS SAM はその関数を呼び出します。アプリケーションに複数の関数が含まれている場合は、呼び出す関数の ID を指定します。

有効な値: リソースの論理 ID またはリソース ARN。

Docker コンテナのホストファイルへの IP アドレスマッピングに、ホスト名を渡します。このパラメータは、複数回渡すことができます。

ベータ機能を許可または拒否します。

使用する設定ファイル内のデフォルトパラメータ値を指定する環境名です。デフォルト値は「default」です。設定ファイルの詳細については、「AWS SAM CLI 設定ファイル」を参照してください。

使用するデフォルトのパラメータ値が含まれる設定ファイルのパスとファイル名です。デフォルト値は、プロジェクトディレクトリのルートにある「samconfig.toml」です。設定ファイルの詳細については、「AWS SAM CLI 設定ファイル」を参照してください。

(オプション) ローカルでデバッグするときに、環境変数を Lambda 関数イメージコンテナに渡します。

ローカルでエミュレートされた Lambda コンテナのホストです。デフォルト値は localhost です。macOS 上の Docker コンテナで AWS SAM CLI を実行する場合は、host.docker.internal を指定できます。コンテナを とは異なるホストで実行する場合は AWS SAMCLI、リモートホストの IP アドレスを指定できます。

コンテナポートがバインドする必要があるホストネットワークインターフェイスの IP アドレスです。デフォルト値は 127.0.0.1 です。0.0.0.0 を使用して、すべてのインターフェイスにバインドします。

デバッグロギングをオンにして、 AWS SAM CLI が生成するメッセージを出力表示し、タイムスタンプを表示します。

デバッガーに渡す追加の引数です。

これを指定すると、Lambda 関数コンテナがデバッグモードで起動され、このポートがローカルホストに公開されます。

Lambda コンテナにマウントされたデバッガーへのホストパスです。

デフォルトのブリッジネットワークと共に、Lambda Docker コンテナが接続される必要がある既存の Docker ネットワークの名前または ID です。これを指定しない場合、Lambda コンテナはデフォルトのブリッジ Docker ネットワークだけに接続します。

AWS SAM ファイルが存在するベースディレクトリの場所。Docker がリモートマシンで実行されている場合は、Docker マシンに AWS SAM ファイルが存在するパスをマウントし、リモートマシンに合わせてこの値を変更する必要があります。

Lambda 関数の環境変数の値が含まれる JSON ファイルです。環境変数ファイルの詳細については、「環境変数ファイル」を参照してください。

呼び出されたときに Lambda 関数に渡されるイベントデータが含まれる JSON ファイルです。このオプションを指定しない場合、イベントは想定されません。stdin からの JSON を入力するには、値「-」を渡す必要があります。さまざまな AWS サービスのイベントメッセージ形式の詳細については、 AWS Lambda デベロッパーガイドの「他の サービスの使用」を参照してください。

レイヤーがある Lambda 関数を呼び出すために使用されるイメージを AWS SAM CLI が再構築すべきかどうかを指定します。

このメッセージを表示して終了します。

AWS SAM CLI 機能の拡張に使用されるフックの名前。

許容値: terraform。

ローカル関数の呼び出しに使用するコンテナーイメージの URI。デフォルトで、 AWS SAM は Amazon ECR Public (のイメージリポジトリ AWS SAM に一覧を記載) からコンテナイメージをプルします。このオプションは、別の場所からイメージをプルするために使用します。

例えば、sam local invoke MyFunction --invoke-image amazon/aws-sam-cli-emulation-image-python3.8。

テンプレートで使用するレイヤーがダウンロードされるベースディレクトリの場所を指定します。

ランタイムログを送信するログファイルです。

は、ビルドまたは呼び出すファイルに存在するシンボリックリンクを常に AWS SAMCLIマウントします。これは、最上位ディレクトリのシンボリックリンク (つまり、関数のルートに直接あるシンボリックリンク) にのみ適用されます。デフォルトでは、NodeJS build-in-sourcenode_modulesで を使用するために必要なものを除き、シンボリックリンクはマウントされません。

空のイベントを使用して関数を呼び出します。

AWS SAM テンプレートでメモリが設定されている場合でも、ローカル呼び出し中にコンテナのメモリ制限を削除します。

キーと値のペアとしてエンコードされた AWS CloudFormation パラメータオーバーライドを含む文字列。 AWS Command Line Interface () と同じ形式を使用しますAWS CLI。 AWS SAM CLI 形式は明示的なキーと値のキーワードで構成され、各オーバーライドはスペースで区切られます。ここでは、以下の 2 つの例を示します。

認証情報を取得する AWS 認証情報ファイルからの特定のプロファイル。

デプロイ先の AWS リージョン。例えば、us-east-1 などです。

指定されたランタイムを使用して、Lambda 関数をローカルで呼び出します。これにより、 template.yml ファイルで定義されているランタイムが上書きされます。これにより、元の関数設定を変更せずに、ランタイムが異なる Lambda 関数をテストすることもできます。

コマンドラインで指定したパラメータを設定 AWS SAM ファイルに保存します。

シャットダウン動作の拡張機能処理をテストするために、呼び出し完了後にシャットダウンイベントをエミュレートします。

インフラストラクチャに変更が加えられていない場合は、準備段階をスキップします。--hook-name オプションと合わせて使用します。

デフォルトでは、 AWS SAM CLI は Lambda の最新のリモートランタイム環境を確認し、ローカルイメージを自動的に更新して同期を維持します。

このオプションを指定して、Lambda ランタイム環境の最新の Docker イメージのプルダウンをスキップします。

AWS SAM テンプレートファイル。

このオプションは --hook-name と互換性がありません。

Terraform Cloud で AWS SAMCLI を使用する場合のローカル Terraform プランファイルへの相対パスまたは絶対パス。このオプションは --hook-name を terraform に設定する必要があります。