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

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Uso de etiquetas mediante la API de Amazon 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 la 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 siguiente comando.

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