Trabalhar com tags usando a API do Amazon AppStream 2.0, um SDK da AWS ou a CLI da AWS - Amazon AppStream 2.0

Trabalhar com tags usando a API do Amazon AppStream 2.0, um SDK da AWS ou a CLI da AWS

Se você estiver usando a API do AppStream 2.0, um AWS SDK ou a AWS Command Line Interface (AWS CLI), poderá usar as seguintes operações do AppStream 2.0 com o parâmetro tags para adicionar etiquetas ao criar recursos.

nota

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

Tarefa AWS CLI Operação de API
Adicionar uma ou mais tags de uma nova frota create-fleet

CreateFleet
Adicionar uma ou mais tags de um novo criador de imagens create-imagebuilder

CreateImageBuilder
Adicionar uma ou mais tags de uma nova pilha

create-stack

CreateStack

Você pode usar as seguintes operações do AppStream 2.0 para adicionar, editar, remover ou listar as etiquetas de recursos existentes:

Tarefa AWS CLI Operação de API
Adicionar ou substituir uma ou mais tags de um recurso tag-resource

TagResource
Remover uma ou mais tags de um recurso untag-resource

UntagResource
Listar uma ou mais tags de um recurso

list-tags-for-resource

ListTagsForResource

Ao usar a API do AppStream 2.0, um AWS SDK ou ações da AWS CLI para adicionar, editar, remover ou listar etiquetas de um recurso do AppStream 2.0 existente, especifique o recurso usando o nome do recurso da Amazon (ARN). Um ARN identifica de forma exclusiva um recurso da AWS e usa a sintaxe geral a seguir.

arn:aws:appstream:region:account:resourceType/resourceName
região

A região da AWS em que o recurso foi criado (por exemplo, us-east-1).

Conta da

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

resourceType

O tipo de recurso. Você pode marcar os seguintes tipos de recursos do AppStream 2.0: image-builder, image, fleet e stack.

resourceName

O nome do recurso.

Por exemplo, você pode obter o ARN de uma frota do AppStream 2.0 usando o comando describe-fleets da AWS CLI. 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: 

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