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

# Excluir um alias
<a name="alias-delete"></a>

Você pode excluir um alias no AWS KMS console ou usando a [DeleteAlias](https://docs.aws.amazon.com/kms/latest/APIReference/API_DeleteAlias.html)operação. Antes de excluir um alias, verifique se ele não está em uso. Embora a exclusão de um alias não afete a chave do KMS associada, ela pode criar problemas para qualquer aplicação que use esse alias. Se você excluir um alias por engano, poderá criar um novo alias com o mesmo nome e associá-lo à mesma chave do KMS ou a outra chave do KMS.

Se uma chave do KMS for excluída, todos os aliases associados a ela serão excluídos também.

## Usando o AWS KMS console
<a name="alias-delete-console"></a>

Para excluir um alias no AWS KMS console, use a guia **Aliases** na página de detalhes da chave KMS. É possível excluir vários aliases de uma chave do KMS ao mesmo tempo.

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 gerenciar aliases para Chaves gerenciadas pela AWS ou Chaves pertencentes à AWS.

1. Na tabela, escolha o ID de chave ou alias da chave do KMS. Em seguida, na página de detalhes da chave do KMS, escolha a guia **Aliases**.

   Se uma chave do KMS tiver vários aliases, a coluna **Aliases** na tabela exibe um alias e um resumo de alias, como **(Mais *n*)**. Escolher o resumo de aliases leva diretamente à guia **Aliases** na página de detalhes da chave do KMS.

1. Na guia **Aliases**, marque a caixa de seleção ao lado dos aliases que deseja excluir. Escolha **Excluir**.

## Usando a AWS KMS API
<a name="alias-delete-api"></a>

Para excluir um alias, use a [DeleteAlias](https://docs.aws.amazon.com/kms/latest/APIReference/API_DeleteAlias.html)operação. Essa operação exclui um alias por vez. O nome do alias faz distinção entre maiúsculas e minúsculas e deve ser precedido pelo prefixo `alias/`.

Por exemplo, o comando a seguir exclui o alias chamado `test-key`. Esse comando não retorna nenhuma saída. 

```
$ aws kms delete-alias --alias-name alias/test-key
```

Para verificar se o alias foi excluído, use a [ListAliases](https://docs.aws.amazon.com/kms/latest/APIReference/API_ListAliases.html)operação. O comando a seguir usa o `--query` parâmetro no AWS CLI para obter somente o `test-key` alias. Os colchetes vazios na resposta indicam que a resposta `ListAliases` não incluiu um alias `test-key`. Para eliminar os colchetes, use o parâmetro `--output text` e o valor.

```
$ aws kms list-aliases --query 'Aliases[?AliasName==`alias/test-key`]'
[]
```