Etiquetar los recursos de Amazon EC2

Para ayudarle a administrar las instancias, imágenes y otros recursos de Amazon EC2, puede asignar sus propios metadatos a cada recurso en forma de etiquetas. Las etiquetas le permiten clasificar los recursos de AWS de diversas maneras, por ejemplo, según su finalidad, propietario o entorno. Esto es útil cuando tiene muchos recursos del mismo tipo: puede identificar rápidamente un recurso específico en función de las etiquetas que le haya asignado. En este tema se describe qué son las etiquetas y cómo crearlas.

aviso

Las claves de etiqueta y sus valores se devuelven mediante muchas llamadas a API diferentes. Denegar el acceso a DescribeTags no deniega automáticamente el acceso a etiquetas devueltas por otras API. Como práctica recomendada, no debe incluir datos confidenciales en las etiquetas.

Conceptos básicos de etiquetas

Una etiqueta es una marca que se asigna a un recurso de AWS. Cada etiqueta está formada por una clave y un valor opcional, ambos definidos por el usuario.

Las etiquetas le permiten clasificar los recursos de AWS de diversas maneras, por ejemplo, según su finalidad, propietario o entorno. Por ejemplo, podría definir un conjunto de etiquetas para las instancias Amazon EC2 de su cuenta que le ayude a realizar un seguimiento del propietario y el nivel de la pila de cada instancia.

El siguiente diagrama ilustra el funcionamiento del etiquetado. En este ejemplo, se han asignado dos etiquetas a cada una de las instancias — una etiqueta con la clave Owner y la otra con la clave Stack. Cada etiqueta dispone además de un valor asociado.

Le recomendamos que idee un conjunto de claves de etiqueta que cumpla sus necesidades para cada tipo de recurso. Mediante el uso de un conjunto coherente de claves de etiquetas, podrá administrar los recursos de más fácilmente. Puede buscar y filtrar los recursos en función de las etiquetas que agregue. Para obtener más información sobre cómo implementar una estrategia eficaz de etiquetado de recursos, consulte el documento técnico de AWS Tagging Best Practices (Prácticas recomendadas de etiquetado).

Las etiquetas no tienen ningún significado semántico para Amazon EC2, por lo que se interpretan estrictamente como cadenas de caracteres. Además, las etiquetas no se asignan a los recursos automáticamente. Puede editar las claves y los valores de las etiquetas y también puede eliminar etiquetas de un recurso en cualquier momento. Puede establecer el valor de una etiqueta como una cadena vacía, pero no puede asignarle un valor nulo. Si añade una etiqueta con la misma clave que una etiqueta existente en ese recurso, el nuevo valor sobrescribirá al antiguo. Si elimina un recurso, también se eliminará cualquier etiqueta asignada a dicho recurso.

nota

Después de eliminar un recurso, es posible que sus etiquetas permanezcan visibles en la consola, la API y la salida de la CLI durante un corto periodo de tiempo. Estas etiquetas se desasociarán del recurso de forma gradual y se eliminarán permanentemente.

Etiquetar los recursos

Puede etiquetar la mayoría de los recursos de Amazon EC2 que ya existen en la cuenta. La siguiente tabla enumera los recursos que admiten etiquetas.

Si utiliza la consola de Amazon EC2, puede aplicar etiquetas a los recursos mediante la pestaña Etiquetas de la pantalla correspondiente al recurso, o puede usar el Editor de etiquetas en la consola de AWS Resource Groups. Algunas pantallas de recursos le permiten especificar etiquetas para un recurso al crear dicho recurso; por ejemplo, una etiqueta con una clave de Name y un valor que especifique. En la mayoría de los casos, la consola aplica las etiquetas inmediatamente después de crear el recurso (y no durante la creación del mismo). La consola puede organizar los recursos según la etiqueta Name, si bien dicha etiqueta no tiene ningún significado semántico para el servicio Amazon EC2.

Si utiliza la API de Amazon EC2, la AWS CLI o un AWS SDK, puede usar la acción CreateTags de la API de EC2 para aplicar etiquetas a los recursos existentes. Además, algunas acciones de creación de recursos le permiten especificar etiquetas para un recurso al crear dicho recurso. Si no se pueden aplicar etiquetas durante la creación del recurso, el proceso de creación del recurso se revierte. Esto garantiza que los recursos se creen con etiquetas o, de lo contrario, no se creen y que ningún recurso se quede jamás sin etiquetar. Al etiquetar los recursos en el momento de su creación, se eliminar la necesidad de ejecutar scripts de etiquetado personalizados tras la creación del recurso. Para obtener más información acerca de cómo habilitar a los usuarios para etiquetar recursos al crear, consulte Conceder permisos para etiquetar recursos durante la creación.

En la tabla siguiente se describen los recursos de Amazon EC2 que se pueden etiquetar y aquellos que se pueden etiquetar en el momento de su creación con la API de Amazon EC2, la AWS CLI o un AWS SDK.

