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

# sam remote callback
<a name="sam-cli-command-reference-sam-remote-callback"></a>

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

の概要については AWS SAM CLI、「」を参照してください。 [とは AWS SAM CLI](what-is-sam-overview.md#what-is-sam-cli)

`sam remote callback` コマンドを使用すると、 AWS Lambda で実行されているリモートの永続的な関数実行にコールバックを送信できます。

**注記**  
これらのコマンドには、 AWS 認証情報へのアクセスが必要です。

## 使用方法
<a name="sam-cli-command-reference-sam-remote-callback-usage"></a>

```
$ sam remote callback <subcommand> <options>
```

## オプション
<a name="sam-cli-command-reference-sam-remote-callback-options"></a>

`--help, -h`  <a name="sam-cli-command-reference-sam-remote-callback-options-help"></a>
このメッセージを表示して終了します。

## サブコマンド
<a name="sam-cli-command-reference-sam-remote-callback-subcommands"></a>

`succeed`  <a name="sam-cli-command-reference-sam-remote-callback-subcommands-succeed"></a>
リモートの永続的な関数実行にコールバックの成功を送信します。詳細については、「[sam remote callback succeed](sam-cli-command-reference-sam-remote-callback-succeed.md)」を参照してください。

`fail`  <a name="sam-cli-command-reference-sam-remote-callback-subcommands-fail"></a>
リモートの永続的な関数実行にコールバック失敗を送信します。詳細については、「[sam remote callback fail](sam-cli-command-reference-sam-remote-callback-fail.md)」を参照してください。

`heartbeat`  <a name="sam-cli-command-reference-sam-remote-callback-subcommands-heartbeat"></a>
コールバックハートビートをリモートの永続的な関数実行に送信します。詳細については、「[sam remote callback heartbeat](sam-cli-command-reference-sam-remote-callback-heartbeat.md)」を参照してください。

# sam remote callback succeed
<a name="sam-cli-command-reference-sam-remote-callback-succeed"></a>

リモートの永続的な関数実行にコールバックの成功を送信します。

**注記**  
このコマンドでは、 AWS 認証情報にアクセスする必要があります。

## Usage
<a name="ref-sam-cli-remote-callback-succeed-usage"></a>

```
$ sam remote callback succeed CALLBACK_ID [OPTIONS]
```

## 必要な引数
<a name="ref-sam-cli-remote-callback-succeed-arguments"></a>

`CALLBACK_ID`  
成功レスポンスを送信するコールバックの一意の識別子。

## オプション
<a name="ref-sam-cli-remote-callback-succeed-options"></a>

`-r, --result TEXT`  
成功結果ペイロードを文字列として指定します。

`--region TEXT`  
サービスの AWS リージョンを設定します (例: `us-east-1`)。

`--profile TEXT`  
認証情報ファイルから特定のプロファイルを選択して、 AWS 認証情報を取得します。

`--config-env TEXT`  
設定ファイルでデフォルトのパラメータ値を指定する環境名。デフォルト: `default`

`--config-file TEXT`  
デフォルトのパラメータ値を含む設定ファイル。デフォルト: `samconfig.toml`

`--save-params`  
コマンドラインを介して提供されたパラメータを設定ファイルに保存します。

`--beta-features / --no-beta-features`  
ベータ機能を有効/無効にします。

`--debug`  
デバッグログを有効にして、CLI AWS SAM によって生成されたデバッグメッセージを出力し、タイムスタンプを表示します。

`-h, --help`  
このメッセージを表示して終了します。

## 例
<a name="ref-sam-cli-remote-callback-succeed-examples"></a>

結果なしで成功コールバックを送信します。

```
$ sam remote callback succeed my-callback-id
```

結果を含む成功コールバックを送信します。

```
$ sam remote callback succeed my-callback-id --result 'Task completed successfully'
```

# sam remote callback fail
<a name="sam-cli-command-reference-sam-remote-callback-fail"></a>

リモートの永続的な関数実行にコールバック失敗を送信します。

**注記**  
このコマンドでは、 AWS 認証情報にアクセスする必要があります。

## Usage
<a name="ref-sam-cli-remote-callback-fail-usage"></a>

```
$ sam remote callback fail CALLBACK_ID [OPTIONS]
```

## 必要な引数
<a name="ref-sam-cli-remote-callback-fail-arguments"></a>

`CALLBACK_ID`  
失敗レスポンスを送信するコールバックの一意の識別子。

## オプション
<a name="ref-sam-cli-remote-callback-fail-options"></a>

`--error-data TEXT`  
追加のエラーデータ。

`--stack-trace TEXT`  
スタックトレースエントリ。このオプションは複数回指定できます。

`--error-type TEXT`  
エラーのタイプ。

`--error-message TEXT`  
詳細なエラーメッセージ。

`--region TEXT`  
サービスの AWS リージョンを設定します (例: `us-east-1`)。

`--profile TEXT`  
認証情報ファイルから特定のプロファイルを選択して、 AWS 認証情報を取得します。

`--config-env TEXT`  
設定ファイルでデフォルトのパラメータ値を指定する環境名。デフォルト: `default`

`--config-file TEXT`  
デフォルトのパラメータ値を含む設定ファイル。デフォルト: `samconfig.toml`

`--save-params`  
コマンドラインを介して提供されたパラメータを設定ファイルに保存します。

`--beta-features / --no-beta-features`  
ベータ機能を有効/無効にします。

`--debug`  
デバッグログを有効にして、CLI AWS SAM によって生成されたデバッグメッセージを出力し、タイムスタンプを表示します。

`-h, --help`  
このメッセージを表示して終了します。

## 例
<a name="ref-sam-cli-remote-callback-fail-examples"></a>

パラメータなしで失敗コールバックを送信します。

```
$ sam remote callback fail my-callback-id
```

エラーメッセージを使用して失敗コールバックを送信します。

```
$ sam remote callback fail my-callback-id --error-message 'Task failed'
```

すべてのパラメータを使用して失敗コールバックを送信します。

```
$ sam remote callback fail my-callback-id --error-message 'Task failed' --error-type 'ValidationError' --stack-trace 'at line 42' --error-data '{"code": 500}'
```

# sam remote callback heartbeat
<a name="sam-cli-command-reference-sam-remote-callback-heartbeat"></a>

コールバックハートビートをリモートの永続的な関数実行に送信します。

**注記**  
このコマンドでは、 AWS 認証情報にアクセスする必要があります。

## Usage
<a name="ref-sam-cli-remote-callback-heartbeat-usage"></a>

```
$ sam remote callback heartbeat CALLBACK_ID [OPTIONS]
```

## 必要な引数
<a name="ref-sam-cli-remote-callback-heartbeat-arguments"></a>

`CALLBACK_ID`  
ハートビートを送信するコールバックの一意の識別子。

## オプション
<a name="ref-sam-cli-remote-callback-heartbeat-options"></a>

`--region TEXT`  
サービスの AWS リージョンを設定します (例: `us-east-1`)。

`--profile TEXT`  
認証情報ファイルから特定のプロファイルを選択して、 AWS 認証情報を取得します。

`--config-env TEXT`  
設定ファイルでデフォルトのパラメータ値を指定する環境名。デフォルト: `default`

`--config-file TEXT`  
デフォルトのパラメータ値を含む設定ファイル。デフォルト: `samconfig.toml`

`--save-params`  
コマンドラインを介して提供されたパラメータを設定ファイルに保存します。

`--beta-features / --no-beta-features`  
ベータ機能を有効/無効にします。

`--debug`  
デバッグログを有効にして、CLI AWS SAM によって生成されたデバッグメッセージを出力し、タイムスタンプを表示します。

`-h, --help`  
このメッセージを表示して終了します。

## 例
<a name="ref-sam-cli-remote-callback-heartbeat-examples"></a>

ハートビートコールバックを送信する:

```
$ sam remote callback heartbeat my-callback-id
```