

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Gestore AWS Cloud Map DiscoverInstances Limitazione delle richieste API
<a name="throttling"></a>

AWS Cloud Map limita le richieste [ DiscoverInstances ](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html) API per ogni AWS account in base alla regione. La limitazione aiuta a migliorare le prestazioni del servizio e aiuta a fornire un utilizzo corretto per tutti i clienti. AWS Cloud Map La limitazione garantisce che le chiamate all' AWS Cloud Map [DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html)API non superino le quote massime consentite [ DiscoverInstances ](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html) per le richieste API. [DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html) Le chiamate API provenienti da una delle seguenti fonti sono soggette alle quote di richiesta:
+ Un'applicazione di terze parti
+ Uno strumento a riga di comando
+ La AWS Cloud Map console

Se superi una quota di limitazione delle API, viene visualizzato il codice di `RequestLimitExceeded` errore. Per ulteriori informazioni, consulta [Limitazione del tasso di richiesta](#throttling-rate-based).

## Come viene applicata la limitazione
<a name="throttling-how"></a>

AWS Cloud Map utilizza l'algoritmo [ token bucket ](https://en.wikipedia.org/wiki/Token_bucket) per implementare la limitazione delle API. Con questo algoritmo, il tuo account ha un * bucket * che contiene un numero specifico di token. * * Il numero di token nel bucket rappresenta la tua quota di limitazione in un dato secondo. Esiste un bucket per una singola regione e si applica a tutti gli endpoint della regione.

### Limitazione del tasso di richiesta
<a name="throttling-rate-based"></a>

La limitazione limita il numero di richieste [ DiscoverInstances ](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html) API che puoi effettuare. Ogni richiesta rimuove un token dal bucket. Ad esempio, la dimensione del bucket per l'operazione [ DiscoverInstances ](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html) API è di 2.000 token, quindi puoi effettuare fino a 2.000 [ DiscoverInstances ](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html) richieste in un secondo. Se superi le 2.000 richieste in un secondo, la limitazione è limitata e le richieste rimanenti entro quel secondo hanno esito negativo.

I bucket si riempiono automaticamente a una velocità prestabilita. Se il bucket non è al massimo, viene aggiunto un determinato numero di token ogni secondo fino a quando il bucket non raggiunge la capacità. Se il bucket è a pieno carico quando arrivano i token di ricarica, questi token vengono scartati. La dimensione del bucket per il funzionamento dell'[DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html)API è di 2.000 token e la frequenza di ricarica è di 1.000 token al secondo. Se effettui 2.000 richieste [ DiscoverInstances ](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html) API in un secondo, il bucket viene immediatamente ridotto a zero (0) token. Il bucket viene quindi riempito con un massimo di 1.000 token ogni secondo fino a raggiungere la sua capacità massima di 2.000 token.

Puoi usare i token man mano che vengono aggiunti al bucket. Non è necessario attendere che il bucket raggiunga la capacità massima prima di effettuare richieste API. Se esaurisci il bucket effettuando 2.000 richieste [ DiscoverInstances ](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html) API in un secondo, puoi comunque effettuare fino a 1.000 richieste [ DiscoverInstances ](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html) API ogni secondo per tutto il tempo necessario. Ciò significa che puoi utilizzare immediatamente i token di ricarica non appena vengono aggiunti al tuo bucket. Il bucket inizia a riempirsi fino alla capacità massima solo quando si effettuano meno richieste API ogni secondo rispetto alla frequenza di ricarica.

### Tentativi ripetuti o elaborazione batch
<a name="retries"></a>

Se una richiesta API fallisce, l'applicazione potrebbe dover riprovare la richiesta. Per ridurre il numero di richieste API, utilizza un intervallo di sospensione appropriato tra le richieste successive. Per ottimizzare i risultati, utilizzare un intervallo di attesa incrementale o variabile.

### Calcolo dell'intervallo di attesa
<a name="calculate_delay_interval"></a>

Quando è necessario eseguire il polling o rieseguire una richiesta API, è consigliato l'uso di un algoritmo di backoff esponenziale per calcolare l'intervallo di tempo di attesa tra le chiamate API. Utilizzando tempi di attesa progressivamente più lunghi tra i tentativi per le risposte di errore consecutive, puoi ridurre il numero di richieste non riuscite. Per ulteriori informazioni ed esempi di implementazione di questo algoritmo, consulta [ Retry Behavior ](https://docs.aws.amazon.com/sdkref/latest/guide/feature-retry-behavior.html) nella Guida di riferimento di *AWS SDK and Tools. *

## Modifica delle quote di limitazione delle API
<a name="throttling-increase"></a>

Puoi richiedere un aumento delle quote di limitazione delle API per il tuo account. AWS Per richiedere un adeguamento delle quote, contatta il [centro Supporto AWS](https://console.aws.amazon.com/support/home#/).