Tag: Espaços de trabalho Amazon Managed Grafana

Use os procedimentos nesta seção para trabalhar com tags para espaços de trabalho Amazon Managed Grafana.

Adicionar uma tag a um workspace

Adicionar tags (pares de valores-chave) a um espaço de trabalho do Amazon Managed Grafana pode ajudar você a identificar e organizar seus recursos. AWS Primeiro, você adiciona uma ou mais tags a um espaço de trabalho e, em seguida, pode criar políticas do IAM para gerenciar o acesso ao espaço de trabalho com base nessas tags. Você pode usar o console ou a AWS CLI para adicionar tags a um espaço de trabalho Amazon Managed Grafana.

Importante

Adicionar tags a um workspace pode afetar o acesso a esse workspace. Antes de adicionar uma tag a um grupo de relatórios, revise as políticas do IAM que possam usar tags para controlar o acesso a recursos, como grupo de relatórios.

Para obter mais informações sobre como adicionar tags a um espaço de trabalho do Amazon Managed Grafana ao criá-lo, consulte o Guia do usuário do Crie um espaço de trabalho Amazon Managed Grafana Amazon Managed Grafana.

Console

Você pode usar o console para adicionar uma ou mais tags a um espaço de trabalho Amazon Managed Grafana.

1. Abra o console Amazon Managed Grafana em https://console.aws.amazon.com/grafana/.

2. No painel de navegação à esquerda, escolha o ícone do menu.

3. Escolha Todos os espaços de trabalho.

4. Escolha o ID do workspace do workspace que você quiser gerenciar.

5. Escolha a guia Tags.

6. Selecione Gerenciar tags.

7. No campo Chave, insira um nome para a tag. Você pode adicionar um valor opcional para a tag no campo Valor.

8. (Opcional) Para adicionar outra tag, escolha Adicionar tag.

9. Quando terminar de adicionar tags, escolha Salvar alterações.

CLI

Siga estas etapas para usar a AWS CLI para adicionar uma ou mais tags a um espaço de trabalho Amazon Managed Grafana:

• No terminal ou na linha de comando, execute o tag-resource comando, especificando o Amazon Resource Name (ARN) do espaço de trabalho ao qual você deseja adicionar tags, bem como a chave e o valor da tag que você deseja adicionar. Você pode adicionar mais de uma tag a um espaço de trabalho. Por exemplo, para marcar o My-Workspace da Grafana com uma chave de tag chamada Name com o valor de tag my_key_value, execute o seguinte comando:

  aws grafana tag-resource --resource-arn arn:aws:grafana:us-west-2:123456789012:/workspace/My-Workspace --tags "Name=my_key_value"

Visualização de tags de um workspace

Você pode visualizar as tags associadas a um espaço de trabalho Amazon Managed Grafana. Para obter mais informações sobre estratégias de marcação, consulte AWS Recursos de marcação na Referência AWS geral.

Console

Você pode usar o console para visualizar as tags associadas a um espaço de trabalho Amazon Managed Grafana.

1. Abra o console Amazon Managed Grafana em https://console.aws.amazon.com/grafana/.

2. No painel de navegação à esquerda, escolha o ícone do menu.

3. Escolha Todos os workspaces.

4. Escolha o ID do workspace do workspace que você quiser gerenciar.

5. Escolha a guia Tags.

CLI

Siga estas etapas para usar a AWS CLI para visualizar as AWS tags de um Amazon Managed Grafana espaço de trabalho. Se não foram adicionadas tags, a lista retornará vazia.

No terminal ou na linha de comando, execute o list-tags-for-resourcecomando. Por exemplo, para ver uma lista de chaves e valores de tag para um espaço de trabalho, execute o seguinte comando:

aws grafana list-tags-for-resource --resoure-arn arn:aws:grafana:us-west-2:/workspace/workspace-IDstring

Se houver êxito, o comando retornará informações semelhantes às seguintes:

{
    "tags": {
        "Status": "Secret",
        "Team": "My-Team"
    }
}

Editar tags para um workspace

Você pode alterar o valor de uma tag associada a um espaço de trabalho em uma única chamada usando a TagResource API. Para atualizar a chave de uma tag existente, você deve combinar as TagResource APIs UntagResource e.

