本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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

此頁面提供 AWS Serverless Application Model 命令列界面 (AWS SAM CLI) `sam remote test-event get`子命令的參考資訊。
+ 如需 的簡介 AWS SAM CLI，請參閱 [什麼是 AWS SAM CLI？](what-is-sam-overview.md#what-is-sam-cli)
+ 如需使用 AWS SAM CLI`sam remote test-event`命令的文件，請參閱 [使用 進行雲端測試的簡介 sam remote test-event](using-sam-cli-remote-test-event.md)。

`sam remote test-event get` 子命令會從 Amazon EventBridge 結構描述登錄檔取得可共用的測試事件。

## Usage
<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 (資源 ID)**  <a name="sam-cli-command-reference-remote-test-event-get-args-resource-id"></a>
與要取得的可共用測試事件相關聯的 AWS Lambda 函數 ID。  
如果您提供邏輯 ID，您還必須使用 `--stack-name`選項為與 Lambda 函數相關聯的 AWS CloudFormation 堆疊提供值。  
*有效值*：資源的邏輯 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>
在要使用的組態檔案中指定預設參數值的環境名稱。預設值為「預設值」。如需關於組態檔案的詳細資訊，請參閱 [AWS SAM CLI 組態檔案](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 SAM CLI 組態檔案](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 做為引數，則需要此選項。