Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

Cette page fournit des informations de référence pour la AWS Serverless Application Model `sam list resources` sous-commande Command Line Interface (AWS SAMCLI).

Pour une introduction à la AWS SAMCLI, voir [Qu'est-ce que c'est AWS SAMCLI ?](what-is-sam-overview.md#what-is-sam-cli)

La `sam list resources` sous-commande affiche les ressources de votre modèle AWS Serverless Application Model (AWS SAM) créées AWS CloudFormation par la AWS SAM transformation lors du déploiement.

**sam list resources**À utiliser avec un AWS SAM modèle avant le déploiement pour voir les ressources qui seront créées. Entrez un nom de CloudFormation pile pour afficher une liste consolidée incluant les ressources déployées.

**Note**  
Pour générer une liste de ressources à partir de votre AWS SAM modèle, une transformation locale de votre modèle est effectuée. Les ressources qui seront déployées sous certaines conditions, par exemple dans une région spécifique, sont incluses dans cette liste.

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

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

## 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>
Le nom d’environnement spécifiant les valeurs de paramètre par défaut dans le fichier de configuration à utiliser.  
*Valeur par défaut* : `default`  
Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--config-file TEXT`  <a name="sam-cli-command-reference-sam-list-resources-options-config-file"></a>
Le chemin d’accès et le nom du fichier de configuration contenant les valeurs de paramètres par défaut à utiliser.  
*Valeur par défaut* : `samconfig.toml` dans le répertoire de travail actuel.  
Pour plus d'informations sur les fichiers de configuration, consultez [Fichier de configuration CLI AWS SAM](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-list-resources-options-debug"></a>
Active la journalisation de débogage pour imprimer le message de débogage généré par la CLI  AWS SAM avec les horodatages.

`--help, -h`  <a name="sam-cli-command-reference-sam-list-resources-options-help"></a>
Affichez ce message et quittez.

`--output [json|table]`  <a name="sam-cli-command-reference-sam-list-resources-options-output"></a>
Spécifiez le format de sortie des résultats.  
*Valeur par défaut* : `table`

`--profile TEXT`  <a name="sam-cli-command-reference-sam-list-resources-options-profile"></a>
Sélectionnez un profil spécifique dans votre fichier d'informations d'identification pour obtenir des AWS informations d'identification.

`--region TEXT`  <a name="sam-cli-command-reference-sam-list-resources-options-region"></a>
Définissez la AWS région du service. Par exemple, `us-east-1`.

`--save-params`  <a name="sam-cli-command-reference-sam-list-resources-options-save-params"></a>
Enregistrez les paramètres que vous fournissez sur la ligne de commande dans le fichier AWS SAM de configuration.

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-list-resources-options-stack-name"></a>
Nom de la CloudFormation pile déployée. Le nom de la pile se trouve dans le fichier `samconfig.toml` de votre application ou dans le fichier de configuration désigné.  
Lorsqu'elle est fournie, la logique IDs des ressources de votre modèle sera mappée à leur entrée physique IDs correspondante. CloudFormation Pour en savoir plus sur les ressources physiques IDs, consultez la section [Champs de ressources](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resources-section-structure.html#resources-section-structure-resource-fields) dans le *guide de AWS CloudFormation l'utilisateur*.  
Lorsque cette option n'est pas spécifiée, les ressources locales définies dans votre modèle s'affichent.

`--template-file, --template, -t PATH`  <a name="sam-cli-command-reference-sam-list-resources-options-"></a>
AWS SAM fichier modèle.  
*Valeur par défaut* : `template.[yaml|yml|json]`

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

Affichez une sortie, sous forme de tableau, des ressources locales de votre AWS SAM modèle et des ressources déployées à partir de votre CloudFormation pile nommée`test-stack`. Exécuter à partir du même répertoire que votre fichier 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                        -
-------------------------------------------------------------------------------------------------------------------------
```