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.
# Búsqueda del nombre del alias y el ARN de alias para una clave de KMS
Los alias facilitan el reconocimiento de las claves KMS en la AWS KMS consola. Puede ver los alias de una clave KMS en la AWS KMS consola o mediante esta operación. [ListAliases](https://docs.aws.amazon.com/kms/latest/APIReference/API_ListAliases.html) La [DescribeKey](https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html)operación, que devuelve las propiedades de una clave KMS, no incluye los alias.
Los siguientes procedimientos muestran cómo ver e identificar los alias asociados a una clave de KMS mediante la AWS KMS consola y AWS KMS la API. Los ejemplos de AWS KMS API usan [AWS Command Line Interface (AWS CLI)](https://aws.amazon.com/cli/), pero puedes usar cualquier lenguaje de programación compatible.
## Uso de la AWS KMS consola
La AWS KMS consola muestra los alias asociados a la clave KMS.
1. Abra la AWS KMS consola 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. Si desea ver las claves de la cuenta que usted crea y administra, elija en el panel de navegación, **Claves administradas por el cliente**. Para ver las claves de la cuenta que se AWS crean y administran para usted, en el panel de navegación, seleccione las claves **AWS administradas**.
1. La columna **Aliases (Alias)** muestra el alias de cada clave KMS. Si una clave KMS no tiene un alias, aparece un guion (**-**) en la columna **Aliases (Alias)**.
Si una clave KMS tiene varios alias, la columna **Aliases (Alias)** también tiene un resumen de alias, como **(\$1*n* más)**. Por ejemplo, la siguiente clave KMS tiene dos alias, uno de los cuales es `key-test`.
Para buscar el nombre del alias y el ARN de alias de la clave KMS, utilice la pestaña **Aliases (Alias)**.
+ Para ir directamente a la pestaña **Aliases (Alias)**, en la columna **Aliases (Alias)**, elija el resumen de alias (**\$1*n* más**). Un resumen de alias sólo aparece si la clave KMS tiene más de un alias.
+ O bien, elija el alias o el ID de clave de la clave KMS (que abre la página de detalles de la clave KMS) y, a continuación, elija la pestaña **Aliases (Alias)**. Las pestañas están debajo de la sección **General configuration (Configuración general)**.
![\[Claves administradas por el cliente interface showing a list with one key and options to create or filter keys.\]](http://docs.aws.amazon.com/es_es/kms/latest/developerguide/images/find-alias-name-1-sm.png)
1. La pestaña **Aliases (Alias)** muestra el nombre del alias y el ARN del alias de todos los alias de una clave KMS. También puede crear y eliminar alias para la clave KMS en esta pestaña.
![\[Aliases tab showing two key aliases with their names and ARNs listed in a table format.\]](http://docs.aws.amazon.com/es_es/kms/latest/developerguide/images/alias-tab-1.png)
**Claves administradas por AWS**
Puedes usar el alias para reconocer una Clave administrada de AWS, como se muestra en esta **Claves administradas por AWS**página de ejemplo. Los alias de Claves administradas por AWS siempre tienen el formato: `aws/`. Por ejemplo, el alias de Amazon `aws/dynamodb` DynamoDB es. Clave administrada de AWS
![\[Alias de la página Claves administradas por AWS de la consola de AWS KMS .\]](http://docs.aws.amazon.com/es_es/kms/latest/developerguide/images/alias-console-aws-managed-sm.png)
## Uso de la API AWS KMS
La [ListAliases](https://docs.aws.amazon.com/kms/latest/APIReference/API_ListAliases.html)operación devuelve el nombre del alias y el ARN del alias de la cuenta y la región. El resultado incluye los alias para Claves administradas por AWS y para las claves administradas por el cliente. Los alias de Claves administradas por AWS deben tener el formato`aws/`, como, por ejemplo,`aws/dynamodb`.
La respuesta también podría incluir los alias que no tienen el campo `TargetKeyId`. Se trata de alias predefinidos que se AWS han creado pero que aún no se han asociado a una clave de KMS.
```
$ aws kms list-aliases
{
"Aliases": [
{
"AliasName": "alias/access-key",
"AliasArn": "arn:aws:kms:us-west-2:111122223333:alias/access-key",
"TargetKeyId": "0987dcba-09fe-87dc-65ba-ab0987654321",
"CreationDate": 1516435200.399,
"LastUpdatedDate": 1516435200.399
},
{
"AliasName": "alias/ECC-P521-Sign",
"AliasArn": "arn:aws:kms:us-west-2:111122223333:alias/ECC-P521-Sign",
"TargetKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
"CreationDate": 1693622000.704,
"LastUpdatedDate": 1693622000.704
},
{
"AliasName": "alias/ImportedKey",
"AliasArn": "arn:aws:kms:us-west-2:111122223333:alias/ImportedKey",
"TargetKeyId": "1a2b3c4d-5e6f-1a2b-3c4d-5e6f1a2b3c4d",
"CreationDate": 1493622000.704,
"LastUpdatedDate": 1521097200.235
},
{
"AliasName": "alias/finance-project",
"AliasArn": "arn:aws:kms:us-west-2:111122223333:alias/finance-project",
"TargetKeyId": "0987dcba-09fe-87dc-65ba-ab0987654321",
"CreationDate": 1604958290.014,
"LastUpdatedDate": 1604958290.014
},
{
"AliasName": "alias/aws/dynamodb",
"AliasArn": "arn:aws:kms:us-west-2:111122223333:alias/aws/dynamodb",
"TargetKeyId": "0987ab65-43cd-21ef-09ab-87654321cdef",
"CreationDate": 1521097200.454,
"LastUpdatedDate": 1521097200.454
},
{
"AliasName": "alias/aws/ebs",
"AliasArn": "arn:aws:kms:us-west-2:111122223333:alias/aws/ebs",
"TargetKeyId": "abcd1234-09fe-ef90-09fe-ab0987654321",
"CreationDate": 1466518990.200,
"LastUpdatedDate": 1466518990.200
}
]
}
```
Para obtener todos los alias que están asociados con una determinada clave KMS, utilice el parámetro `KeyId` de la operación `ListAliases`. El parámetro `KeyId` toma el [ID de clave](concepts.md#key-id-key-id) o el [ARN de clave](concepts.md#key-id-key-ARN) de la clave KMS.
En este ejemplo se obtienen todos los alias asociados con el`0987dcba-09fe-87dc-65ba-ab0987654321` de la clave KMS.
```
$ aws kms list-aliases --key-id 0987dcba-09fe-87dc-65ba-ab0987654321
{
"Aliases": [
{
"AliasName": "alias/access-key",
"AliasArn": "arn:aws:kms:us-west-2:111122223333:alias/access-key",
"TargetKeyId": "0987dcba-09fe-87dc-65ba-ab0987654321",
"CreationDate": "2018-01-20T15:23:10.194000-07:00",
"LastUpdatedDate": "2018-01-20T15:23:10.194000-07:00"
},
{
"AliasName": "alias/finance-project",
"AliasArn": "arn:aws:kms:us-west-2:111122223333:alias/finance-project",
"TargetKeyId": "0987dcba-09fe-87dc-65ba-ab0987654321",
"CreationDate": 1604958290.014,
"LastUpdatedDate": 1604958290.014
}
]
}
```
El parámetro `KeyId` no toma caracteres comodín, pero puede usar las características de su lenguaje de programación para filtrar la respuesta.
Por ejemplo, el siguiente AWS CLI comando solo obtiene los alias de. Claves administradas por AWS
```
$ aws kms list-aliases --query 'Aliases[?starts_with(AliasName, `alias/aws/`)]'
```
El siguiente comando obtiene sólo el alias de `access-key`. El nombre del alias distingue entre mayúsculas y minúsculas.
```
$ aws kms list-aliases --query 'Aliases[?AliasName==`alias/access-key`]'
[
{
"AliasName": "alias/access-key",
"AliasArn": "arn:aws:kms:us-west-2:111122223333:alias/access-key",
"TargetKeyId": "0987dcba-09fe-87dc-65ba-ab0987654321",
"CreationDate": "2018-01-20T15:23:10.194000-07:00",
"LastUpdatedDate": "2018-01-20T15:23:10.194000-07:00"
}
]
```