View a markdown version of this page

Gestore AWS Cloud Map DiscoverInstances Limitazione delle richieste API - AWS Cloud Map

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

AWS Cloud Map limita le richieste DiscoverInstances 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 DiscoverInstancesAPI non superino le quote massime consentite DiscoverInstances per le richieste API. DiscoverInstances 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.

Come viene applicata la limitazione

AWS Cloud Map utilizza l'algoritmo 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

La limitazione limita il numero di richieste DiscoverInstances API che puoi effettuare. Ogni richiesta rimuove un token dal bucket. Ad esempio, la dimensione del bucket per l'operazione DiscoverInstances API è di 2.000 token, quindi puoi effettuare fino a 2.000 DiscoverInstances 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'DiscoverInstancesAPI è di 2.000 token e la frequenza di ricarica è di 1.000 token al secondo. Se effettui 2.000 richieste DiscoverInstances 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 API in un secondo, puoi comunque effettuare fino a 1.000 richieste DiscoverInstances 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

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

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 nella Guida di riferimento di AWS SDK and Tools.

Modifica delle quote di limitazione delle API

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.