Compatibilidad con el etiquetado de recursos de Amazon EC2
Recurso	Admite etiquetas	Admite el etiquetado durante la creación
AFI	Sí	Sí
AMI	Sí	Sí
Tarea en paquete	No	No
Capacity Reservation	Sí	Sí
Gateway de operador	Sí	Sí
Punto de enlace de Client VPN	Sí	Sí
Ruta de Client VPN	No	No
Gateway de cliente	Sí	Sí
Dedicated Host	Sí	Sí
Reserva de host dedicado	Sí	Sí
Opciones de DHCP	Sí	Sí
Instantánea de EBS	Sí	Sí
Volumen de EBS	Sí	Sí
EC2 Fleet	Sí	Sí
Gateway de Internet de solo salida	Sí	Sí
Dirección IP elástica	Sí	Sí
Acelerador de Elastic Graphics	Sí	No
Instancia	Sí	Sí
Ventana de evento de instancia	Sí	Sí
Volumen de almacén de instancias	N/A	N/A
Gateway de Internet	Sí	Sí
Grupo de direcciones IP (BYOIP)	Sí	Sí
Par de claves	Sí	Sí
Plantilla de lanzamiento	Sí	Sí
Lanzar la versión de plantilla	No	No
Gateway local	Sí	No
Tabla de enrutamiento de gateway local	Sí	No
Interfaz virtual de gateway local	Sí	No
Grupo de interfaz virtual de gateway local	Sí	No
Asociación de VPC de tabla de enrutamiento de gateway local	Sí	Sí
Asociación de grupo de interfaz virtual de tabla de enrutamiento de gateway local	Sí	No
gateway NAT	Sí	Sí
ACL de red	Sí	Sí
Interfaz de red	Sí	Sí
Grupo de ubicación	Sí	Sí
Listas de prefijos	Sí	Sí
Reserved Instance	Sí	No
Listado de Instancia reservada	No	No
Tabla de ruteo	Sí	Sí
Solicitud de flota de spot	Sí	Sí
Solicitud de instancia de spot	Sí	Sí
Grupo de seguridad	Sí	Sí
Regla del grupo de seguridad	Sí	No
Subred	Sí	Sí
Filtro de reflejo de tráfico	Sí	Sí
Sesión de reflejo de tráfico	Sí	Sí
Destino de reflejo de tráfico	Sí	Sí
Transit gateway	Sí	Sí
Dominio de multidifusión de gateway de tránsito	Sí	Sí
Tabla de ruteo de la gateway de tránsito	Sí	Sí
Vinculación VPC de la gateway de tránsito	Sí	Sí
Gateway privada virtual	Sí	Sí
VPC	Sí	Sí
Punto de conexión VPC	Sí	Sí
Servicio de punto de enlace de la VPC	Sí	Sí
Configuración de servicio de punto de conexión de VPC	Sí	Sí
Registro de flujo de VPC	Sí	Sí
Interconexión de VPC	Sí	Sí
conexión de VPN	Sí	Sí

Puede etiquetar las instancias, volúmenes, elastic graphics, interfaces de red y solicitudes de instancias de spot al crearlos mediante el asistente de lanzamiento de instancias de Amazon EC2 en la consola de Amazon EC2. Puede etiquetar los volúmenes de EBS durante la creación en la pantalla Volúmenes o las instantáneas de EBS en la pantalla Instantáneas. Si lo prefiere, puede usar una API de Amazon EC2 de creación de recursos (por ejemplo, RunInstances) para aplicar etiquetas al crear un recurso.

En sus políticas de IAM, puede aplicar permisos de nivel de recursos basados en etiquetas a las acciones de la API de Amazon EC2 que admitan el etiquetado durante la creación para implementar un control detallado de los usuarios y los grupos que pueden etiquetar recursos durante su creación. Sus recursos están debidamente protegidos frente a la creación — las etiquetas se aplican inmediatamente a los recursos, por lo que cualquier permiso de nivel de recursos basado en etiquetas que controle el uso de los recursos es efectivo inmediatamente. Se puede realizar un seguimiento y un registro más precisos de los recursos. Puede establecer el etiquetado obligatorio de los nuevos recursos y controlar qué claves y valores de etiquetas se usan en ellos.

También puede aplicar permisos de nivel de recursos para las acciones CreateTags y DeleteTags de la API de Amazon EC2 en las políticas de IAM para controlar qué claves y valores de etiquetas se usan en los recursos existentes. Para obtener más información, consulte Ejemplo: Etiquetar recursos.

Para obtener más información acerca del etiquetado de recursos para facturación, consulte Uso de etiquetas de asignación de costos en la Guía del usuario de AWS Billing.

Restricciones de las etiquetas

Se aplican las siguientes restricciones básicas a las etiquetas:

• Número máximo de etiquetas por recurso: 50

• Para cada recurso, cada clave de etiqueta debe ser única y solo puede tener un valor.

• Longitud máxima de la clave: 128 caracteres Unicode en UTF-8

• Longitud máxima del valor: 256 caracteres Unicode en UTF-8

