Etiquetar los recursos de Amazon EC2 - Amazon Elastic Compute Cloud

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.


					Ejemplo de etiquetas

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 más fácilmente. Puede buscar y filtrar los recursos en función de las etiquetas que agregue. Para obtener más información acerca de cómo implementar una estrategia eficaz de etiquetado de recursos, consulte el documento técnico de AWSPrá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 de

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 Tags (Etiquetas) de la pantalla correspondiente al recurso, o bien puede utilizar la pantalla Tags (Etiquetas). 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

AMI

Tarea en paquete

No

No

Capacity Reservation

Gateway de operador

Punto de enlace de Client VPN

Ruta de Client VPN

No

No

Gateway de cliente

Dedicated Host

Reserva host dedicado

Opción de DHCP

Instantánea de EBS

Volumen de EBS

EC2 Fleet

Gateway de Internet de solo salida

Dirección IP elástica

Acelerador de Elastic Graphics

No

Instancia

Volumen de almacén de instancias

N/A

N/A

Gateway de Internet

Grupo de direcciones IP (BYOIP)

Par de claves

Plantilla de lanzamiento

Lanzar la versión de plantilla

No

No

Gateway local

No

Tabla de enrutamiento de gateway local

No

Interfaz virtual de gateway local

No

Grupo de interfaz virtual de gateway local

No

Asociación de VPC de tabla de enrutamiento de gateway local

Asociación de grupo de interfaz virtual de tabla de enrutamiento de gateway local

No

gateway NAT

ACL de red

Interfaz de red

Grupo de ubicación

Listas de prefijos

Reserved Instance

No

Listado de Instancia reservada

No

No
Tabla de ruteo

Solicitud de flota de spot

Solicitud de instancia de spot

Grupo de seguridad

Regla del grupo de seguridad No

Subred

Filtro de reflejo de tráfico
Sesión de reflejo de tráfico
Destino de reflejo de tráfico

Gateway de tránsito

Tabla de ruteo de la gateway de tránsito

Vinculación VPC de la gateway de tránsito

Gateway privada virtual

VPC

Punto de conexión VPC

Servicio de punto de enlace de la VPC

Configuración de servicio de punto de conexión de VPC

Registro de flujo de VPC

Interconexión de VPC

conexión de VPN

Puede etiquetar las instancias y los volúmenes al crearlos mediante el asistente para lanzar instancias de Amazon EC2 en la consola de Amazon EC2. Puede etiquetar los volúmenes de EBS durante la creación en la pantalla Volumes (Volúmenes) o las instantáneas de EBS en la pantalla Snapshots (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 and Cost Management.

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

  • Si bien EC2 admite el uso de cualquier carácter en sus etiquetas, es posible que otros servicios son más restrictivos. Los caracteres permitidos en los servicios son: letras, números y espacios representables en UTF-8, además de los siguientes caracteres: + - = . _ : / @.

  • 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 and Cost Management. 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 and Cost Management.

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 and Cost Management.

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

Con la consola de Amazon EC2 puede ver qué etiquetas están en uso en todos los recursos de Amazon EC2 de una misma región. Puede ver etiquetas por recurso y por tipo de recurso, y también puede ver cuántos elementos de cada tipo de recurso están asociados a una etiqueta especificada. También puede utilizar la consola de Amazon EC2 para aplicar o eliminar etiquetas en uno o varios recursos a la vez.

Para obtener más información sobre el uso de filtros al visualizar los recursos, consulte Enumerar y filtrar los recursos.

Para facilitar el uso y obtener los mejores resultados, use Tag Editor en la AWS Management Console, que proporciona un método unificado y centralizado para crear y administrar las etiquetas. Para obtener más información, consulte Editor de etiquetas en la Introducción a AWS Management Console.

Mostrar etiquetas

Puede mostrar las etiquetas de dos formas distintas en la consola de Amazon EC2. Puede mostrar las etiquetas para un recurso individual o para todos los recursos.

Mostrar etiquetas para recursos individuales

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 (Instancias) 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 añadir una columna a la lista de recursos que muestra todos los valores para las etiquetas con la misma clave. Esta columna permite ordenar y filtrar la lista de recursos por la etiqueta.

New console
  • Elija el icono Preferences (Preferencias) (el engranaje) de la esquina superior derecha. En el cuadro de diálogo de Preferences (Preferencias), enTag columns (Columnas de etiqueta), seleccione una de las claves de etiqueta más y, a continuación, elija Confirm (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 todos los recursos

Puede mostrar las etiquetas en todos los recursos seleccionando Tags (Etiquetas) en el panel de navegación de la consola de Amazon EC2. En la siguiente imagen, se muestra el panel Tags (Etiquetas), que enumera todas las etiquetas en uso por tipo de recurso.


						El panel Tags (Etiquetas) de la consola de Amazon EC2

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 adecuada a sus necesidades. Esta elección es importante porque algunos recursos de Amazon EC2 pueden compartirse entre varias regiones, mientras que otros no. 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 (Instancias)).

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

  5. Elija Manage tags (Administrar etiquetas), Add tag (Agregar etiqueta). Escriba la clave y el valor de para la etiqueta. 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 adecuada a sus necesidades. Esta elección es importante porque algunos recursos de Amazon EC2 pueden compartirse entre varias regiones, mientras que otros no. 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 (Instancias)).

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

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

