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

# APIs de autenticação
<a name="auth-apis"></a>

As seguintes APIs permitem que você gerencie chaves de API para o Amazon Location Service. Use essas operações para criar chaves, configurar restrições, girar chaves e monitorar seu inventário de chaves.
+ **CreateKey**: cria uma nova chave de API com restrições especificadas e expiração opcional. Retorna o valor da chave usado para autenticar solicitações de API subsequentes. Para obter mais informações, consulte [CreateKey](https://docs.aws.amazon.com/location/latest/APIReference/API_geoapikeys_CreateKey.html)a *Amazon Location Service API Reference*.
+ **DescribeKey**: recupera os detalhes de uma chave de API existente, incluindo suas restrições, expiração e valor da chave. Para obter mais informações, consulte [DescribeKey](https://docs.aws.amazon.com/location/latest/APIReference/API_geoapikeys_DescribeKey.html)a *Amazon Location Service API Reference*.
+ **UpdateKey**: modifica as restrições, a expiração ou a descrição de uma chave de API existente. Use essa operação para restringir as permissões, estender ou definir a expiração ou desativar uma chave. Para obter mais informações, consulte [UpdateKey](https://docs.aws.amazon.com/location/latest/APIReference/API_geoapikeys_UpdateKey.html)a *Amazon Location Service API Reference*.
+ **DeleteKey**: exclui permanentemente uma chave de API. Você só pode excluir chaves que estejam inativas por pelo menos 90 dias. Para obter mais informações, consulte [DeleteKey](https://docs.aws.amazon.com/location/latest/APIReference/API_geoapikeys_DeleteKey.html)a *Amazon Location Service API Reference*.
+ **ListKeys**: retorna uma lista de chaves de API em sua conta e região, incluindo metadados como nome, status e expiração da chave. Para obter mais informações, consulte [ListKeys](https://docs.aws.amazon.com/location/latest/APIReference/API_geoapikeys_ListKeys.html)a *Amazon Location Service API Reference*.

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

Veja a seguir casos de uso comuns para operações de gerenciamento de chaves de API.
+ **Crie uma chave para um aplicativo de mapas**: Crie uma chave restrita a `geo-maps:*` ações no recurso padrão do provedor de mapas, adequada para uma página da web que renderiza apenas mapas.
+ **Crie uma chave para mapas e lugares**: Crie uma chave que permita a renderização e a geocodificação de mapas especificando várias ações e recursos permitidos em uma única chave.
+ **Gire uma chave de API**: crie uma nova chave, atualize seu aplicativo para usá-la e, em seguida, desative a chave antiga definindo sua expiração como uma data passada usando. `UpdateKey`
+ **Adicionar restrições de domínio**: atualize uma chave existente para restringir o uso a domínios da Web específicos usando restrições de cliente baseadas em referenciadores.
+ **Inventário de chaves de auditoria**: liste todas as chaves da conta usando `ListKeys` para identificar chaves não utilizadas ou expiradas para limpeza.
+ **Revogar uma chave comprometida**: desative uma chave imediatamente atualizando seu status com e, em seguida`UpdateKey`, exclua-a após 90 dias de uso. `DeleteKey`