As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

Esta página fornece informações de referência para o AWS Serverless Application Model `sam list resources` subcomando Command Line Interface (AWS SAMCLI).

Para obter uma introdução ao AWS SAMCLI, consulte [O que é o AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)

O `sam list resources` subcomando exibe os recursos em seu modelo AWS Serverless Application Model (AWS SAM) que são criados AWS CloudFormation pela AWS SAM transformação na implantação.

Use **sam list resources** com um AWS SAM modelo antes da implantação para ver os recursos que serão criados. Forneça um nome de CloudFormation pilha para visualizar uma lista consolidada que inclui recursos implantados.

**nota**  
Para gerar uma lista de recursos do seu AWS SAM modelo, uma transformação local do seu modelo é executada. Os recursos que serão implantados sob condições, como em uma região específica, estão incluídos nessa lista.

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

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

## Opções
<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>
O nome do ambiente que especifica os valores de parâmetros padrão no arquivo de configuração a serem usados.  
*Valor padrão*: `default`  
Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--config-file TEXT`  <a name="sam-cli-command-reference-sam-list-resources-options-config-file"></a>
O caminho e o nome do arquivo de configuração contendo valores de parâmetros padrão a serem usados.  
*Valor padrão*: O `samconfig.toml` no diretório de trabalho atual.  
Para obter mais informações sobre esses arquivos de configuração, consulte [Arquivo de configuração do AWS SAM CLI](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-list-resources-options-debug"></a>
Ative o registro de depuração para imprimir mensagens de depuração geradas pelo AWS SAMCLI com timestamps.

`--help, -h`  <a name="sam-cli-command-reference-sam-list-resources-options-help"></a>
Mostre esta mensagem e saia.

`--output [json|table]`  <a name="sam-cli-command-reference-sam-list-resources-options-output"></a>
Especifique o formato para gerar resultados.  
*Valor padrão*: `table`

`--profile TEXT`  <a name="sam-cli-command-reference-sam-list-resources-options-profile"></a>
Selecione um perfil específico do seu arquivo de credenciais para obter as AWS credenciais.

`--region TEXT`  <a name="sam-cli-command-reference-sam-list-resources-options-region"></a>
Defina a AWS região do serviço. Por exemplo, .`us-east-1`

`--save-params`  <a name="sam-cli-command-reference-sam-list-resources-options-save-params"></a>
Salve os parâmetros que você fornece na linha de comando no arquivo AWS SAM de configuração.

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-list-resources-options-stack-name"></a>
Nome da CloudFormation pilha implantada. O nome da pilha pode ser encontrado no `samconfig.toml` arquivo do seu aplicativo ou no arquivo de configuração designado.  
Quando fornecida, a lógica IDs do recurso do seu modelo será mapeada para a entrada física IDs correspondente. CloudFormation Para saber mais sobre física IDs, consulte [Campos de recursos](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resources-section-structure.html#resources-section-structure-resource-fields) no *Guia AWS CloudFormation do usuário*.  
Quando essa opção não for especificada, os recursos locais definidos em seu modelo serão exibidos.

`--template-file, --template, -t PATH`  <a name="sam-cli-command-reference-sam-list-resources-options-"></a>
AWS SAM arquivo de modelo.  
*Valor padrão*: `template.[yaml|yml|json]`

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

Exiba uma saída, em formato de tabela, dos recursos locais do seu AWS SAM modelo e dos recursos implantados da sua CloudFormation pilha chamada. `test-stack` Execute no mesmo diretório do seu modelo local.

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