• Caracteres permitidos

  • Si bien EC2 admite el uso de cualquier carácter en sus etiquetas, otros servicios de AWS son más restrictivos. Los caracteres permitidos en los servicios de AWS son: letras (a-z, A-Z), números (0-9) y espacios representables en UTF-8, además de los siguientes caracteres: + - = . _ : / @.

  • Si habilita las etiquetas de instancia en los metadatos de la instancia, la etiqueta de instancia claves solo puede utilizar letras (a-z, A-Z), números (0-9) y los siguientes caracteres: + - = . , _ : @. Las claves de etiquetas de instancias no pueden contener espacios ni /, y no pueden constar solo de . (un punto), de .. (dos puntos ) o de _index. Para obtener más información, consulte Trabajar con etiquetas de instancia en los metadatos de instancia.

• Las claves y los valores de las etiquetas distinguen entre mayúsculas y minúsculas.

• El prefijo aws: se reserva para uso de AWS. Si la etiqueta tiene una clave de etiqueta con este prefijo, no puede editar ni eliminar la clave o el valor de la etiqueta. Las etiquetas que tengan el prefijo aws: no cuentan para el límite de etiquetas por recurso.

No puede terminar, detener ni eliminar un recurso basado únicamente en sus etiquetas; debe especificar el identificador del recurso. Por ejemplo, para eliminar instantáneas que etiquetó con una clave de etiqueta llamada DeleteMe, debe utilizar la acción DeleteSnapshots con los identificadores del recurso de las instantáneas, como snap-1234567890abcdef0.

Cuando etiqueta recursos públicos o compartidos, las etiquetas que asigne solo están disponibles para su cuenta de AWS; ninguna otra cuenta de AWS tendrá acceso a esas etiquetas. Para el control de acceso a recursos compartidos basado en etiquetas, cada cuenta de AWS debe asignar su propio conjunto de etiquetas para controlar el acceso al recurso.

No puede etiquetar todos los recursos. Para obtener más información, consulte Compatibilidad con el etiquetado de recursos de Amazon EC2.

Administración de etiquetas y accesos

Si utiliza AWS Identity and Access Management (IAM), puede controlar qué usuarios de su cuenta de AWS tienen permiso para crear, editar o eliminar etiquetas. Para obtener más información, consulte Conceder permisos para etiquetar recursos durante la creación.

También puede usar etiquetas de recursos para implementar el control basado en atributos (ABAC). Puede crear directivas de IAM que permitan operaciones basadas en las etiquetas del recurso. Para obtener más información, consulte Control del acceso a recursos de EC2 mediante etiquetas de recursos.

Etiquetar los recursos para facturación

Puede usar etiquetas para organizar la factura de AWS de modo que refleje su propia estructura de costos. Para ello, inscríbase para obtener una factura de la cuenta de AWS que incluya valores de clave de etiquetas. Para obtener más información sobre la configuración de un informe de asignación de costos con etiquetas, consulte Informe de asignación de costos mensual en la Guía del usuario de AWS Billing. Para ver el costo de los recursos combinados, puede organizar la información de facturación basada en los recursos que tienen los mismos valores de clave de etiqueta. Por ejemplo, puede etiquetar varios recursos con un nombre de aplicación específico y luego organizar su información de facturación para ver el costo total de la aplicación en distintos servicios. Para obtener más información, consulte Uso de etiquetas de asignación de costos en la Guía del usuario de AWS Billing.

nota

Si acaba de habilitar la realización de informes, los datos correspondientes al mes actual estarán disponibles para su visualización transcurridas 24 horas.

Las etiquetas de asignación de costos pueden indicar qué recursos influyen en los costos. Sin embargo, eliminar o desactivar los recursos no reduce necesariamente los costos. Por ejemplo, los datos de una instantánea a los que se haga referencia en otra instantánea se conservan incluso si se elimina la instantánea que contiene los datos originales. Para obtener más información, consulte Volúmenes e instantáneas de Amazon Elastic Block Store en la Guía del usuario de AWS Billing.

nota

Las direcciones IP elásticas que se han etiquetado no aparecen en el informe de asignación de costos.

Trabajar con etiquetas mediante la consola

Puede utilizar la consola de Amazon EC2 para mostrar las etiquetas de un recurso individual y para aplicar o eliminar etiquetas en uno o varios recursos a la vez.

Puede utilizar el Editor de etiquetas de la consola de AWS Resource Groups para mostrar las etiquetas de todos sus recursos de Amazon EC2 en todas las regiones. Puede ver etiquetas por recurso y por tipo de recurso, así como los tipos de recursos asociados a una etiqueta determinada. Puede aplicar o eliminar etiquetas en varios recursos y varios tipos de recursos a la vez. Editor de etiquetas proporciona una forma unificada y centralizada de crear y administrar sus etiquetas. Para obtener más información, consulte Guía del usuario para el etiquetado de recursos de AWS.

Tareas

• Mostrar etiquetas
• Agregar y eliminar etiquetas en un recurso individual
• Agregar y eliminar etiquetas para varios recursos
• Agregar una etiqueta cuando lanza una instancia
• Filtrar una lista de recursos por etiqueta

Mostrar etiquetas

Puede mostrar las etiquetas de un recurso individual en la consola de Amazon EC2. Para mostrar las etiquetas de todos sus recursos, utilice el Editor de etiquetas de la consola de AWS Resource Groups.

Mostrar etiquetas de un recurso individual

