

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

# Gestisci la 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. Il throttling aiuta a migliorare le prestazioni del servizio e a garantire un utilizzo equo 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 da riga di comando
+ La AWS Cloud Map console

Se superi una quota di limitazione dell'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 il throttling delle API. *Con questo algoritmo, il tuo account dispone di un *bucket* che contiene un numero specifico di token.* Il numero di token nel bucket rappresenta la tua quota di throttling 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 è possibile 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, vieni limitato e le richieste rimanenti entro quel secondo hanno esito negativo.

I secchi si ricaricano automaticamente a una velocità prestabilita. Se il bucket non è al massimo, viene aggiunto un determinato numero di token ogni secondo finché il bucket non raggiunge la capacità. Se il bucket è al massimo della capacità 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 ricaricato fino a 1.000 token al secondo fino a raggiungere la capacità massima di 2.000 token.

Puoi utilizzare 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 ricaricarsi 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, utilizzate 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 un tentativo e l'altro per le risposte di errore consecutive, è possibile ridurre il numero di richieste non riuscite. Per ulteriori informazioni ed esempi di implementazione di questo algoritmo, consulta [Retry Behavior nella *AWS SDKs and Tools* Reference](https://docs.aws.amazon.com/sdkref/latest/guide/feature-retry-behavior.html) Guide.

## Regolazione 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#/).