

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

# Lidar com a limitação de solicitações de AWS Cloud Map DiscoverInstances API
<a name="throttling"></a>

AWS Cloud Map limita as solicitações de [DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html)API para cada AWS conta por região. A limitação ajuda a melhorar o desempenho do serviço e ajuda a fornecer um uso justo para todos os AWS Cloud Map clientes. A limitação garante que as chamadas para a AWS Cloud Map [DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html)API não excedam as cotas máximas permitidas de solicitações de [DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html)API. [DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html) As chamadas de API provenientes de qualquer uma das seguintes fontes estão sujeitas às cotas de solicitação:
+ Aplicativos de terceiros
+ Uma ferramentas da linha de comando
+ O AWS Cloud Map console

Se você exceder a cota de controle de utilização de API, receberá o código de erro `RequestLimitExceeded`. Para obter mais informações, consulte [Limitação de intervalo de solicitações](#throttling-rate-based).

## Como o controle de utilização é aplicado
<a name="throttling-how"></a>

AWS Cloud Map usa o [algoritmo de token bucket](https://en.wikipedia.org/wiki/Token_bucket) para implementar a limitação de API. Com esse algoritmo, sua conta tem um *bucket* que contém um número específico de *tokens*. O número de tokens no bucket representa sua cota de controle de utilização a qualquer segundo. Há um bucket para cada região e ele se aplica a todos os endpoints na região.

### Limitação de intervalo de solicitações
<a name="throttling-rate-based"></a>

A limitação limita o número de solicitações de [DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html)API que você pode fazer. Cada solicitação feita remove um token do bucket. Por exemplo, o tamanho do bucket para a operação da [DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html)API é de 2.000 tokens, então você pode fazer até 2.000 [DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html)solicitações em um segundo. Se você exceder as 2.000 solicitações em um segundo, você será limitado pelo controle de utilização e as solicitações excedentes nesse segundo falharão.

Os buckets são recarregados automaticamente a uma taxa definida. Se o bucket não atingir a capacidade máxima, um determinado número de tokens será adicionado novamente a cada segundo até que o bucket atinja a capacidade máxima. Se o bucket atingir a capacidade máxima quando os tokens de recarga forem adicionados, esses tokens serão descartados. O tamanho do bucket para a operação da [DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html)API é de 2.000 tokens e a taxa de recarga é de 1.000 tokens a cada segundo. Se você fizer 2.000 solicitações de [DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html)API em um segundo, o bucket será imediatamente reduzido para zero (0) tokens. O bucket é, então, reabastecido com até 1.000 tokens a cada segundo até atingir sua capacidade máxima de 2.000 tokens.

Você pode usar tokens à medida que eles são adicionados ao bucket. Para fazer solicitações de API, não é necessário esperar que o bucket atinja sua capacidade máxima. Se você esgotar o bucket fazendo 2.000 solicitações de [DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html)API em um segundo, ainda poderá fazer até 1.000 solicitações de [DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html)API a cada segundo depois disso, pelo tempo que precisar. Isso significa que você pode usar imediatamente os tokens de recarga à medida que eles são adicionados ao seu bucket. O bucket só começa a ser recarregado até a capacidade máxima quando você faz menos solicitações de API a cada segundo do que a taxa de recarga.

### Repetições ou processamento em lote
<a name="retries"></a>

Caso uma solicitação de API falhe, seu aplicativo pode precisar repetir a solicitação. Para reduzir a taxa de solicitações de API, use um intervalo de latência apropriado entre as solicitações sucessivas. Para obter os melhores resultados, use um intervalo de latência crescente ou variável.

### Calcular o intervalo de repouso
<a name="calculate_delay_interval"></a>

Quando você precisar fazer a sondagem ou repetir uma solicitação de API, é recomendável usar um algoritmo de recuo exponencial para calcular o intervalo de latência entre as chamadas de API. Ao usar tempos de espera progressivamente maiores entre as novas tentativas de respostas de erro consecutivas, é possível reduzir o número de solicitações com falha. Para obter mais informações e exemplos de implementação desse algoritmo, consulte [Retry Behavior](https://docs.aws.amazon.com/sdkref/latest/guide/feature-retry-behavior.html) no *Guia de referência de ferramentas AWS SDKs e ferramentas*.

## Ajustar as cotas de controle de utilização da API
<a name="throttling-increase"></a>

Você pode solicitar um aumento nas cotas de limitação de API para sua conta. AWS Para solicitar um ajuste de cota, entre em contato com a [Central do AWS Support](https://console.aws.amazon.com/support/home#/).