Al seleccionar una página específica de un recurso en la consola de Amazon EC2, se muestra una lista de dicho recurso. Por ejemplo, si selecciona Instances (Instancia[s]) en el panel de navegación, la consola muestra una lista de las instancias Amazon EC2. Al seleccionar un recurso de una de estas listas (por ejemplo, una instancia), si el recurso admite etiquetas, puede ver y administrar sus etiquetas. En la mayoría de las páginas de recursos, puede ver las etiquetas al elegir la pestaña Tags (Etiquetas).

Puede agregar una columna a la lista de recursos para mostrar todos los valores para las etiquetas con la misma clave. Esta columna permite ordenar y filtrar la lista de recursos por etiqueta.

New console

Para agregar una columna a la lista de recursos para mostrar las etiquetas

1. En la consola de EC2, elija el icono Preferencias (el engranaje) de la esquina superior derecha de la pantalla.

2. En el cuadro de diálogo Preferencias, en Columnas de etiqueta (abajo a la izquierda), seleccione una de las claves de etiqueta más y, a continuación, elija Confirmar.

Old console

Existen dos maneras de agregar una nueva columna a la lista de recursos para mostrar las etiquetas.

• En la pestaña Tags (Etiquetas), seleccione Show Column (Mostrar columna). Se añade una nueva columna en la consola.

• Elija el icono con forma de engranaje Show/Hide Columns (Mostrar/ocultar columnas) y, en cuadro de diálogo Show/Hide Columns (Mostrar/ocultar columnas), seleccione la clave de etiqueta en Your Tag Keys (Sus claves de etiquetas).

Mostrar etiquetas para múltiples recursos

Puede mostrar etiquetas en varios recursos mediante el Editor de etiquetas de la consola de AWS Resource Groups. Para obtener más información, consulte Guía del usuario para el etiquetado de recursos de AWS.

Agregar y eliminar etiquetas en un recurso individual

Puede administrar las etiquetas para un recurso individual directamente desde la página del recurso.

Para añadir una etiqueta a un recurso individual

1. Abra la consola de Amazon EC2 en https://console.aws.amazon.com/ec2/.

2. En la barra de navegación, seleccione la región donde se encuentra el recurso que desea etiquetar. Para obtener más información, consulte Ubicaciones de los recursos.

3. En el panel de navegación, seleccione un tipo de recurso (por ejemplo, Instances (Instancia[s])).

4. Seleccione el recurso de la lista de recursos y elija Tags (Etiquetas).

5. Elija la pestaña Administrar etiquetas y, a continuación, elija Agregar nueva etiqueta. Escriba la clave y el valor de para la etiqueta. Elija Agregar nueva etiqueta para cada etiqueta adicional. Cuando haya terminado de agregar etiquetas, elija Save (Guardar).

Para eliminar una etiqueta de un recurso individual

1. Abra la consola de Amazon EC2 en https://console.aws.amazon.com/ec2/.

2. En la barra de navegación, seleccione la región donde se encuentra el recurso al cual desea eliminar la etiqueta. Para obtener más información, consulte Ubicaciones de los recursos.

3. En el panel de navegación, elija un tipo de recurso (por ejemplo, Instances (Instancia[s])).

4. Seleccione el recurso de la lista de recursos y elija Tags (Etiquetas).

5. Elija Manage tags (Administrar etiquetas). Por cada etiqueta a eliminar, elija Quitar. Cuando termine de quitar las etiquetas, elija Save (Guardar).

Agregar y eliminar etiquetas para varios recursos

Para agregar una etiqueta a varios recursos

1. Abra el Editor de etiquetas en la consola de AWS Resource Groups en https://console.aws.amazon.com/resource-groups/tag-editor.

2. En Regiones, seleccione una o varias regiones donde se encuentran los recursos a los cuales desea etiquetar.

3. En Tipos de recursos, seleccione el tipo de recursos que desee etiquetar (por ejemplo, AWS::EC2::Instance).

4. Seleccione Buscar recursos.

5. En Resultados de la búsqueda de recursos, seleccione la casilla de verificación situada junto a cada recurso que desee etiquetar.

6. Seleccione Administrar las etiquetas de los recursos seleccionados.

7. En Editar etiquetas de todos los recursos seleccionados, elija Agregar etiqueta y, a continuación, introduzca la nueva clave y el valor de la etiqueta. Elija Add tag (Agregar etiqueta) para cada etiqueta adicional.

   nota

   Si añade una nueva etiqueta con la misma clave que una etiqueta existente, la nueva etiqueta sobrescribirá a la antigua.

8. Seleccione Revisar y aplicar cambios en la etiqueta.

9. Elija Apply changes to all selected (Aplicar cambios a todo lo seleccionado).

Para eliminar una etiqueta de múltiples recursos

1. Abra el Editor de etiquetas en la consola de AWS Resource Groups en https://console.aws.amazon.com/resource-groups/tag-editor.

2. En Regiones, seleccione las regiones donde se encuentran los recursos a los cuales desea desetiquetar.

3. En Tipos de recursos, seleccione el tipo de recursos que desee desetiquetar (por ejemplo, AWS::EC2::Instance).

4. Seleccione Buscar recursos.

5. En Resultados de la búsqueda de recursos, seleccione la casilla de verificación situada junto a cada recurso que desee desetiquetar.

