sam list resources - AWS Serverless Application Model
使用量选项示例

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

sam list resources

此页面提供了 AWS Serverless Application Model 命令行界面 (AWS SAM CLI) sam list resources 子命令的参考信息。

有关 AWS SAM CLI 的简介，请参阅那是什么 AWS SAMCLI？

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

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

注意

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

使用量

$ sam list resources <options>

选项

--config-env TEXT

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

默认值：default

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

--config-file TEXT

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

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

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

--debug

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

--help, -h

显示此消息并退出。

--output [json|table]

指定输出结果的格式。

默认值：table

--profile TEXT

从凭证文件中选择一个特定的配置文件以获取 AWS 凭证。

--region TEXT

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

--save-params

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

--stack-name TEXT

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

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

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

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

AWS SAM 模板文件。

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

示例

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

$ 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                        -
-------------------------------------------------------------------------------------------------------------------------