Etiquetado de los recursos de Amazon AppStream 2.0

AWS le permite asignar metadatos a los recursos de AWS en forma de etiquetas. Puede utilizar estas etiquetas para ayudar a administrar los generadores de imágenes, las imágenes, las flotas y las pilas de AppStream 2.0 y también para organizar los datos, incluidos los datos de facturación.

Puede hacer lo siguiente:

• Agrupar de forma lógica los recursos de distintas maneras (por ejemplo, por finalidad, propietario o entorno).

  Esto es útil cuando se tienen muchos recursos del mismo tipo.

• Identificar rápidamente un recurso determinado según las etiquetas que se le hayan asignado.

• Identificar y controlar los costos de AWS

Por ejemplo, puede identificar y agrupar las flotas de AppStream 2.0 que están en diferentes entornos (como Desarrollo o Producción) o que están asignadas a distintas unidades de negocio (como Recursos Humanos o Marketing). A continuación, puede realizar un seguimiento detallado de los costos de AWS asociados a estas flotas. Para ello, inscríbase para obtener una factura de la cuenta de Amazon Web Services 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.

Aspectos básicos del etiquetado

Las etiquetas se componen de un par clave-valor, similar al de las etiquetas de los otros servicios de AWS. Para etiquetar un recurso, especifique una clave y un valor para cada etiqueta. Una clave puede ser una categoría general, como, por ejemplo, "proyecto", "propietario" o "entorno", con valores asociados específicos, y se puede compartir la misma clave y el mismo valor en varios recursos. Puede etiquetar un recurso de AppStream 2.0 inmediatamente después de crearlo o más adelante. Si elimina un recurso, las etiquetas se eliminan de dicho recurso al eliminarlo. Sin embargo, los demás recursos de AppStream 2.0 y de AWS que tengan la misma clave de etiqueta no se verán afectados.

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 en una cadena vacía, pero no puede establecer el nombre de una etiqueta en un null. 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

Si tiene previsto configurar un informe mensual de asignación de costos para realizar un seguimiento de los costos de AWS para los recursos de AppStream 2.0, tenga en cuenta que las etiquetas añadidas a los recursos de AppStream 2.0 existentes aparecerán en el informe de asignación de costos a principios del mes siguiente para los recursos renovados en ese mes.

Restricciones de las etiquetas

• El número máximo de etiquetas por recurso de AppStream 2.0 es 50.

• La longitud máxima de la clave es de 128 caracteres Unicode en UTF-8.

• La longitud máxima del valor es de 256 caracteres Unicode en UTF-8.

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

• No utilice el prefijo "aws:" en los nombres ni en los valores de las etiquetas, porque es una etiqueta del sistema que está reservada para que la utilice AWS. Los nombres y valores de las etiquetas que tienen este prefijo no se pueden editar. Las etiquetas que tengan este prefijo no cuentan para el límite de etiquetas por recurso.

• En líneas generales, los caracteres permitidos son: letras, números y representables en UTF-8, además de los siguientes caracteres especiales: + - = . _ : / @.

• Aunque puede compartir la misma clave y valor en distintos recursos, no puede haber claves duplicadas en el mismo recurso.

• Puedes agregar etiquetas para los recursos al crearlos. También puedes añadir, editar y eliminar etiquetas para los recursos que ya están creados.

Adición de etiquetas al crear recursos en la consola de AppStream 2.0

Al crear un recurso en la consola de AppStream 2.0, puedes añadir una o varias etiquetas para administrarlo. Para obtener más información, consulte los siguientes temas:

• Generadores de imágenes: Lanzar un generador de imágenes para instalar y configurar aplicaciones de streaming, paso 4

• Imágenes: Paso 6: Finalizar la creación de la imagen, paso 1

• Flotas: Creación de una flota, paso 3

• Pilas: Crear una pila, paso 2

Adición, edición y eliminación de etiquetas de recursos existentes en la consola de AppStream 2.0.

Puede añadir, editar y eliminar etiquetas para los recursos existentes con la consola de AppStream 2.0.

Para añadir, editar o eliminar etiquetas para un recurso de AppStream 2.0

1. Abra la consola de AppStream 2.0 en https://console.aws.amazon.com/appstream2.