6. Seleccione Administrar las etiquetas de los recursos seleccionados.

7. En Editar etiquetas de todos los recursos seleccionados, seleccione Eliminar etiqueta junto a la etiqueta que desee eliminar.

8. Seleccione Revisar y aplicar cambios en la etiqueta.

9. Elija Apply changes to all selected (Aplicar cambios a todo lo seleccionado).

Agregar una etiqueta cuando lanza una instancia

New console

Para agregar una etiqueta mediante el asistente de instancias de lanzamiento

1. Desde la barra de navegación, seleccione la región para la instancia. Esta elección es importante porque algunos recursos de Amazon EC2 pueden compartirse entre varias regiones, mientras que otros no. Seleccione la región que mejor se adapte a sus necesidades. Para obtener más información, consulte Ubicaciones de los recursos.

2. Seleccione Lanzar instancia.

3. En Name and tags (Nombre y etiquetas), puede indicar un nombre descriptivo para la instancia y especificar etiquetas.

   El nombre de la instancia es una etiqueta, donde la clave es Name (Nombre) y el valor es el nombre que especifique. Puede etiquetar la instancia, los volúmenes, elastic graphics y las interfaces de red. Para las instancias de spot, solo puede etiquetar la solicitud de instancia de spot.

   Especificar un nombre de instancia y etiquetas adicionales es opcional.

   • En Name (Nombre), ingrese un nombre descriptivo para la instancia. Si no especifica un nombre, la instancia se puede identificar mediante su ID, que se genera automáticamente al lanzar la instancia.

   • Para agregar otras etiquetas, elija Add additional tag (Agregar etiqueta adicional). Elija Add tag (Agregar etiqueta) y, a continuación, ingrese una clave y un valor, y seleccione el tipo de recurso que desea etiquetar. Elija Add tag (Agregar etiqueta) para cada etiqueta adicional.

4. En Application and OS Images (Amazon Machine Image) (Imágenes de aplicaciones y sistema operativo [Imagen de máquina de Amazon]), elija el sistema operativo (SO) para la instancia y, a continuación, una AMI. Para obtener más información, consulte Imágenes de aplicaciones y sistema operativo (Amazon Machine Image).

5. (Opcional) En Key pair (login) (Par de claves [inicio]), para Key pair name (Nombre de par de claves) seleccione un par de claves existente o cree uno nuevo.

6. Mantenga todos los demás campos en sus valores predeterminados o elija valores específicos para la configuración de instancia que desee. Para obtener más información acerca de los campos, consulte iniciar una instancia mediante parámetros definidos.

7. En el panel Summary (Resumen), revise la configuración y, a continuación, elija Launch instance (Lanzar instancia).

Old console

Para agregar una etiqueta mediante el asistente de instancias de lanzamiento

1. Desde la barra de navegación, seleccione la región para la instancia. Esta elección es importante porque algunos recursos de Amazon EC2 pueden compartirse entre varias regiones, mientras que otros no. Seleccione la región que mejor se adapte a sus necesidades. Para obtener más información, consulte Ubicaciones de los recursos.

2. Elija Launch Instance.

3. En la página Choose an Amazon Machine Image (AMI) (Elegir una Amazon Machine Image (AMI)), se muestra una lista de configuraciones básicas denominadas Amazon Machine Images (AMI). Seleccione la AMI que vaya a utilizar y elija Select (Seleccionar). Para obtener más información, consulte Buscar una AMI de Windows.

4. En la página Configure Instance Details (Configurar detalles de instancia), ajuste la configuración de la instancia según sea necesario y, a continuación, elija Next: Add Storage (Siguiente: Agregar almacenamiento).

5. En la página Add Storage (Agregar almacenamiento), puede especificar volúmenes de almacenamiento adicionales para la instancia. Cuando haya terminado, elija Next: Add Tags (Siguiente: Añadir etiquetas).

6. En la página Add Tags (Añadir etiquetas), especifique las etiquetas para la instancia, los volúmenes o ambos. Elija Add another tag (Añadir otra etiqueta) para añadir más de una etiqueta a la instancia. Elija Next: Configure Security Group (Siguiente: Configurar grupo de seguridad) cuando haya terminado.

7. En la página Configure Security Group (Configurar grupo de seguridad), puede elegir uno de los grupos de seguridad existentes que tiene o bien permitir que el asistente cree uno nuevo. Cuando haya terminado, elija Review and Launch (Revisar y lanzar).

8. Revise la configuración. Cuando esté satisfecho con las opciones seleccionadas, elija Launch (Lanzar). Seleccione un par de claves existente o cree uno nuevo, active la casilla de verificación de confirmación y, a continuación, elija Launch Instances (Lanzar instancias).

Filtrar una lista de recursos por etiqueta

Puede filtrar la lista de recursos en función de una o varias claves y valores de etiquetas.

Para filtrar una lista de recursos por etiqueta en la consola de Amazon EC2

1. Abra la consola de Amazon EC2 en https://console.aws.amazon.com/ec2/.

2. En el panel de navegación, seleccione un tipo de recurso (por ejemplo, Instances (Instancia[s])).

3. Elija el campo de búsqueda.

4. En la lista, en Etiquetas, elija la clave de etiqueta.

