Este é o novo *Guia de referência de modelos do CloudFormation*. Atualize seus favoritos e links. Para obter ajuda para começar a usar o CloudFormation, consulte o [Guia do usuário do AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).

# Atributo `Metadata`
<a name="aws-attribute-metadata"></a>

O atributo `Metadata` permite a você associar dados estruturados a um recurso. Ao adicionar um atributo `Metadata` a um recurso, é possível adicionar dados em JSON ou YAML à declaração do recurso. Além disso, você pode usar funções intrínsecas (como [`Fn::GetAtt`](intrinsic-function-reference-getatt.md) e [`Ref`](intrinsic-function-reference-ref.md)), parâmetros e pseudoparâmetros dentro do atributo `Metadata` para adicionar esses valores interpretados.

**nota**  
O CloudFormation não valida a sintaxe dentro do atributo de metadados.

**Importante**  
O CloudFormation não edita nem ofusca nenhuma informação incluída no atributo dos metadados. É altamente recomendável não usar essa seção para armazenar informações confidenciais, como senhas ou segredos.

É possível recuperar esses dados usando o comando da CLI [describe-stack-resource](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/describe-stack-resource.html) ou a operação da API [DescribeStackResource](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_DescribeStackResource.html).

## Exemplo
<a name="aws-attribute-metadata-example"></a>

O modelo a seguir contém um recurso de bucket do Amazon S3 com um atributo `Metadata`.

### JSON
<a name="aws-attribute-metadata-example.json"></a>

```
{
   "AWSTemplateFormatVersion" : "2010-09-09",
   "Resources" : {
      "MyBucket" : {
         "Type" : "AWS::S3::Bucket",
         "Metadata" : { 
            "Object1" : "Location1",
            "Object2" : "Location2" 
         }
      }
   }
}
```

### YAML
<a name="aws-attribute-metadata-example.yaml"></a>

```
1. AWSTemplateFormatVersion: '2010-09-09'
2. Resources:
3.   MyBucket:
4.     Type: AWS::S3::Bucket
5.     Metadata:
6.       Object1: Location1
7.       Object2: Location2
```