

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

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

本页提供 AWS Serverless Application Model 命令行界面 (AWS SAMCLI) `sam remote test-event` 命令的参考信息。
+ 有关简介 AWS SAMCLI，请参阅 [那是什么 AWS SAMCLI？](what-is-sam-overview.md#what-is-sam-cli)
+ 有关使用该 AWS SAMCLI`sam remote test-event`命令的文档，请参阅[使用 sam remote test-event 进行云测试简介](using-sam-cli-remote-test-event.md)。

该`sam remote test-event`命令与 Amazon EventBridge 架构注册表中的可共享测试事件进行交互。

## 用法
<a name="sam-cli-command-reference-remote-test-event-usage"></a>

```
$ sam remote test-event <options> <subcommand>
```

## 选项
<a name="sam-cli-command-reference-remote-test-event-options"></a>

`--help, -h`  <a name="sam-cli-command-reference-remote-invoke-options-help"></a>
显示帮助消息并退出。

## 子命令
<a name="sam-cli-command-reference-remote-test-event-subcommands"></a>

`delete`  
从 EventBridge 架构注册表中删除可共享的测试事件。有关更多参考信息，请参阅 [sam remote test-event delete](sam-cli-command-reference-remote-test-event-delete.md)。

`get`  
从 EventBridge 架构注册表中获取可共享的测试事件。有关更多参考信息，请参阅 [sam remote test-event get](sam-cli-command-reference-remote-test-event-get.md)。

`list`  
列出 AWS Lambda 函数的现有可共享测试事件。有关更多参考信息，请参阅 [sam remote test-event list](sam-cli-command-reference-remote-test-event-list.md)。

`put`  
将事件从本地文件保存到 EventBridge 架构注册表。有关更多参考信息，请参阅 [sam remote test-event put](sam-cli-command-reference-remote-test-event-put.md)。

# sam remote test-event delete
<a name="sam-cli-command-reference-remote-test-event-delete"></a>

本页提供 AWS Serverless Application Model 命令行界面 (AWS SAMCLI) `sam remote test-event delete` 子命令的参考信息。
+ 有关简介 AWS SAMCLI，请参阅 [那是什么 AWS SAMCLI？](what-is-sam-overview.md#what-is-sam-cli)
+ 有关使用该 AWS SAMCLI`sam remote test-event`命令的文档，请参阅[使用 sam remote test-event 进行云测试简介](using-sam-cli-remote-test-event.md)。

该`sam remote test-event delete`子命令从 Amazon EventBridge 架构注册表中删除可共享的测试事件。

## 用法
<a name="sam-cli-command-reference-remote-test-event-delete-usage"></a>

```
$ sam remote test-event delete <arguments> <options>
```

## 参数
<a name="sam-cli-command-reference-remote-test-event-delete-args"></a>

**Resource ID**  <a name="sam-cli-command-reference-remote-test-event-delete-args-resource-id"></a>
与可共享测试事件关联的 AWS Lambda 函数的 ID。  
如果您提供逻辑 ID，则还必须使用选项为与 Lambda 函数关联的 AWS CloudFormation 堆栈提供一个值。`--stack-name`  
*有效值*：资源的逻辑 ID 或资源 ARN。

## 选项
<a name="sam-cli-command-reference-remote-test-event-delete-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-remote-test-event-delete-options-config-env"></a>
在配置文件中指定要使用的默认参数值的环境名称。默认值为“default”。有关配置文件的详细信息，请参阅 [AWS SAMCLI 配置文件](serverless-sam-cli-config.md)。

`--config-file PATH`  <a name="sam-cli-command-reference-remote-test-event-delete-options-config-file"></a>
包含要使用的默认参数值的配置文件的路径和文件名。在项目目录的根目录中，默认值为“`samconfig.toml`”。有关配置文件的详细信息，请参阅 [AWS SAMCLI 配置文件](serverless-sam-cli-config.md)。

`--help, -h`  <a name="sam-cli-command-reference-remote-test-event-delete-options-help"></a>
显示帮助消息并退出。

`--name TEXT`  <a name="sam-cli-command-reference-remote-test-event-delete-options-name"></a>
要删除的可共享测试事件的名称。

`--stack-name TEXT`  <a name="sam-cli-command-reference-remote-test-event-delete-options-stack-name"></a>
与 Lambda 函数关联的 CloudFormation 堆栈的名称。  
如果您提供 Lambda 函数逻辑 ID 作为参数，则此选项为必需。

# sam remote test-event get
<a name="sam-cli-command-reference-remote-test-event-get"></a>

本页提供 AWS Serverless Application Model 命令行界面 (AWS SAMCLI) `sam remote test-event get` 子命令的参考信息。
+ 有关简介 AWS SAMCLI，请参阅 [那是什么 AWS SAMCLI？](what-is-sam-overview.md#what-is-sam-cli)
+ 有关使用该 AWS SAMCLI`sam remote test-event`命令的文档，请参阅[使用 sam remote test-event 进行云测试简介](using-sam-cli-remote-test-event.md)。

该`sam remote test-event get`子命令从 Amazon EventBridge 架构注册表中获取一个可共享的测试事件。

## 用法
<a name="sam-cli-command-reference-remote-test-event-get-usage"></a>

```
$ sam remote test-event get <arguments> <options>
```

## 参数
<a name="sam-cli-command-reference-remote-test-event-get-args"></a>

**Resource ID**  <a name="sam-cli-command-reference-remote-test-event-get-args-resource-id"></a>
与要获取的可共享测试事件关联的 AWS Lambda 函数的 ID。  
如果您提供逻辑 ID，则还必须使用选项为与 Lambda 函数关联的 AWS CloudFormation 堆栈提供一个值。`--stack-name`  
*有效值*：资源的逻辑 ID 或资源 ARN。

## 选项
<a name="sam-cli-command-reference-remote-test-event-get-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-remote-test-event-get-options-config-env"></a>
在配置文件中指定要使用的默认参数值的环境名称。默认值为“default”。有关配置文件的详细信息，请参阅 [AWS SAMCLI 配置文件](serverless-sam-cli-config.md)。

`--config-file PATH`  <a name="sam-cli-command-reference-remote-test-event-get-options-config-file"></a>
包含要使用的默认参数值的配置文件的路径和文件名。在项目目录的根目录中，默认值为“`samconfig.toml`”。有关配置文件的详细信息，请参阅 [AWS SAMCLI 配置文件](serverless-sam-cli-config.md)。

`--help, -h`  <a name="sam-cli-command-reference-remote-test-event-get-options-help"></a>
显示帮助消息并退出。

`--name TEXT`  <a name="sam-cli-command-reference-remote-test-event-get-options-name"></a>
要获取的可共享测试事件的名称。

`--output-file FILENAME`  <a name="sam-cli-command-reference-remote-test-event-get-options-output-file"></a>
在本地计算机上保存事件的文件路径和名称。  
如果您不提供此选项，则 AWS SAM CLI会将可共享测试事件的内容输出到您的主机。

`--stack-name TEXT`  <a name="sam-cli-command-reference-remote-test-event-get-options-stack-name"></a>
与 Lambda 函数关联的 CloudFormation 堆栈的名称。  
如果您提供 Lambda 函数逻辑 ID 作为参数，则此选项为必需。

# sam remote test-event list
<a name="sam-cli-command-reference-remote-test-event-list"></a>

本页提供 AWS Serverless Application Model 命令行界面 (AWS SAMCLI) `sam remote test-event list` 子命令的参考信息。
+ 有关简介 AWS SAMCLI，请参阅 [那是什么 AWS SAMCLI？](what-is-sam-overview.md#what-is-sam-cli)
+ 有关使用该 AWS SAMCLI`sam remote test-event`命令的文档，请参阅[使用 sam remote test-event 进行云测试简介](using-sam-cli-remote-test-event.md)。

该`sam remote test-event list`子命令列出了 Amazon EventBridge 架构注册表中特定 AWS Lambda 函数的现有可共享测试事件。

## 用法
<a name="sam-cli-command-reference-remote-test-event-list-usage"></a>

```
$ sam remote test-event list <arguments> <options>
```

## 参数
<a name="sam-cli-command-reference-remote-test-event-list-args"></a>

**Resource ID**  <a name="sam-cli-command-reference-remote-test-event-list-args-resource-id"></a>
与可共享测试事件关联的 Lambda 函数的 ID。  
如果您提供逻辑 ID，则还必须使用选项为与 Lambda 函数关联的 AWS CloudFormation 堆栈提供一个值。`--stack-name`  
*有效值*：资源的逻辑 ID 或资源 ARN。

## 选项
<a name="sam-cli-command-reference-remote-test-event-list-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-remote-test-event-list-options-config-env"></a>
在配置文件中指定要使用的默认参数值的环境名称。默认值为“default”。有关配置文件的详细信息，请参阅 [AWS SAMCLI 配置文件](serverless-sam-cli-config.md)。

`--config-file PATH`  <a name="sam-cli-command-reference-remote-test-event-list-options-config-file"></a>
包含要使用的默认参数值的配置文件的路径和文件名。在项目目录的根目录中，默认值为“`samconfig.toml`”。有关配置文件的详细信息，请参阅 [AWS SAMCLI 配置文件](serverless-sam-cli-config.md)。

`--help, -h`  <a name="sam-cli-command-reference-remote-test-event-list-options-help"></a>
显示帮助消息并退出。

`--stack-name TEXT`  <a name="sam-cli-command-reference-remote-test-event-list-options-stack-name"></a>
与 Lambda 函数关联的 CloudFormation 堆栈的名称。  
如果您提供 Lambda 函数逻辑 ID 作为参数，则此选项为必需。

## 示例
<a name="sam-cli-command-reference-remote-test-event-list-examples"></a>

有关使用此命令的示例，请参阅[列出可共享测试事件](using-sam-cli-remote-test-event.md#using-sam-cli-remote-test-event-use-list)。

# sam remote test-event put
<a name="sam-cli-command-reference-remote-test-event-put"></a>

本页提供 AWS Serverless Application Model 命令行界面 (AWS SAMCLI) `sam remote test-event put` 子命令的参考信息。
+ 有关简介 AWS SAMCLI，请参阅 [那是什么 AWS SAMCLI？](what-is-sam-overview.md#what-is-sam-cli)
+ 有关使用该 AWS SAMCLI`sam remote test-event`命令的文档，请参阅[使用 sam remote test-event 进行云测试简介](using-sam-cli-remote-test-event.md)。

该`sam remote test-event put`子命令将本地计算机上的可共享测试事件保存到 Amazon EventBridge 架构注册表中。

## 用法
<a name="sam-cli-command-reference-remote-test-event-put-usage"></a>

```
$ sam remote test-event put <arguments> <options>
```

## 参数
<a name="sam-cli-command-reference-remote-test-event-put-args"></a>

**Resource ID**  <a name="sam-cli-command-reference-remote-test-event-put-args-resource-id"></a>
与可共享测试事件关联的 AWS Lambda 函数的 ID。  
如果您提供逻辑 ID，则还必须使用选项为与 Lambda 函数关联的 AWS CloudFormation 堆栈提供一个值。`--stack-name`  
*有效值*：资源的逻辑 ID 或资源 ARN。

## 选项
<a name="sam-cli-command-reference-remote-test-event-put-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-remote-test-event-put-options-config-env"></a>
在配置文件中指定要使用的默认参数值的环境名称。默认值为“default”。有关配置文件的详细信息，请参阅 [AWS SAMCLI 配置文件](serverless-sam-cli-config.md)。

`--config-file PATH`  <a name="sam-cli-command-reference-remote-test-event-put-options-config-file"></a>
包含要使用的默认参数值的配置文件的路径和文件名。在项目目录的根目录中，默认值为“`samconfig.toml`”。有关配置文件的详细信息，请参阅 [AWS SAMCLI 配置文件](serverless-sam-cli-config.md)。

`--file FILENAME`  <a name="sam-cli-command-reference-remote-test-event-put-options-file"></a>
本地计算机上事件的文件路径和名称。  
提供 `-` 作为要从 `stdin` 处读取的文件名值。  
此选项是必需的。

`--force`, `-f`  <a name="sam-cli-command-reference-remote-test-event-put-options-force"></a>
覆盖同名的可共享测试事件。

`--help, -h`  <a name="sam-cli-command-reference-remote-test-event-put-options-help"></a>
显示帮助消息并退出。

`--name TEXT`  <a name="sam-cli-command-reference-remote-test-event-put-options-name"></a>
用于保存可共享测试事件的名称。  
如果 EventBridge 架构注册表中存在同名的可共享测试事件，则 AWS SAM CLI不会将其覆盖。若要覆盖，请添加 `--force` 选项。

`--output-file FILENAME`  <a name="sam-cli-command-reference-remote-test-event-put-options-output-file"></a>
在本地计算机上保存事件的文件路径和名称。  
如果您不提供此选项，则 AWS SAM CLI会将可共享测试事件的内容输出到您的主机。

`--stack-name TEXT`  <a name="sam-cli-command-reference-remote-test-event-put-options-stack-name"></a>
与 Lambda 函数关联的 CloudFormation 堆栈的名称。  
如果您提供 Lambda 函数逻辑 ID 作为参数，则此选项为必需。

## 示例
<a name="sam-cli-command-reference-remote-test-event-put-examples"></a>

有关使用此命令的示例，请参阅[保存可共享测试事件](using-sam-cli-remote-test-event.md#using-sam-cli-remote-test-event-use-put)。