5. Elija el valor de etiqueta correspondiente de la lista.

6. Cuando haya terminado, quite el filtro.

Para obtener más información sobre el uso de filtros en la consola de Amazon EC2, consulte Enumerar y filtrar los recursos.

Para filtrar varios recursos en varias regiones por etiqueta mediante el Editor de etiquetas

Puede utilizar el Editor de etiquetas de la consola de AWS Resource Groups para filtrar varios recursos de varias regiones por etiqueta. Para obtener más información, consulte Buscar recursos para etiquetar en la Guía del usuario para el etiquetado de recursos de AWS.

Trabajar con etiquetas mediante la línea de comandos

Puede agregar etiquetas a muchos recursos de EC2 al crearlos, mediante el parámetro de especificaciones de etiquetas para el comando create. Puede ver las etiquetas de un recurso mediante el comando describe del recurso. También puede agregar, actualizar o eliminar etiquetas de los recursos existentes mediante los siguientes comandos.

Tarea	AWS CLI	AWS Tools for Windows PowerShell
Agregar o sobrescribir una o varias etiquetas.	create-tags	New-EC2Tag
Eliminar una o varias etiquetas.	delete-tags	Remove-EC2Tag
Describir una o varias etiquetas.	describe-tags	Get-EC2Tag

Tareas

• Agregar etiquetas en la creación de recursos
• Agregar etiquetas a un recurso existente
• Describir recursos etiquetados

Agregar etiquetas en la creación de recursos

El siguiente ejemplo demuestra cómo aplicar etiquetas al crear recursos.

nota

El modo en que introduzca parámetros con formato JSON en la línea de comandos varía en función de su sistema operativo.

