Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Você pode usar anotações e rótulos com o Gerenciador de infraestrutura.
Eles não são obrigatórios. Este documento lista os recursos aos quais você pode anexar
rótulos e anotações e descreve como você pode usá-los e onde pode
acessar. Para usar anotações ou rótulos com o Infra Manager, use as
sinais --annotation e --label.
O que são anotações e rótulos?
Anotações são pares de chave-valor de texto em formato livre. É possível usá-las para anexar
informações arbitrárias associadas ao recurso.
Você pode usar rótulos para organizar recursos. Por exemplo, é possível aplicar a lógica
com base na seleção de rótulos.
As anotações são usadas para armazenar informações não identificadoras normalmente usadas por
ferramentas de cliente para armazenar dados arbitrários anexados a um recurso, enquanto os rótulos são
usados para organizar recursos.
Para mais informações sobre o uso de anotações com Google Cloud, consulte a
documentação do AIP de anotações. Para saber mais sobre o uso de rótulos, consulte a documentação Visão geral de rótulos.
Restrições de anotação e rótulo
Assim como as anotações, os rótulos são pares de chave-valor que precisam estar em conformidade com as
seguintes limitações:
As chaves e os valores precisam ter 128 bytes ou menos.
As chaves e os valores podem conter apenas letras minúsculas, caracteres numéricos, sublinhados e traços.
As chaves precisam começar com uma letra minúscula ou um caractere internacional.
Todos os caracteres precisam usar a codificação UTF-8. Caracteres internacionais são permitidos.
Exemplo:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-19 UTC."],[[["\u003cp\u003eAnnotations and labels are optional key-value pairs used with Infrastructure Manager to attach information or organize resources.\u003c/p\u003e\n"],["\u003cp\u003eAnnotations store non-identifying, arbitrary text data associated with a resource, while labels are used for organizing resources.\u003c/p\u003e\n"],["\u003cp\u003eBoth annotations and labels have constraints, including a maximum length of 128 bytes for keys and values, and specific character restrictions.\u003c/p\u003e\n"],["\u003cp\u003eAnnotations and labels can be applied when creating or updating deployments with Infrastructure Manager to monitor deployments or query information sets.\u003c/p\u003e\n"]]],[],null,["# Annotations and labels\n\nYou can use annotations and labels with Infrastructure Manager.\nThey're not required. This document lists the resources to which you can attach\nlabels and annotations, and describes how you can use them and where you can\nview them. To use annotations or labels with Infra Manager, use the\n`--annotation` and `--label` flags.\n\nWhat are annotations and labels?\n--------------------------------\n\n*Annotations* are key-value pairs of free-form text. You can use them to attach\narbitrary information associated with the resource.\n\nYou can use *labels* to organize resources. For example, you can apply logic\nbased on label selection.\n\nAnnotations are used for storing non-identifying information typically used by\nclient tools to store arbitrary data attached to a resource, while labels are\ntypically used to organize resources.\n\nFor more information about using annotations with Google Cloud, see\n[annotations AIP](https://google.aip.dev/148#annotations) documentation. To learn more about using labels, see the\n[labels overview](/resource-manager/docs/labels-overview#what-are-labels) documentation.\n\nAnnotation and label constraints\n--------------------------------\n\nAs with annotations, labels are key-value pairs that must conform to the\nfollowing limitations:\n\n- Keys and values both must be 128 bytes or less.\n- Keys and values can contain only lowercase letters, numeric characters, underscores, and dashes.\n- Keys must start with a lowercase letter or international character.\n- All characters must use UTF-8 encoding. International characters are allowed.\n For example:\n\n --annotation=\"appVersion=v.1.2.3,environment=production\"\n\nUse annotations and labels with Infra Manager\n---------------------------------------------\n\nThe use of annotations and labels can be applied in a variety of ways across\nyour Google Cloud infrastructure.\n\nWhen you create or update deployments with Infra Manager, you can use\nannotations and labels to monitor deployments or query sets of information.\nFor more information, see [deploy infrastructure using Infra Manager](/infrastructure-manager/docs/deploy-resources),\n[update a deployment](/infrastructure-manager/docs/update-deployment), or [preview a deployment](/infrastructure-manager/docs/preview-deployment).\n\nWhat's next\n-----------\n\nUse Infra Manager to standardize, reuse, and scale your infrastructure\nwith Google Cloud:\n\n- [Deploy a VPC using Terraform](/infrastructure-manager/docs/deploy-vpc-with-terraform)\n- [Deploy infrastructure using Infra Manager](/infrastructure-manager/docs/deploy-resources)"]]
