Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Puedes usar anotaciones y etiquetas con el Administrador de infraestructura.
No son obligatorios. En este documento, se enumeran los recursos a los que puedes adjuntar etiquetas y anotaciones, y se describe cómo puedes usarlos y dónde puedes verlos. Para usar anotaciones o etiquetas con Infra Manager, usa las marcas --annotation y --label.
¿Qué son las anotaciones y las etiquetas?
Las anotaciones son pares clave-valor de texto de formato libre. Puedes usarlos para adjuntar información arbitraria asociada con el recurso.
Puedes usar etiquetas para organizar los recursos. Por ejemplo, puedes aplicar lógica
en función de la selección de etiquetas.
Las anotaciones se usan para almacenar información no de identificación que suelen usar las herramientas cliente para almacenar datos arbitrarios adjuntos a un recurso, mientras que las etiquetas suelen usarse para organizar recursos.
Para obtener más información sobre el uso de anotaciones con Google Cloud, consulta la documentación de la AIP de anotaciones. Para obtener más información sobre el uso de etiquetas, consulta la documentación de la descripción general de las etiquetas.
Restricciones de anotaciones y etiquetas
Al igual que con las anotaciones, las etiquetas son pares clave-valor que deben cumplir con las siguientes limitaciones:
Las claves y los valores deben tener 128 bytes o menos.
Las claves y los valores solo pueden contener letras en minúscula, caracteres numéricos, guiones bajos y guiones.
Las claves deben comenzar con una letra en minúscula o un carácter internacional.
Todos los caracteres deben usar la codificación UTF-8. Se permite el uso de caracteres internacionales.
Por ejemplo:
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-05 (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)"]]
