

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.

# Attributs de ressources pris en charge par AWS SAM
<a name="sam-specification-resource-attributes"></a>

Les attributs de ressources sont des attributs auxquels vous pouvez ajouter AWS SAM CloudFormation des ressources pour contrôler des comportements et des relations supplémentaires. Pour plus d'informations sur les attributs des ressources, consultez [Référence d'attribut de ressource](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-product-attribute-reference.html) dans le *Guide de l'utilisateur AWS CloudFormation *.

AWS SAM prennent en charge un sous-ensemble d'attributs de ressources définis par CloudFormation. Parmi les attributs de ressources pris en charge, certains sont copiés uniquement dans la CloudFormation ressource générée de base de la AWS SAM ressource correspondante, tandis que d'autres sont copiés dans toutes les CloudFormation ressources générées à partir de la AWS SAM ressource correspondante. Pour plus d'informations sur CloudFormation les ressources générées à partir AWS SAM des ressources correspondantes, consultez[CloudFormation Ressources générées pour AWS SAM](sam-specification-generated-resources.md).

Le tableau suivant récapitule la prise en charge des attributs de ressources par AWS SAM, sous réserve de ce qui est [Exceptions](#sam-specification-resource-attributes-exceptions) indiqué ci-dessous.


| Attributs de ressource | Ressource(s) Destination générée(s) | 
| --- | --- | 
|  ** [DependsOn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-dependson.html) ** ** [Métadonnées](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-metadata.html) **1, 2  |  Ressource CloudFormation générée par la base uniquement. Pour plus d'informations sur le mappage entre les AWS SAM ressources et les CloudFormation ressources de base, consultez[Scénarios CloudFormation de ressources générés](sam-specification-generated-resources.md#sam-specification-generated-resources-scenarios).  | 
| ** [Condition](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/conditions-section-structure.html) ** ** [DeletionPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-deletionpolicy.html) ** ** [UpdateReplacePolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-updatereplacepolicy.html) **  |  Toutes les CloudFormation ressources générées à partir de la AWS SAM ressource correspondante. Pour plus d'informations sur les scénarios relatifs CloudFormation aux ressources générées, consultez[Scénarios CloudFormation de ressources générés](sam-specification-generated-resources.md#sam-specification-generated-resources-scenarios).  | 

**Remarques** :

1. Pour plus d'informations sur l'utilisation de l'attribut de ressource `Metadata` avec le type de ressource `AWS::Serverless::Function`, consultez [Création de fonctions Lambda avec des environnements d'exécution personnalisés dans AWS SAM](building-custom-runtimes.md).

1. Pour plus d'informations sur l'utilisation de l'attribut de ressource `Metadata` avec le type de ressource `AWS::Serverless::LayerVersion`, consultez [Création de couches Lambda dans AWS SAM](building-layers.md).

## Exceptions
<a name="sam-specification-resource-attributes-exceptions"></a>

Il existe un certain nombre d'exceptions aux règles d'attribut de ressource décrites précédemment :
+ Car`AWS::Lambda::LayerVersion`, le champ personnalisé AWS SAM-only `RetentionPolicy` définit `DeletionPolicy` les CloudFormation ressources générées. La priorité est plus élevée que pour `DeletionPolicy`. Si aucun n'est défini, `DeletionPolicy` est alors défini par défaut sur `Retain`.
+ Pour `AWS::Lambda::Version`, si `DeletionPolicy` n'est pas spécifié, la valeur par défaut est `Retain`.
+ Dans le cas où une fonction sans serveur `DeploymentPreferences` est spécifiée, les attributs de ressources ne sont pas copiés dans les CloudFormation ressources générées suivantes :
  + `AWS::CodeDeploy::Application`
  + `AWS::CodeDeploy::DeploymentGroup`
  + Le `AWS::IAM::Role` nommé `CodeDeployServiceRole`, qui est créé pour ce scénario
+ Si votre AWS SAM modèle contient plusieurs fonctions dont les sources d'événements d'API sont créées implicitement, les fonctions partageront la `AWS::ApiGateway::RestApi` ressource générée. Dans ce scénario, si les fonctions ont des attributs de ressource différents, pour la `AWS::ApiGateway::RestApi` ressource générée, AWS SAM copie les attributs de ressource conformément aux listes de priorité suivantes :
  + `UpdateReplacePolicy`:

    1. `Retain`

    1. `Snapshot`

    1. `Delete`
  + `DeletionPolicy`:

    1. `Retain`

    1. `Delete`