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á. # Cotas e uso O Amazon Location Service coloca cotas nas operações de gerenciamento de chaves de API para ajudar a gerenciar a capacidade do serviço e evitar a utilização excessiva. Você pode ajustar essas cotas por meio do console AWS Service Quotas ou entrando em contato com o suporte. Esta seção aborda as cotas de serviço para APIs de autenticação, o monitoramento de uso com CloudWatch e como solicitar aumentos. ## Cotas de serviço O Amazon Location Service define cotas padrão para operações de gerenciamento de chaves de API, que podem ser visualizadas no console de gerenciamento de Cotas de AWS Serviços. Você pode solicitar um aumento por meio do console de autoatendimento (os links são mostrados na tabela a seguir), para até 2x o limite padrão para cada operação. Para limites de cota que excedam o dobro do limite padrão, solicite no [console Service Quotas](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) e ele enviará um tíquete de suporte. Como alternativa, você pode se conectar com sua equipe de suporte premium. Não há cobranças diretas para solicitações de aumento de cota. **Cotas de gerenciamento de chaves de API** | Operation | Padrão | Limite máximo ajustável | Mais do que o limite máximo ajustável | | --- | --- | --- | --- | | Chaves de API por conta por região | 500 | Não ajustável | N/A | | [CreateKey](https://docs.aws.amazon.com/location/latest/APIReference/API_geoapikeys_CreateKey.html) | 10 TPS | 20 TPS | Solicitar no [console de cota de serviço](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) ou entrar em contato com a equipe de suporte | | [DescribeKey](https://docs.aws.amazon.com/location/latest/APIReference/API_geoapikeys_DescribeKey.html) | 10 TPS | 20 TPS | Solicitar no [console de cota de serviço](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) ou entrar em contato com a equipe de suporte | | [UpdateKey](https://docs.aws.amazon.com/location/latest/APIReference/API_geoapikeys_UpdateKey.html) | 10 TPS | 20 TPS | Solicitar no [console de cota de serviço](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) ou entrar em contato com a equipe de suporte | | [DeleteKey](https://docs.aws.amazon.com/location/latest/APIReference/API_geoapikeys_DeleteKey.html) | 10 TPS | 20 TPS | Solicitar no [console de cota de serviço](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) ou entrar em contato com a equipe de suporte | | [ListKeys](https://docs.aws.amazon.com/location/latest/APIReference/API_geoapikeys_ListKeys.html) | 10 TPS | 20 TPS | Solicitar no [console de cota de serviço](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) ou entrar em contato com a equipe de suporte | Para cotas nas APIs que você chama usando uma chave de API (mapas, lugares e rotas), consulte a página de cotas e uso de cada serviço: + [Mapear cotas e uso](map-quota-and-usage.md) + [Cotas e uso de locais](places-quota-usage.md) + [Uso e cota de rotas](routes-quota-usage.md) ## Monitore o uso com CloudWatch Use CloudWatch a Amazon para monitorar o uso de chaves de API, detectar anomalias e definir alarmes quando os padrões de uso mudarem inesperadamente. O Amazon Location Service exporta métricas para o `AWS/Location` namespace com a `ApiKeyName` dimensão, permitindo que você acompanhe o uso por chave. ### Métricas disponíveis As métricas a seguir estão disponíveis com a `ApiKeyName` dimensão: **CloudWatch Métricas-chave da API** | Métrica | Description | Estatística útil | | --- | --- | --- | | CallCount | Número de chamadas de API feitas usando a chave. | Soma | | ErrorCount | Número de respostas de erro para chamadas feitas usando a chave. | Soma | | SuccessCount | Número de chamadas bem-sucedidas feitas usando a chave. | Soma | | CallLatency | Hora de processar e retornar uma resposta para chamadas feitas usando a chave. | Média | Você pode filtrar as métricas pelas seguintes combinações de dimensões: + `ApiKeyName, OperationName`— Uso por chave por operação de API. + `ApiKeyName, OperationName, ResourceName`— Uso por chave por operação por recurso. + `ApiKeyName, OperationName, OperationVersion`— Uso por chave por operação para APIs independentes de mapas, lugares e rotas. ### Detecte anomalias nos padrões de uso Crie CloudWatch alarmes para detectar padrões de uso incomuns que possam indicar o uso não autorizado de uma chave de API ou aplicativos mal configurados: + **Aumento no volume de chamadas** — ative um alarme `CallCount` com a `ApiKeyName` dimensão para alertar quando o uso de uma chave exceder sua linha de base normal. Use a detecção de CloudWatch anomalias para adaptar automaticamente os limites com base em padrões históricos. + **Aumento de erros** — ative um alarme `ErrorCount` para detectar quando uma chave está recebendo um número anormal de solicitações rejeitadas, o que pode indicar que uma parte não autorizada está tentando usar a chave. + **Uso inesperado fora do horário** de expediente — Use a detecção de CloudWatch anomalias `CallCount` para aprender automaticamente os padrões normais de tráfego diário e semanal do seu aplicativo. Os alertas são acionados quando o uso se desvia dos padrões esperados, como tráfego significativo durante horas em que seu aplicativo normalmente está ocioso. Para obter mais informações sobre a criação de alarmes, consulte [Usando CloudWatch com o Amazon Location Service](https://docs.aws.amazon.com/location/latest/developerguide/cloudwatch.html). ## Próximas etapas Para obter informações adicionais, consulte: + [Visualizando suas cotas de serviço e configurando alarmes](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Quotas-Visualize-Alarms.html): monitore o uso em relação aos limites de cota no Guia do usuário. CloudWatch + [Preços do Amazon Location Service](https://aws.amazon.com/location/pricing/): revise os detalhes de preços de todas as APIs do Amazon Location Service. + [SLA](https://aws.amazon.com/location/sla/): examine o Contrato de Nível de Serviço do Amazon Location Service para entender as garantias de disponibilidade. + [Termos de serviço](https://aws.amazon.com/service-terms/): familiarize-se com os termos legais que regem o uso do Amazon Location Service.