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.

# Trabajar con etiquetas mediante la API, un AWS SDK o la AWS CLI de Amazon WorkSpaces Applications
<a name="basic-tagging-API-SDK-CLI"></a>

Si utiliza la API de WorkSpaces aplicaciones, un AWS SDK o la interfaz de línea de AWS comandos (AWS CLI), puede utilizar las siguientes operaciones de WorkSpaces aplicaciones con el `tags` parámetro 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 utilice la AWS CLI, utilice «\$1 s» (sin las comillas).


| Tarea | AWS CLI | Operación de API | 
| --- | --- | --- | 
| Agregar una o varias etiquetas a una nueva flota | [create-fleet](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-fleet.html)  |  [CreateFleet](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateFleet.html#AppStream2-CreateFleet-request-Tags)  | 
| Agregar una o varias etiquetas a un nuevo generador de imágenes | [create-imagebuilder](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-imagebuilder.html) |  [CreateImageBuilder](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateImageBuilder.html#AppStream2-CreateImageBuilder-request-Tags)  | 
| Agregar una o varias etiquetas a una nueva pila |  [create-stack](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-stack.html)  |  [CreateStack](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateStack.html#AppStream2-CreateStack-request-Tags)  | 

Puede utilizar las siguientes operaciones de WorkSpaces aplicaciones para agregar, 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](https://docs.aws.amazon.com/cli/latest/reference/appstream/tag-resource.html)  |  [TagResource](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_TagResource.html)  | 
| Eliminar una o varias etiquetas de un recurso | [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/appstream/untag-resource.html) |  [UntagResource](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_UntagResource.html)  | 
| Crear una lista de una o varias etiquetas de un recurso |  [list-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/appstream/list-tags-for-resource.html)  |  [ListTagsForResource](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_ListTagsForResource.html)  | 

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

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

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

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

***resourceType***  
El tipo de recurso. Puede etiquetar los siguientes tipos de recursos de WorkSpaces aplicaciones:`image-builder`, `image``fleet`, y. `stack`

***resourceName***  
El nombre del recurso.

Por ejemplo, puede obtener el ARN de una flota de WorkSpaces aplicaciones mediante el comando [describe-fleets](https://docs.aws.amazon.com/cli/latest/reference/appstream/describe-fleets.html) 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](https://docs.aws.amazon.com/cli/latest/reference/appstream/tag-resource.html): 

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