Agregar y eliminar etiquetas a un grupo de recursos

Para añadir una etiqueta a un grupo de recursos

  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 adecuada a sus necesidades. Esta elección es importante porque algunos recursos de Amazon EC2 pueden compartirse entre varias regiones, mientras que otros no. Para obtener más información, consulte Ubicaciones de los recursos.

  3. En el panel de navegación, seleccione Tags.

  4. En la parte superior del panel de contenido, elija Manage Tags (Administrar etiquetas).

  5. En Filter (Filtro), seleccione el tipo de recurso (por ejemplo, instancias).

  6. En la lista de recursos, seleccione la casilla de verificación situada junto a cada recurso.

  7. En Add Tag (Agregar etiqueta), escriba la clave y el valor de etiqueta y elija Add Tag (Agregar etiqueta).

    nota

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

Para eliminar una etiqueta de un grupo de recursos

  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 adecuada a sus necesidades. Esta elección es importante porque algunos recursos de Amazon EC2 pueden compartirse entre varias regiones, mientras que otros no. Para obtener más información, consulte Ubicaciones de los recursos.

  3. En el panel de navegación, elija Tags (Etiquetas), Manage Tags (Administrar etiquetas).

  4. Para ver las etiquetas en uso, seleccione 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 las claves de etiqueta que desee ver y elija Close (Cerrar).

  5. En Filter (Filtro), seleccione el tipo de recurso (por ejemplo, instancias).

  6. En la lista de recursos, seleccione la casilla de verificación situada junto a cada recurso.

  7. En Remove Tag (Quitar etiqueta), escriba la clave de etiqueta y elija Remove Tag (Quitar etiqueta).

Agregar una etiqueta cuando lanza una instancia

Para añadir una etiqueta mediante el Launch Wizard

  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 y 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

  1. En el panel de navegación, seleccione un tipo de recurso (por ejemplo, Instances (Instancias)).

  2. Elija el campo de búsqueda.

  3. Elija la clave de etiqueta de la lista.

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

  5. Cuando haya terminado, quite el filtro.

Para obtener más información acerca de los filtros, consulte Enumerar y filtrar los recursos.

Trabajar con etiquetas mediante la línea de comandos

Puede agregar etiquetas a muchos recursos EC2 al crearlos, utilizando 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

Agregar etiquetas en la creación de recursos

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

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 utilizan comillas simples (') para entrecomillar la estructura de datos JSON. Omita las comillas simples al utilizar los comandos con 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

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" } ] } ]