

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á.

# Editar tags associadas a uma chave do KMS
<a name="edit-tags"></a>

As tags ajudam a identificar e organizar seus AWS recursos. Você pode editar as tags associadas às chaves KMS gerenciadas pelo cliente no AWS KMS console ou usando a [TagResource](https://docs.aws.amazon.com/kms/latest/APIReference/API_TagResource.html)operação. Você não pode editar as tags de um Chave gerenciada pela AWS.

Os procedimentos a seguir demonstram como editar as tags associadas a uma chave do KMS. Os exemplos de API do AWS KMS usam a [AWS Command Line Interface (AWS CLI)](https://aws.amazon.com/cli/), mas você pode usar qualquer linguagem de programação compatível.

## Usando o AWS KMS console
<a name="edit-tag-console"></a>

1. Faça login no console Console de gerenciamento da AWS e abra o AWS Key Management Service (AWS KMS) em [https://console.aws.amazon.com/kms](https://console.aws.amazon.com/kms).

1. Para alterar o Região da AWS, use o seletor de região no canto superior direito da página.

1. No painel de navegação, escolha **Chaves gerenciadas pelo cliente**. (Você não pode editar as tags de um Chave gerenciada pela AWS)

1. É possível usar o filtro de tabela para exibir somente chaves do KMS com etiquetas específicas. Para obter detalhes, consulte [Visualizar tags usando o console do AWS KMS](view-tags.md#view-tag-console).

1. Marque a caixa de seleção ao lado do alias de uma chave do KMS.

1. Selecione **Key actions (Ações de chave)**, **Add or edit tags (Adicionar ou editar tags)**.

1. Na página de detalhes da chave do KMS, selecione a guia **Tags** (Etiquetas).
   + Para alterar o nome ou o valor de uma tag, selecione **Edit (Editar)**, faça as alterações e selecione **Save (Salvar)**.

1. Para salvar suas alterações, escolha **Salvar alterações**.

## Usando a AWS KMS API
<a name="tag-existing-api"></a>

A [TagResource](https://docs.aws.amazon.com/kms/latest/APIReference/API_TagResource.html)operação adiciona uma ou mais tags a uma chave gerenciada pelo cliente;. No entanto, você também pode usar **TagResource** para alterar o valor de uma tag existente. Não é possível usar essa operação para adicionar ou editar etiquetas em uma Conta da AWS diferente.

Para editar uma tag, especifique uma chave de tag existente e um novo valor de tag. Cada etiqueta em uma chave do KMS deve ter um nome de etiqueta diferente. O valor da tag pode ser uma string nula ou vazia.

Por exemplo, esse comando altera o valor da tag `Purpose` de `Pretest` para `Test`.

```
$ aws kms tag-resource \
         --key-id 1234abcd-12ab-34cd-56ef-1234567890ab \
         --tags TagKey=Purpose,TagValue=Test
```