本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

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

向远程持久函数执行发送回调失败。

**注意**  
此命令需要访问 AWS 凭证。

## 用法
<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`  
打开调试日志以打印 AWS SAM CLI 生成的调试消息并显示时间戳。

`-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}'
```