• Linux, macOS, o Unix y Windows PowerShell: utilice comillas simples (') para entrecomillar la estructura de datos JSON.

• Windows: omita las comillas simples cuando utilice los comandos en la línea de comandos de Windows.

Para obtener más información, consulte Especificación de valores de parámetros para la AWS CLI.

ejemplo Ejemplo: lanzar una instancia y aplicar etiquetas a la instancia y al volumen

El siguiente comando run-instances lanza una instancia y aplica una etiqueta con la clave webserver y el valor production a la instancia. El comando también aplica una etiqueta con la clave cost-center y el valor cc123 a cualquier volumen de EBS que se cree (en este caso, el volumen raíz).

aws ec2 run-instances \
    --image-id ami-abc12345 \
    --count 1 \
    --instance-type t2.micro \
    --key-name MyKeyPair \
    --subnet-id subnet-6e7f829e \
    --tag-specifications 'ResourceType=instance,Tags=[{Key=webserver,Value=production}]' 'ResourceType=volume,Tags=[{Key=cost-center,Value=cc123}]' 

Puede aplicar las mismas claves y valores de etiqueta tanto a las instancias como a los volúmenes durante el lanzamiento. El siguiente comando lanza una instancia y aplica una etiqueta con una clave de cost-center y un valor de cc123 tanto a la instancia como a cualquier volumen de EBS que se cree.

aws ec2 run-instances \
    --image-id ami-abc12345 \
    --count 1 \
    --instance-type t2.micro \
    --key-name MyKeyPair \
    --subnet-id subnet-6e7f829e \
    --tag-specifications 'ResourceType=instance,Tags=[{Key=cost-center,Value=cc123}]' 'ResourceType=volume,Tags=[{Key=cost-center,Value=cc123}]' 

ejemplo Ejemplo: crear un volumen y aplicar una etiqueta

El siguiente comando create-volume crea un volumen y aplica dos etiquetas: purpose=production y cost-center=cc123.

aws ec2 create-volume \
    --availability-zone us-east-1a \
    --volume-type gp2 \
    --size 80 \
    --tag-specifications 'ResourceType=volume,Tags=[{Key=purpose,Value=production},{Key=cost-center,Value=cc123}]'

Agregar etiquetas a un recurso existente

En los ejemplos siguientes se muestra cómo agregar etiquetas a un recurso existente mediante el comando create-tags.

ejemplo Ejemplo: agregar una etiqueta a un recurso

El comando siguiente agrega la etiqueta Stack=production a la imagen especificada o sobrescribe una etiqueta existente para la AMI en la que la clave de etiqueta es Stack. Si el comando se ejecuta correctamente, no se muestra ningún resultado.

aws ec2 create-tags \
    --resources ami-78a54011 \
    --tags Key=Stack,Value=production

ejemplo Ejemplo: agregar etiquetas a varios recursos

Este ejemplo añade (o sobrescribe) dos etiquetas para una AMI y una instancia. Una de las etiquetas contiene solo una clave (webserver), sin valor (establecemos el valor en una cadena vacía). La otra etiqueta consta de una clave (stack) y un valor (Production). Si el comando se ejecuta correctamente, no se muestra ningún resultado.

aws ec2 create-tags \
    --resources ami-1a2b3c4d i-1234567890abcdef0 \
    --tags Key=webserver,Value=  Key=stack,Value=Production

ejemplo Ejemplo: agregar etiquetas con caracteres especiales

Este ejemplo agrega la etiqueta [Group]=test a una instancia. Los corchetes ([ y ]) son caracteres especiales, que deben ser incluirse en el carácter de escape.

Si utiliza Linux u OS X, para incluir en el carácter de escape los caracteres especiales, encierre el elemento con carácter especial entre comillas dobles (") y después incluya la estructura completa de clave y valor entre comillas simples (').

aws ec2 create-tags \
    --resources i-1234567890abcdef0 \
    --tags 'Key="[Group]",Value=test'

Si está utilizando Windows, para incluir en el carácter de escape los caracteres especiales, encierre el elemento que tiene caracteres especiales con comillas dobles (") y, a continuación, preceda cada carácter de comillas dobles con una barra invertida (\) de la siguiente manera:

aws ec2 create-tags ^
    --resources i-1234567890abcdef0 ^
    --tags Key=\"[Group]\",Value=test

Si está utilizando Windows PowerShell, para incluir en el carácter de escape los caracteres especiales, encierre el valor que tiene caracteres especiales con comillas dobles ("), preceda cada carácter de comillas dobles de una barra invertida (\) y, a continuación, encierre toda la estructura de clave y valor con comillas simples (') de la siguiente manera:

aws ec2 create-tags `
    --resources i-1234567890abcdef0 `
    --tags 'Key=\"[Group]\",Value=test'

Describir recursos etiquetados

En los ejemplos siguientes se muestra cómo utilizar filtros con describe-instances para ver instancias con etiquetas específicas. Todos los comandos describe de EC2 utilizan esta sintaxis para filtrar por etiqueta en un único tipo de recurso. También puede utilizar el comando describe-tags para filtrar por etiqueta entre los tipos de recursos EC2.

ejemplo Ejemplo: describir instancias con la clave de etiqueta especificada

En el siguiente comando se describen las instancias con una etiqueta Stack, con independencia del valor de la etiqueta.

aws ec2 describe-instances \
    --filters Name=tag-key,Values=Stack

ejemplo Ejemplo: describir instancias con la etiqueta especificada

En el siguiente comando se describen las instancias con la etiqueta Stack=production.

aws ec2 describe-instances \
    --filters Name=tag:Stack,Values=production

ejemplo Ejemplo: describir instancias con el valor de etiqueta especificado

En el siguiente comando se describen las instancias con una etiqueta con el valor production, con independencia de la clave de etiqueta.

aws ec2 describe-instances \
    --filters Name=tag-value,Values=production

ejemplo Ejemplo: describa todos los recursos EC2 con la etiqueta especificada

El siguiente comando describe todos los recursos EC2 con la etiqueta Stack=Test.

aws ec2 describe-tags \
    --filters Name=key,Values=Stack Name=value,Values=Test

Trabajar con etiquetas de instancia en los metadatos de instancia

Puede acceder a las etiquetas de una instancia desde los metadatos de la instancia. Al acceder a las etiquetas desde los metadatos de la instancia, ya no tendrá que utilizar las llamadas a la API DescribeInstances o DescribeTags para recuperar información de etiquetas, lo que reduce las transacciones de la API por segundo y permite que las recuperaciones de etiquetas se escalen según el número de instancias que controla. Además, los procesos locales que se ejecutan en una instancia pueden ver la información de etiqueta de la instancia directamente desde los metadatos de la instancia.

De forma predeterminada, las etiquetas no están disponibles en los metadatos de la instancia; debe permitir explícitamente el acceso. Puede permitir el acceso durante el lanzamiento de la instancia o después del lanzamiento en una instancia en ejecución o detenida. También puede permitir el acceso a las etiquetas especificándolo en una plantilla de lanzamiento. Las instancias que se lanzan mediante la plantilla permiten el acceso a las etiquetas de los metadatos de la instancia.

Si agrega o elimina una etiqueta de instancia, los metadatos de la instancia se actualizan mientras se ejecuta la instancia, sin necesidad de detener e iniciar la instancia.

Temas

• Permitir acceso a etiquetas en metadatos de instancia
• Desactivar el acceso a las etiquetas en metadatos de instancia
• Ver si se permite el acceso a las etiquetas en los metadatos de instancia
• Recuperar etiquetas desde los metadatos de instancia

Permitir acceso a etiquetas en metadatos de instancia

De forma predeterminada, no hay acceso a las etiquetas de instancia en los metadatos de la instancia. Para cada instancia, debe permitir el acceso explícitamente mediante uno de los métodos siguientes.

Para permitir acceso a etiquetas en metadatos de instancia mediante la consola

1. Abra la consola de Amazon EC2 en https://console.aws.amazon.com/ec2/.

2. En el panel de navegación, seleccione Instances (Instancia[s]).

3. Seleccione una instancia y, a continuación, elija Actions (Acciones), Instance settings (Configuración de la instancia), Allow tags in instance metadata (Permitir etiquetas en metadatos de instancia).

4. Para permitir el acceso a las etiquetas de los metadatos de instancia, seleccione la casilla Allow (Permitir).

5. Elija Guardar.

Para permitir acceso a etiquetas en metadatos de instancia durante el lanzamiento mediante la AWS CLI

Utilice el comando run-instances y establezca InstanceMetadataTags en enabled.

aws ec2 run-instances \
    --image-id ami-0abcdef1234567890 \
    --instance-type c3.large \
    ...
    --metadata-options "InstanceMetadataTags=enabled"

Para permitir el acceso a etiquetas de metadatos de instancia en una instancia en ejecución o detenida mediante la AWS CLI

Utilice el comando modify-instance-metadata-options y establezca --instance-metadata-tags en enabled.

aws ec2 modify-instance-metadata-options \
    --instance-id i-123456789example \
    --instance-metadata-tags enabled

Desactivar el acceso a las etiquetas en metadatos de instancia

Para desactivar el acceso a las etiquetas de instancia en los metadatos de instancia, utilice uno de los métodos siguientes. No es necesario desactivar el acceso a las etiquetas de instancia en los metadatos de instancia durante el lanzamiento porque está desactivado de forma predeterminada.

Para desactivar el acceso a etiquetas en metadatos de instancia mediante la consola

1. Abra la consola de Amazon EC2 en https://console.aws.amazon.com/ec2/.

2. En el panel de navegación, seleccione Instances (Instancia[s]).

3. Seleccione una instancia y, a continuación, elija Actions (Acciones), Instance settings (Configuración de la instancia), Allow tags in instance metadata (Permitir etiquetas en metadatos de instancia).

4. Para desactivar el acceso a las etiquetas de los metadatos de instancia, desactive la casilla Allow (Permitir).

5. Elija Guardar.

Para desactivar el acceso a etiquetas en metadatos de instancia mediante la AWS CLI

Utilice el comando modify-instance-metadata-options y establezca --instance-metadata-tags en disabled.

aws ec2 modify-instance-metadata-options \
    --instance-id i-123456789example \
    --instance-metadata-tags disabled

Ver si se permite el acceso a las etiquetas en los metadatos de instancia

En cada instancia, puede utilizar la consola de Amazon EC2 o la AWS CLI para ver si se permite el acceso a las etiquetas de instancia de los metadatos de instancia.

Para ver si está permitido el acceso a etiquetas en metadatos de instancia mediante la consola

1. Abra la consola de Amazon EC2 en https://console.aws.amazon.com/ec2/.

2. En el panel de navegación, elija Instances (Instancia[s]) y, a continuación, seleccione una instancia.

3. En la pestaña Details (Detalles), marque el campo Allow tags in instance metadata (Permitir etiquetas en los metadatos de la instancia). Si el valor es Enabled (Habilitadas), se permiten etiquetas en los metadatos de instancia. Si el valor es Disabled (Deshabilitadas), no se permitirán las etiquetas en los metadatos de instancia.

Para ver si se permite el acceso a las etiquetas en los metadatos de instancia mediante la AWS CLI

Use el comando describe-instances y especifique el ID de la instancia.

aws ec2 describe-instances \
    --instance-ids i-1234567890abcdef0

La siguiente salida de ejemplo está truncada por falta de espacio. El parámetro "InstanceMetadataTags" indica si se permiten las etiquetas en los metadatos de la instancia. Si el valor es enabled, se permiten etiquetas en los metadatos de instancia. Si el valor es disabled, no se permitirá el uso de etiquetas en los metadatos de instancia.

{
    "Reservations": [
        {
            "Groups": [],
            "Instances": [
                {
                    "AmiLaunchIndex": 0,
                    "ImageId": "ami-0abcdef1234567890",
                    "InstanceId": "i-1234567890abcdef0",
			...
			
			"MetadataOptions": {
			"State": "applied",
			"HttpTokens": "optional",
			"HttpPutResponseHopLimit": 1,
			"HttpEndpoint": "enabled",
			"HttpProtocolIpv6": "disabled",
			"InstanceMetadataTags": "enabled"
			},
			...

Recuperar etiquetas desde los metadatos de instancia

Si se permiten etiquetas de instancia en los metadatos de la instancia, se puede acceder a la categoría tags/instance desde los metadatos de la instancia. Para obtener ejemplos sobre cómo recuperar etiquetas de los metadatos de la instancia, consulte Obtener las etiquetas de instancia de una instancia.

Agregar etiquetas a un recurso mediante CloudFormation

Con los tipos de recursos de Amazon EC2, especifica etiquetas mediante una propiedad Tags o TagSpecifications.

En los siguientes ejemplos se agrega la etiqueta Stack=Production a AWS::EC2::Instance mediante su propiedad Tags.

ejemplo Ejemplo: Tags en YAML

Tags:
  - Key: "Stack"
    Value: "Production"

ejemplo Ejemplo: Tags en JSON

"Tags": [
    {
        "Key": "Stack",
        "Value": "Production"
    }
]

En los ejemplos siguientes se agrega la etiqueta Stack=Production a AWS::EC2::LaunchTemplate LaunchTemplateData mediante su propiedad TagSpecifications.

ejemplo Ejemplo: TagSpecifications en YAML

TagSpecifications:
  - ResourceType: "instance"
    Tags:
    - Key: "Stack"
      Value: "Production"

ejemplo Ejemplo: TagSpecifications en JSON

"TagSpecifications": [
    {
        "ResourceType": "instance",
        "Tags": [
            {
                "Key": "Stack",
                "Value": "Production"
            }
        ]
    }
]