As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Trabalhando com tags usando a API de WorkSpaces aplicativos da Amazon, um AWS SDK ou CLI AWS
<a name="basic-tagging-API-SDK-CLI"></a>

Se você estiver usando a API de WorkSpaces aplicativos, um AWS SDK ou a interface de linha de AWS comando (AWS CLI), poderá usar as WorkSpaces seguintes operações de aplicativos com `tags` o parâmetro para adicionar tags ao criar novos recursos. 

**nota**  
Você pode usar espaços em valores e chaves de tag. Para indicar um espaço ao usar a AWS CLI, use “\$1 s” (sem as aspas).


| Tarefa | AWS CLI | Operação de API | 
| --- | --- | --- | 
| Adicionar uma ou mais tags de uma nova frota | [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)  | 
| Adicionar uma ou mais tags de um novo criador de imagens | [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)  | 
| Adicionar uma ou mais tags de uma nova pilha |  [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)  | 

Você pode usar as seguintes operações de WorkSpaces aplicativos para adicionar, editar, remover ou listar tags de recursos existentes: 


| Tarefa | AWS CLI | Operação de API | 
| --- | --- | --- | 
| Adicionar ou substituir uma ou mais tags de um 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)  | 
| Remover uma ou mais tags de um 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)  | 
| Listar uma ou mais tags de um 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)  | 

Ao usar a API de WorkSpaces aplicativos, um AWS SDK ou ações da AWS CLI para adicionar, editar, remover ou listar tags de um recurso de aplicativos WorkSpaces existente, especifique o recurso usando seu Amazon Resource Name (ARN). Um ARN identifica exclusivamente um AWS recurso e usa a seguinte sintaxe geral.

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

***region***  
A AWS região na qual o recurso foi criado (por exemplo,`us-east-1`).

***account***  
O Conta da AWS ID, sem hífens (por exemplo,`123456789012`).

***resourceType***  
O tipo de recurso. Você pode marcar os seguintes tipos de recursos de WorkSpaces aplicativos: `image-builder` `image``fleet`,, `stack` e.

***resourceName***  
O nome do recurso.

[Por exemplo, você pode obter o ARN para uma frota de WorkSpaces aplicativos usando o comando describe-fleets da AWS CLI.](https://docs.aws.amazon.com/cli/latest/reference/appstream/describe-fleets.html) Copie o seguinte comando :

```
aws appstream describe-fleets
```

Em um ambiente que contém uma única frota chamada `TestFleet`, o ARN deste recurso seria exibido em uma saída JSON semelhante à seguinte. 

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

Depois de obter o ARN deste recurso, você pode adicionar duas tags usando o 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
```

A primeira tag, `Environment=Test`, indica que a frota está em um ambiente de teste. A segunda tag, `Department=IT`, indica que a frota está no departamento de TI. 

Você pode usar o comando a seguir para listar as duas tags que você adicionou à frota.

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

Neste exemplo, a saída JSON é exibida da seguinte maneira: 

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