

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.

# API de autenticación
<a name="auth-apis"></a>

Las siguientes API te permiten gestionar las claves de API de Amazon Location Service. Utilice estas operaciones para crear claves, configurar restricciones, rotar claves y supervisar su inventario de claves.
+ **CreateKey**: crea una nueva clave de API con restricciones específicas y una caducidad opcional. Devuelve el valor de la clave utilizado para autenticar las solicitudes de API posteriores. Para obtener más información, consulta [CreateKey](https://docs.aws.amazon.com/location/latest/APIReference/API_geoapikeys_CreateKey.html)la *referencia de la API de Amazon Location Service*.
+ **DescribeKey**: Recupera los detalles de una clave de API existente, incluidas sus restricciones, caducidad y valor de clave. Para obtener más información, consulta [DescribeKey](https://docs.aws.amazon.com/location/latest/APIReference/API_geoapikeys_DescribeKey.html)la *referencia de la API de Amazon Location Service*.
+ **UpdateKey**: modifica las restricciones, el vencimiento o la descripción de una clave de API existente. Usa esta operación para restringir los permisos, extender o establecer la caducidad o desactivar una clave. Para obtener más información, consulta [UpdateKey](https://docs.aws.amazon.com/location/latest/APIReference/API_geoapikeys_UpdateKey.html)la *referencia de la API de Amazon Location Service*.
+ **DeleteKey**: Elimina permanentemente una clave de API. Solo puedes eliminar las claves que hayan estado inactivas durante al menos 90 días. Para obtener más información, consulta [DeleteKey](https://docs.aws.amazon.com/location/latest/APIReference/API_geoapikeys_DeleteKey.html)la *referencia de la API de Amazon Location Service*.
+ **ListKeys**: Devuelve una lista de las claves de API de tu cuenta y región, que incluye metadatos como el nombre, el estado y la caducidad de la clave. Para obtener más información, consulta [ListKeys](https://docs.aws.amazon.com/location/latest/APIReference/API_geoapikeys_ListKeys.html)la *referencia de la API de Amazon Location Service*.

## Casos de uso comunes
<a name="auth-apis-common-use-cases"></a>

Los siguientes son casos de uso comunes para las operaciones de administración de claves de API.
+ **Crear una clave para una aplicación de mapas**: cree una clave restringida a `geo-maps:*` las acciones del recurso predeterminado del proveedor de mapas, adecuada para una página web que solo renderiza mapas.
+ **Cree una clave para mapas y lugares**: cree una clave que permita renderizar mapas y geocodificar especificando múltiples acciones y recursos permitidos en una sola clave.
+ **Rota una clave de API**: crea una clave nueva, actualiza tu aplicación para utilizarla y, a continuación, desactiva la clave anterior configurando su caducidad en una fecha pasada utilizando. `UpdateKey`
+ **Agrega restricciones de dominio**: actualiza una clave existente para restringir el uso a dominios web específicos mediante restricciones de cliente basadas en el referente.
+ **Audite el inventario de claves**: enumere todas las claves de la cuenta y utilícelas `ListKeys` para identificar las claves no utilizadas o que están caducando.
+ **Revocar una clave comprometida**: desactive una clave inmediatamente actualizando su estado con `UpdateKey` una clave y elimínela después de 90 días de uso. `DeleteKey`