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

# sam list resources
<a name="sam-cli-command-reference-sam-list-resources"></a>

本页提供 AWS Serverless Application Model 命令行界面 (AWS SAMCLI) `sam list resources` 子命令的参考信息。

有关简介 AWS SAMCLI，请参阅 [那是什么 AWS SAMCLI？](what-is-sam-overview.md#what-is-sam-cli)

`sam list resources`子命令显示部署时 AWS SAM 转换在您的 AWS Serverless Application Model (AWS SAM) 模板中创建 AWS CloudFormation 的资源。

在部署之前**sam list resources**与 AWS SAM 模板一起使用以查看将要创建的资源。提供 CloudFormation 堆栈名称以查看包含已部署资源的合并列表。

**注意**  
要根据 AWS SAM 模板生成资源列表，需要对模板进行本地转换。此列表中包含有条件地部署（例如，在特定区域内）的资源。

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

```
$ sam list resources <options>
```

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

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

`--config-file TEXT`  <a name="sam-cli-command-reference-sam-list-resources-options-config-file"></a>
包含要使用的默认参数值的配置文件的路径和文件名。  
*默认值*：当前工作目录中 `samconfig.toml`。  
有关配置文件的详细信息，请参阅 [AWS SAMCLI 配置文件](serverless-sam-cli-config.md)。

`--debug`  <a name="sam-cli-command-reference-sam-list-resources-options-debug"></a>
启用调试日志记录，以打印由 AWS SAM CLI 生成的带有时间戳的调试消息。

`--help, -h`  <a name="sam-cli-command-reference-sam-list-resources-options-help"></a>
显示此消息并退出。

`--output [json|table]`  <a name="sam-cli-command-reference-sam-list-resources-options-output"></a>
指定输出结果的格式。  
*默认值*：`table`

`--profile TEXT`  <a name="sam-cli-command-reference-sam-list-resources-options-profile"></a>
从您的凭证文件中选择一个特定的个人资料以获取 AWS 凭证。

`--region TEXT`  <a name="sam-cli-command-reference-sam-list-resources-options-region"></a>
设置服务的 AWS 区域。例如 `us-east-1`。

`--save-params`  <a name="sam-cli-command-reference-sam-list-resources-options-save-params"></a>
将您在命令行中提供的参数保存到 AWS SAM 配置文件中。

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-list-resources-options-stack-name"></a>
已部署 CloudFormation 堆栈的名称。可在应用程序的 `samconfig.toml` 文件或指定的配置文件中找到堆栈名称。  
如果提供，则模板 IDs 中的逻辑资源将映射到其对应IDs 的物理中 CloudFormation。要了解有关物理的更多信息 IDs，请参阅*AWS CloudFormation 用户指南*中的[资源字段](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resources-section-structure.html#resources-section-structure-resource-fields)。  
如果未指定此选项，则会显示模板中定义的本地资源。

`--template-file, --template, -t PATH`  <a name="sam-cli-command-reference-sam-list-resources-options-"></a>
AWS SAM 模板文件。  
*默认值*：`template.[yaml|yml|json]`

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

以表格格式显示 AWS SAM 模板中的本地资源和名为的 CloudFormation 堆栈中已部署资源的输出`test-stack`。从与本地模板相同的目录中运行。

```
$ sam list resources --stack-name test-stack --output table
			
-------------------------------------------------------------------------------------------------------------------------
Logical ID                                                   Physical ID
-------------------------------------------------------------------------------------------------------------------------
HelloWorldFunction                                           sam-app-test-list-HelloWorldFunction-H85Y7yIV7ZLq
HelloWorldFunctionHelloWorldPermissionProd                   sam-app-test-list-
                                                             HelloWorldFunctionHelloWorldPermissionProd-1QH7CPOCBL2IK
HelloWorldFunctionRole                                       sam-app-test-list-HelloWorldFunctionRole-SRJDMJ6F7F41
ServerlessRestApi                                            uj80uoe2o2
ServerlessRestApiDeployment47fc2d5f9d                        pncw5f
ServerlessRestApiProdStage                                   Prod
ServerlessRestApiDeploymentf5716dc08b                        -
-------------------------------------------------------------------------------------------------------------------------
```