2. En la barra de navegación, seleccione la región que contiene el recurso para el que desea añadir, editar o eliminar etiquetas.

3. En el panel de navegación, seleccione el tipo de recurso. El tipo de recurso puede ser un generador de imágenes, una imagen, una flota o una pila.

4. Seleccione el recurso de la lista de recursos.

5. Elija Etiquetas, Agregar o editar etiquetas y, a continuación, realice una o varias de las siguientes acciones:

   • Para agregar una etiqueta, elija Agregar etiqueta y, a continuación, escriba la clave y el valor de cada etiqueta.

   • Para editar una etiqueta, modifique la clave y el valor de la etiqueta según sea necesario.

   • Para eliminar una etiqueta, elija el icono Eliminar (X) situado junto a la etiqueta.

6. Seleccione Guardar.

Uso de etiquetas mediante la API de AppStream 2.0, un SDK de AWS o la AWS CLI

Si utiliza la API de AppStream 2.0, un SDK de AWS o la interfaz de línea de comandos de AWS (AWS CLI), puede usar las siguientes operaciones de AppStream 2.0 con el parámetro tags para añadir etiquetas al crear nuevos recursos.

nota

Puede utilizar espacios en las claves y los valores de las etiquetas. Para indicar un espacio cuando se utiliza la AWS CL, utilice "\s" (sin las comillas).

Tarea	AWS CLI	Operación de API
Agregar una o varias etiquetas a una nueva flota	create-fleet	CreateFleet
Agregar una o varias etiquetas a un nuevo generador de imágenes	create-imagebuilder	CreateImageBuilder
Agregar una o varias etiquetas a una nueva pila	create-stack	CreateStack

Puede utilizar las siguientes operaciones de AppStream 2.0 para añadir, editar, eliminar o enumerar las etiquetas de los recursos existentes:

Tarea	AWS CLI	Operación de API
Añadir o sobrescribir una o varias etiquetas de un recurso	tag-resource	TagResource
Eliminar una o varias etiquetas de un recurso	untag-resource	UntagResource
Crear una lista de una o varias etiquetas de un recurso	list-tags-for-resource	ListTagsForResource

Si utiliza la API de AppStream 2.0, un SDK de AWS o acciones de la AWS CLI para añadir, editar, eliminar o enumerar etiquetas de un recurso de AppStream 2.0 existente, especifique el recurso mediante su nombre de recurso de Amazon (ARN). Un ARN identifica de forma exclusiva un recurso de AWS y utiliza la siguiente sintaxis general.

arn:aws:appstream:region:account:resourceType/resourceName

region

La región de AWS en la que se creó el recurso (por ejemplo, us-east-1).

account

El ID de Cuenta de AWS, sin guiones (por ejemplo, 123456789012).

resourceType

El tipo de recurso. Puede etiquetar los siguientes tipos de recursos de AppStream 2.0: image-builder, image, fleet, y stack.

resourceName

El nombre del recurso.

Por ejemplo, puede obtener el ARN de una flota de AppStream 2.0 mediante el comando describe-fleets de la AWS CLI. Copie el comando siguiente.

aws appstream describe-fleets

Para un entorno que contiene una única flota denominada TestFleet, el ARN de este recurso aparecería en la salida JSON con un aspecto similar al siguiente.

"Arn": "arn:aws:appstream:us-east-1:123456789012:fleet/TestFleet"

Después de obtener el ARN de este recurso, puede añadir dos etiquetas mediante el comando tag-resource:

aws appstream tag-resource --resource arn:awsappstream:us-east-1:123456789012:fleet/TestFleet --tags Environment=Test,Department=IT

La primera etiqueta, Environment=Test, indica que la flota pertenece a un entorno de pruebas. La segunda etiqueta, Department=IT, indica que la flota pertenece al departamento de TI.

Puede utilizar el siguiente comando para crear una lista de las dos etiquetas que ha añadido a la flota.

aws appstream list-tags-for-resource --resource arn:aws:appstream:us-east-1:123456789012:fleet/TestFleet

Para este ejemplo, la salida JSON aparece como se muestra a continuación:

{
    "Tags": {
       "Environment" : "Test",
       "Department" : "IT"
    }
}