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

"Tags" : [
   {
      "Key" : "Environment",
      "Value" : { "Ref": "Environment" }
   },
   {
      "Key" : "Owner",
      "Value" : "MyName"
   }
]

YAML

Tags: 
  - Key: Environment
    Value: !Ref Environment
  - Key: Owner
    Value: MyName

Consulte também

• Configurar opções de pilha no Guia do usuário do AWS CloudFormation

• Visualizar dados e recursos da pilha do CloudFormation no Console de gerenciamento da AWS no Guia do usuário do AWS CloudFormation