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

# CloudFormationMarcação de recursos do
<a name="aws-properties-resource-tags"></a>

Você pode aplicar tags aos recursos usando a propriedade `Tags` no modelo do CloudFormation, o que pode ajudar a identificar e categorizar esses recursos.

Para obter informações sobre quais são os recursos compatíveis com a propriedade `Tags`, consulte os recursos individuais na [Referência de tipos de propriedades e recursos da AWS](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-template-resource-type-ref.html). Se um recurso ainda não for compatível com a propriedade `Tags`, talvez o serviço do recurso seja compatível com aplicação de tags usando suas próprias operações de API. Para obter mais informações, consulte a documentação do serviço.

Além das tags que você define, o CloudFormation cria automaticamente as seguintes tags do nível de pilha com o prefixo `aws:`:
+ `aws:cloudformation:{{logical-id}}`
+ `aws:cloudformation:{{stack-id}}`
+ `aws:cloudformation:{{stack-name}}`

O prefixo `aws:` é reservado para uso da AWS. Esse prefixo não diferencia maiúsculas de minúsculas. Se você usar esse prefixo na propriedade `Key` ou `Value`, não será possível atualizar ou excluir a tag. As tags com esse prefixo não são contadas no número de tags por recurso.

A propagação das tags do nível de pilha para os recursos, inclusive as tags com o prefixo `aws:`, varia de acordo com o tipo de recurso. Por exemplo, as tags não são propagadas para volumes do Amazon EBS criados a partir do mapeamento de dispositivos de blocos. 

**nota**  
Alguns recursos exigem configurações explícitas de propagação de tags. Por exemplo, o recurso `AWS::AutoScaling::AutoScalingGroup` deve ter a propriedade `PropagateAtLaunch`definida como `true` para propagar tags para as suas instâncias do EC2. Porém, as tags do nível de pilha são aplicadas automaticamente às instâncias do EC2, independentemente da configuração `PropagateAtLaunch`.

## Sintaxe
<a name="w2aac14d554c13c17"></a>

### JSON
<a name="aws-properties-resource-tags-syntax.json"></a>

```
{
  "Key" : {{String}},
  "Value" : {{String}}
}
```

### YAML
<a name="aws-properties-resource-tags-syntax.yaml"></a>

```
Key: {{String}}
Value: {{String}}
```

## Propriedades
<a name="w2aac14d554c13c19"></a>

`Key`  <a name="cfn-resource-tags-key"></a>
O nome da chave da tag. Especifique um valor com 1 a 128 caracteres Unicode e que não tenha o prefixo `aws:`. É possível usar qualquer um dos caracteres a seguir: o conjunto Unicode de letras, dígitos, espaço em branco, `_`, `.`, `:`, `/`, `=`, `+`, `@`, `-` e `"`.  
*Obrigatório*: Sim  
*Tipo:* string

`Value`  <a name="cfn-resource-tags-value"></a>
O valor da tag. É possível especificar um valor de 1 a 256 caracteres de comprimento. Use qualquer um dos seguintes caracteres: o conjunto de letras, dígitos, espaço em branco, `_`, `.`, `/`, `=`, `+` e `-`.  
*Obrigatório*: Sim  
*Tipo:* string

## Exemplo
<a name="aws-properties-resource-tags-examples"></a>

Este exemplo mostra uma propriedade `Tags`. Você especifica essa propriedade na seção `Properties` de um recurso compatível. Quando o recurso é criado, a tag `Environment` é definida dinamicamente usando um parâmetro, e a tag `Owner` é definida estaticamente como `MyName`.

### JSON
<a name="aws-properties-resource-tags-example.json"></a>

```
 1. "Tags" : [
 2.    {
 3.       "Key" : "Environment",
 4.       "Value" : { "Ref": "Environment" }
 5.    },
 6.    {
 7.       "Key" : "Owner",
 8.       "Value" : "MyName"
 9.    }
10. ]
```

### YAML
<a name="aws-properties-resource-tags-example.yaml"></a>

```
1. Tags: 
2.   - Key: Environment
3.     Value: !Ref Environment
4.   - Key: Owner
5.     Value: MyName
```

## Consulte também
<a name="w2aac14d554c13c23"></a>
+ [Configurar opções de pilha](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html#configure-stack-options) no *Guia do usuário do AWS CloudFormation*
+ [Visualizar dados e recursos da pilha do CloudFormation no Console de gerenciamento da AWS](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-view-stack-data-resources.html) no *Guia do usuário do AWS CloudFormation*