sam list resources - Amazon Serverless Application Model
使用量Options示例
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

sam list resources

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

有关简介 Amazon SAMCLI，请参阅那是什么 Amazon SAMCLI？。

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

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

注意

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

使用量

$ sam list resources <options>

Options

--config-env TEXT

在配置文件中指定要使用的默认参数值的环境名称。

默认值：default

有关配置文件的详细信息，请参阅 Amazon SAMCLI 配置文件。

--config-file TEXT

包含要使用的默认参数值的配置文件的路径和文件名。

默认值：当前工作目录中 samconfig.toml。

有关配置文件的详细信息，请参阅 Amazon SAMCLI 配置文件。

--debug

启用调试日志记录，以打印由 Amazon SAM CLI 生成的带有时间戳的调试消息。

--help, -h

显示此消息并退出。

--output [json|table]

指定输出结果的格式。

默认值：table

--profile TEXT

从您的凭证文件中选择一个特定的个人资料以获取 Amazon 凭证。

--region TEXT

设置服务的 Amazon 区域。例如，us-east-1。

--save-params

将您在命令行中提供的参数保存到 Amazon SAM 配置文件中。

--stack-name TEXT

已部署 Amazon CloudFormation 堆栈的名称。可在应用程序的 samconfig.toml 文件或指定的配置文件中找到堆栈名称。

如有提供，模板中的资源逻辑 ID 将映射到 Amazon CloudFormation中相应的物理 ID。要了解有关物理 ID 的更多信息，请参阅《Amazon CloudFormation 用户指南》中的资源字段。

如果未指定此选项，则会显示模板中定义的本地资源。

--template-file, --template, -t PATH

Amazon SAM 模板文件。

默认值：template.[yaml|yml|json]

示例

以表格格式显示 Amazon SAM 模板中的本地资源和名为的 Amazon 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                        -
-------------------------------------------------------------------------------------------------------------------------