sam remote invoke - AWS Serverless Application Model
使用方法引数オプション例

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

sam remote invoke

このページでは、 AWS Serverless Application Model コマンドラインインターフェイス (AWS SAMCLI) sam remote invoke コマンドのリファレンス情報を提供します。

sam remote invoke コマンドは、 AWS クラウドでサポートされているリソースを呼び出します。

使用方法

$ sam remote invoke <arguments> <options>

引数

リソース ID

呼び出すサポート対象リソースの ID です。

この引数には、次の値を使用できます。

  • Amazon リソースネーム (ARN) – リソースの ARN。

    ヒント

    sam list stack-outputs --stack-name <stack-name> を使用してリソースの ARN を取得します。

  • 論理 ID – リソースの論理 ID。また、 --stack-nameオプションを使用して AWS CloudFormation スタック名を指定する必要があります。

  • 物理 ID — リソースの物理 ID。この ID は、 を使用してリソースをデプロイするときに作成されます AWS CloudFormation。

    ヒント

    sam list resources --stack-name <stack-name> を使用してリソースの物理 ID を取得します。

ARN または物理 ID を指定する場合:

ARN ID または物理 ID の指定で、スタック名を指定しないでください。--stack-name オプションを使用してスタック名を指定する場合、またはスタック名が設定ファイルで定義されている場合、 AWS SAM CLIはリソース ID を AWS CloudFormation スタックの論理 ID 値として自動的に処理します。

リソース ID を指定しない場合:

リソース ID を指定せず、 --stack-nameオプションでスタック名を指定した場合、 CLI AWS SAM は次のロジックを使用して AWS CloudFormation スタック内のリソースを自動的に呼び出そうとします。

  1. AWS SAM CLI は、次の順序でリソースタイプを識別し、スタックでリソースタイプが見つかったら次のステップに進みます。

    1. Lambda

    2. Step Functions

    3. Amazon SQS

    4. Kinesis Data Streams

  2. リソースタイプにスタック内のリソースが 1 つある場合、 AWS SAM CLIはそのリソースを呼び出します。リソースタイプの複数のリソースがスタックに存在する場合、 AWS SAM CLIはエラーを返します。

以下は、 が AWS SAM CLI実行する内容の例です。

  • 2 つの Lambda 関数と Amazon SQS キューを含むスタック – AWS SAM CLIは Lambda リソースタイプを検索し、スタックに複数の Lambda 関数が含まれているため、 と エラーを返します。

  • Lambda 関数と 2 つの Amazon Kinesis Data Streams アプリケーションを含むスタック – スタック AWS SAM CLIには 1 つの Lambda リソースが含まれているため、 は Lambda 関数を見つけて呼び出します。

  • 1 つの Amazon SQS キューと 2 つの Kinesis Data Streams アプリケーションを含むスタック – スタック AWS SAM CLIには 1 つの Amazon SQS キューが含まれているため、 は Amazon SQS キューを見つけて呼び出します。

オプション

--beta-features | --no-beta-features

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

--config-env TEXT

AWS SAM CLI 設定ファイルから、使用する環境を指定します。

デフォルト: default

--config-file FILENAME

設定ファイルのパスとファイル名を指定します。

設定ファイルの詳細については、「AWS SAM CLI の設定」を参照してください。

デフォルト: プロジェクトディレクトリのルートにある samconfig.toml。

--debug

デバッグログの記録をアクティブ化します。そうすることで、 AWS SAM CLI が生成したデバッグメッセージとタイムスタンプを出力します。

--event, -e TEXT

ターゲットリソースに送信するイベントです。

--event-file FILENAME

ターゲットリソースに送信するイベントが含まれるファイルへのパスです。

--help, -h

ヘルプメッセージを表示して終了します。

--output [ text | json ]

呼び出しの結果を特定の出力形式で出力します。

json – リクエストメタデータとリソースのレスポンスが JSON 構造で返されます。レスポンスには完全な SDK 出力が含まれます。

text – リクエストメタデータがテキスト構造で返されます。リソースレスポンスは、呼び出されたリソースの出力形式で返されます。

--parameter

呼び出されているリソースに渡すことができる追加の Boto3 パラメータです。

Amazon Kinesis Data Streams

次の追加パラメータは、Kinesis データストリームにレコードを追加するために使用できます。

  • ExplicitHashKey='string'

  • PartitionKey='string'

  • SequenceNumberForOrdering='string'

  • StreamARN='string'

各パラメータの説明については、「Kinesis.Client.Put_Record」を参照してください。

AWS Lambda

以下の追加のパラメータは、Lambda リソースを呼び出して、バッファされたレスポンスを受け取るために使用できます。

  • ClientContext='base64-encoded string'

  • InvocationType='[ DryRun | Event | RequestResponse ]'

  • LogType='[ None | Tail ]'

  • Qualifier='string'

以下の追加パラメータは、レスポンスストリーミングで Lambda リソースを呼び出すために使用できます。

  • ClientContext='base64-encoded string'

  • InvocationType='[ DryRun | RequestResponse ]'

  • LogType='[ None | Tail ]'

  • Qualifier='string'

各パラメータの説明については、以下を参照してください。

Amazon Simple Queue Service (Amazon SQS)

次の追加パラメータは Amazon SQS キューにメッセージを送信するために使用できます。

  • DelaySeconds=integer

  • MessageAttributes='json string'

  • MessageDeduplicationId='string'

  • MessageGroupId='string'

  • MessageSystemAttributes='json string'

各パラメータの説明については、「SQS.Client.Send_Message」を参照してください。

AWS Step Functions

次の追加パラメータは、ステートマシンの実行を開始するために使用できます。

  • name='string'

  • traceHeader='string'

各パラメータの説明については、「SFN.Client.Start_Execution」を参照してください。

--profile TEXT

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

--region TEXT

リソース AWS リージョン の 。例えば、us-east-1 と指定します。

--stack-name TEXT

リソースが属する AWS CloudFormation スタックの名前。

--test-event-name NAME

Lambda 関数に渡す共有可能なテストイベントの名前。

注記

このオプションは Lambda 関数のみをサポートします。

例

次の の例では、 AWS クラウドでサポートされているリソースを呼び出し、デバッグログを有効にします。これにより、 によって生成されたデバッグメッセージとタイムスタンプが出力されます AWS SAMCLI。

$ sam remote invoke--debug