

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á.

# Atributos de recursos suportados por AWS SAM
<a name="sam-specification-resource-attributes"></a>

Atributos de recursos são atributos que você pode adicionar AWS SAM e CloudFormation recursos para controlar comportamentos e relacionamentos adicionais. Para obter mais informações sobre atributos de recursos, consulte [Referência de atributos](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-product-attribute-reference.html) de recursos no *Guia AWS CloudFormation do usuário*.

AWS SAM suportam um subconjunto de atributos de recursos que são definidos por CloudFormation. Dos atributos de recursos suportados, alguns são copiados somente para o CloudFormation recurso gerado base do AWS SAM recurso correspondente e alguns são copiados para todos os CloudFormation recursos gerados resultantes do recurso correspondente AWS SAM . Para obter mais informações sobre CloudFormation os recursos gerados a partir AWS SAM dos recursos correspondentes, consulte[CloudFormation Recursos gerados para AWS SAM](sam-specification-generated-resources.md).

A tabela a seguir resume o suporte a atributos de recursos por AWS SAM, de acordo com a [Exceções](#sam-specification-resource-attributes-exceptions) lista abaixo.


| Atributos de recursos | Recurso(s) gerado(s) pelo destino | 
| --- | --- | 
|  ** [DependsOn](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-dependson.html) ** **[Metadados](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-metadata.html)** 1, 2  |  Somente recurso CloudFormation gerado por base. Para obter informações sobre o mapeamento entre AWS SAM recursos e CloudFormation recursos básicos, consulte[Cenários CloudFormation de recursos gerados](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) **  |  Todos os CloudFormation recursos gerados a partir do AWS SAM recurso correspondente. Para obter informações sobre cenários para CloudFormation recursos gerados, consulte[Cenários CloudFormation de recursos gerados](sam-specification-generated-resources.md#sam-specification-generated-resources-scenarios).  | 

**Observações:**

1. Para obter mais informações sobre como usar o atributo de recurso `Metadata` com o tipo de recurso `AWS::Serverless::Function`, consulte [Criação de funções Lambda com tempos de execução personalizados no AWS SAM](building-custom-runtimes.md).

1. Para obter mais informações sobre como usar o atributo de recurso `Metadata` com o tipo de recurso `AWS::Serverless::LayerVersion`, consulte [Construindo camadas Lambda em AWS SAM](building-layers.md).

## Exceções
<a name="sam-specification-resource-attributes-exceptions"></a>

Há várias exceções às regras de atributos de recursos descritas anteriormente:
+ Para`AWS::Lambda::LayerVersion`, o campo personalizado AWS SAM-only `RetentionPolicy` define `DeletionPolicy` os CloudFormation recursos gerados. Isso tem uma precedência maior do que `DeletionPolicy` ele mesmo. Se nenhum estiver definido, então, por padrão, será `DeletionPolicy` definido como `Retain`.
+ Para `AWS::Lambda::Version`, se `DeletionPolicy` não especificado, o padrão será `Retain`.
+ Para o cenário em que `DeploymentPreferences` é especificado para uma função sem servidor, os atributos do recurso não são copiados para os seguintes recursos gerados: CloudFormation 
  + `AWS::CodeDeploy::Application`
  + `AWS::CodeDeploy::DeploymentGroup`
  + O `AWS::IAM::Role` chamado `CodeDeployServiceRole` que é criado para esse cenário
+ Se seu AWS SAM modelo contiver várias funções com fontes de eventos de API criadas implicitamente, as funções compartilharão o `AWS::ApiGateway::RestApi` recurso gerado. Nesse cenário, se as funções tiverem atributos de recursos diferentes, então, para o `AWS::ApiGateway::RestApi` recurso gerado, AWS SAM copie os atributos do recurso de acordo com as seguintes listas priorizadas:
  + `UpdateReplacePolicy`:

    1. `Retain`

    1. `Snapshot`

    1. `Delete`
  + `DeletionPolicy`:

    1. `Retain`

    1. `Delete`