Importante

A edição de tags para um espaço de trabalho Amazon Managed Grafana pode afetar o acesso a esse espaço de trabalho. Antes de editar uma tag para um espaço de trabalho, revise todas as políticas do IAM que possam usar a chave ou o valor de uma tag para controlar o acesso a recursos, como repositórios.

Console

Você pode usar o console para editar as tags associadas ao espaço de trabalho Amazon Managed Grafana.

1. Abra o console Amazon Managed Grafana no Console Grafana.

2. No painel de navegação à esquerda, escolha o ícone do menu.

3. Escolha Todos os workspaces.

4. Escolha o ID do workspace do workspace que você quiser gerenciar.

5. Escolha a guia Tags.

6. Selecione Gerenciar tags.

7. No campo Chave, insira um nome para a tag. Você pode adicionar um valor opcional para a tag no campo de valor.

8. Ao terminar de editar as tags, escolha Salvar alterações.

CLI

Siga estas etapas para usar o AWS CLI para atualizar uma tag para um espaço de trabalho. Você pode alterar o valor de uma chave existente ou adicionar outra chave.

No terminal ou na linha de comando, execute o comando tag-resource, especificando o Amazon Resource Name (ARN) do espaço de trabalho Amazon Managed Grafana em que você deseja atualizar uma tag e especifique a chave e o valor da tag.

Por exemplo, para alterar o valor de uma tag com um novo valor, Key_value_new, execute o comando a seguir.

aws grafana tag-resource \
    --resource-arn arn:aws:grafana:us-west-2:123456789012:/workspace/workspace-IDstring \
    --tags "Name=Key_value_new"

Para alterar a chave de uma tag com um novo nome, Name_new, execute os seguintes comandos:

aws grafana untag-resource --resource-arn arn:aws:grafana:us-west-2:123456789012:/workspace/workspace-IDstring --tag-keys Items=Name
aws grafana tag-resource --resource-arn arn:aws:grafana:us-west-2:123456789012:/workspace/workspace-IDstring --tags "Name_new=Key_value_old"

Remova uma tag de um workspace

É possível remover uma ou mais tags associadas a um projeto. A remoção de uma tag não exclui a tag de outros AWS recursos associados a essa tag.

Importante

A remoção de tags de um espaço de trabalho do Amazon Managed Grafana pode afetar o acesso a esse espaço de trabalho. Antes de remover uma tag de um espaço de trabalho, revise todas as políticas do IAM que possam usar a chave ou o valor de uma tag para controlar o acesso a recursos, como espaços de trabalho.

Console

É possível usar o console para remover a associação entre uma tag e um workspace.

1. Abra o console Amazon Managed Grafana no Console Grafana.

2. No painel de navegação à esquerda, escolha o ícone do menu.

3. Escolha Todos os workspaces.

4. Escolha o ID do workspace do workspace que você quiser gerenciar.

5. Escolha a guia Tags.

6. Selecione Gerenciar tags.

7. Encontre a tag que você deseja excluir e escolha Remover.

8. Quando terminar de remover as tags, escolha Salvar alterações.

CLI

Siga estas etapas para usar o AWS CLI para remover uma tag de um espaço de trabalho. A remoção de uma tag não exclui a tag de outros recursos, mas simplesmente remove a associação entre a tag e o espaço de trabalho.

nota

Se você excluir um espaço de trabalho Amazon Managed Grafana, todas as associações de tags serão removidas do espaço de trabalho excluído. Você não precisa remover as tags antes de excluir um workspace.

No terminal ou na linha de comando, execute o comando untag-resource, especificando o Amazon Resource Name (ARN) do espaço de trabalho em que você deseja remover as tags e a chave da tag que você deseja remover. Por exemplo, para remover uma tag em um espaço de trabalho chamado Workspace-IDString com a chave de tag Name, execute o seguinte comando:

aws grafana untag-resource --resoure-arn arn:aws:grafana:us-west-2:/workspaces/workspace-IDstring --tag-keys Items=Name

Se for bem-sucedido, esse comando retornará uma resposta vazia. Para verificar se as tags associadas ao espaço de trabalho foram removidas, execute o list-tags-for-resourcecomando.