Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Eliminación de un alias
<a name="alias-delete"></a>

Puede eliminar un alias en la AWS KMS consola o mediante la [DeleteAlias](https://docs.aws.amazon.com/kms/latest/APIReference/API_DeleteAlias.html)operación. Antes de eliminar un alias, asegúrese de que no esté en uso. Aunque eliminar un alias no afecta a la clave KMS asociada, puede crear problemas para cualquier aplicación que utilice el alias. Si elimina un alias por error, puede crear un nuevo alias con el mismo nombre y asociarlo a la misma clave KMS o a otra.

Si elimina una clave KMS, se eliminan todos los alias asociados a esa clave KMS.

## Uso de la AWS KMS consola
<a name="alias-delete-console"></a>

Para eliminar un alias de la AWS KMS consola, utilice la pestaña **Alias** de la página de detalles de la clave KMS. Puede eliminar varios alias para una clave KMS a la vez.

1. Inicie sesión en la consola AWS Key Management Service (AWS KMS) Consola de administración de AWS y ábrala en [https://console.aws.amazon.com/kms.](https://console.aws.amazon.com/kms)

1. Para cambiarla Región de AWS, usa el selector de regiones en la esquina superior derecha de la página.

1. En el panel de navegación, elija **Claves administradas por el cliente**. No puede administrar los alias de o. Claves administradas por AWS Claves propiedad de AWS

1. En la tabla, elija el ID de clave o el alias de la clave KMS. A continuación, en la página de detalles de la clave KMS, elija la pestaña **Aliases (Alias)**.

   Si una clave KMS tiene varios alias, la columna **Aliases (Alias)** de la tabla muestra un alias y un resumen de alias, como **(\$1*n* más)**. Al elegir el resumen de alias, se le llevará directamente a la pestaña **Aliases (Alias)** en la página de detalles de la clave KMS.

1. En la pestaña **Aliases (Alias)**, seleccione la casilla de verificación situada junto a los alias que desea eliminar. A continuación, elija **Eliminar**.

## Uso de la API AWS KMS
<a name="alias-delete-api"></a>

Para eliminar un alias, utilice la [DeleteAlias](https://docs.aws.amazon.com/kms/latest/APIReference/API_DeleteAlias.html)operación. Esta operación elimina un alias a la vez. El nombre del alias distingue entre mayúsculas y minúsculas y debe estar precedido por el prefijo `alias/`.

Por ejemplo, el siguiente comando elimina el alias `test-key`. El comando no devuelve ningún resultado. 

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

Para comprobar que se ha eliminado el alias, utilice la [ListAliases](https://docs.aws.amazon.com/kms/latest/APIReference/API_ListAliases.html)operación. El comando siguiente utiliza el `--query` parámetro de AWS CLI para obtener únicamente el `test-key` alias. Los corchetes vacíos en la respuesta indican que la respuesta `ListAliases` no incluyó un alias `test-key`. Para eliminar los corchetes, utilice el parámetro y valor `--output text`.

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