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).
# Referência de tipos de propriedade compartilhados
Esta seção contém informações de referência detalhadas para tipos de propriedade que o CloudFormation aceita para uso em vários tipos de recursos.
**Topics**
+ [Nomenclatura personalizada dos recursos do CloudFormation](aws-properties-name.md)
+ [CloudFormationMarcação de recursos do](aws-properties-resource-tags.md)
# Nomenclatura personalizada dos recursos do CloudFormation
Você pode atribuir nomes personalizados aos tipos de recursos compatíveis no modelo do CloudFormation para torná-los mais significativos e facilmente identificáveis. Por padrão, o CloudFormation gera um ID físico exclusivo para nomear um recurso. Por exemplo, o CloudFormation pode nomear um bucket do Amazon S3 com o ID físico a seguir `MyStack-MyBucket-abcdefghijk1`. Com nomes personalizados, é possível especificar um nome que seja mais fácil de ler e identificar, como `production-app-logs` ou `business-metrics`.
Nem todos os recursos são compatíveis com nomes personalizados. Cada serviço da AWS determina independentemente quais tipos de recurso são compatíveis com nomes personalizados.
Os nomes de recurso devem ser exclusivos em todas as pilhas ativas. Caso reutilize modelos para criar várias pilhas, você deve alterar ou remover nomes personalizados do modelo. Caso você não especifique um nome, o CloudFormation gera um ID físico exclusivo para nomear o recurso. Os nomes devem começar com uma letra, conter apenas letras ASCII, dígitos e hifens, e não terminar com um hífen ou conter dois hifens consecutivos.
Além disso, não gerencie recursos de pilha fora do CloudFormation. Por exemplo, se renomear um recurso que faça parte de uma pilha sem usar o CloudFormation, você poderá receber um erro sempre que tentar atualizar ou excluir essa pilha.
**Importante**
Você não pode realizar uma atualização que cause a substituição do recurso personalizado. Caso você precise substituir o recurso, especifique um nome novo.
## Exemplo
Caso você queira usar um nome personalizado, especifique uma propriedade de nome para esse recurso no modelo do CloudFormation. Cada recurso que dá suporte a nomes personalizados tem a própria propriedade especificada por você. Por exemplo, para nomear uma tabela do DynamoDB, você usa a propriedade `TableName`, conforme indicado na seguinte amostra:
### JSON
```
"myDynamoDBTable" : {
"Type" : "AWS::DynamoDB::Table",
"Properties" : {
"KeySchema" : {
"HashKeyElement": {
"AttributeName" : "AttributeName1",
"AttributeType" : "S"
},
"RangeKeyElement" : {
"AttributeName" : "AttributeName2",
"AttributeType" : "N"
}
},
"ProvisionedThroughput" : {
"ReadCapacityUnits" : "5",
"WriteCapacityUnits" : "10"
},
"TableName" : "SampleTable"
}
}
```
### YAML
```
myDynamoDBTable:
Type: AWS::DynamoDB::Table
Properties:
KeySchema:
HashKeyElement:
AttributeName: "AttributeName1"
AttributeType: "S"
RangeKeyElement:
AttributeName: "AttributeName2"
AttributeType: "N"
ProvisionedThroughput:
ReadCapacityUnits: "5"
WriteCapacityUnits: "10"
TableName: "SampleTable"
```
# CloudFormationMarcação de recursos do
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
### JSON
```
{
"Key" : String,
"Value" : String
}
```
### YAML
```
Key: String
Value: String
```
## Propriedades
`Key`
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`
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
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
```
1. "Tags" : [
2. {
3. "Key" : "Environment",
4. "Value" : { "Ref": "Environment" }
5. },
6. {
7. "Key" : "Owner",
8. "Value" : "MyName"
9. }
10. ]
```
### YAML
```
1. Tags:
2. - Key: Environment
3. Value: !Ref Environment
4. - Key: Owner
5. Value: MyName
```
## Consulte também
+ [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*