垃圾列表资源 - Amazon Serverless Application Model
用量选项示例
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

垃圾列表资源

显示您的Amazon Serverless Application Model (Amazon SAM) 模板中Amazon CloudFormation由部署时Amazon SAM转换在中创建的资源。

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

注意

要从您的Amazon SAM模板生成资源列表，需要对模板进行本地转换。将在特定区域等条件下部署的资源包含在此列表中。

用量

sam list resources <option> <parameter> ...

选项

选项 描述

--config-env TEXT

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

默认值：default

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

--config-file TEXT

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

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

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

--debug

开启调试日志，打印Amazon SAM CLI 生成的带有时间戳的调试消息。

-h, --help

显示此消息并退出。

--output [json|table]

指定输出结果的格式。

默认值：table

--profile TEXT

从凭证文件中选择特定配置文件以获取Amazon凭证文件。

--region TEXT

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

--stack-name TEXT

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

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

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

-t, --template-file, --template 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                        -
-------------------------------------------------------------------------------------------------------------------------