Come posso evitare gli errori "ThrottlingException" con il messaggio "Rate exceeded" (Frequenza superata) quando uso l'Archivio dei parametri?

Breve descrizione

Le chiamate API dell'Archivio dei parametri non possono superare la frequenza massima di richieste API consentita per ogni account AWS e regione AWS. La frequenza massima consentita include le chiamate API sia dall'interfaccia della linea di comando AWS (AWS CLI) che dalla Console di gestione AWS.

Se le richieste API superano la frequenza massima, potresti visualizzare un messaggio di errore simile a uno dei seguenti:

• "An error occurred (ThrottlingException) when calling the GetParameters operation (reached max retries: 4): Rate exceeded" (Si è verificato un errore (ThrottlingException) durante la chiamata all'operazione GetParameters (raggiunto il numero massimo di tentativi: 4): frequenza superata.)
• "An error occurred (ThrottlingException) when calling the GetParameter operation (reached max retries: 4): Rate exceeded" (Si è verificato un errore (ThrottlingException) durante la chiamata all'operazione GetParameter (raggiunto il numero massimo di tentativi: 4): frequenza superata.)
• "An error occurred (ThrottlingException) when calling the GetParametersByPath operation (reached max retries: 4): Rate exceeded" (Si è verificato un errore (ThrottlingException) durante la chiamata all'operazione GetParametersByPath (raggiunto il numero massimo di tentativi: 4): frequenza superata.)
• "An error occurred (ThrottlingException) when calling the DescribeParameters operation (reached max retries: 2): Rate exceeded" (Si è verificato un errore (ThrottlingException) durante la chiamata all'operazione DescribeParameters (raggiunto il numero massimo di tentativi): 2): frequenza superata.)

Per migliorare le prestazioni dei servizi, l'Archivio dei parametri limita le richieste per ogni account e Regione. Per ulteriori informazioni sulle quote di throughput massimo dell'API Parameter Store, consulta Quote di servizio per l'Archivio dei parametri.

Risoluzione

Nota: se ricevi errori quando esegui i comandi dell'Interfaccia della linea di comando AWS (AWS CLI), consulta Risoluzione degli errori per AWS CLI. Inoltre, assicurati di utilizzare la versione più recente di AWS CLI.

Risoluzione del problema

Per evitare messaggi di errore "ThrottlingException" che specificano "Rate exceeded", esegui le operazioni seguenti:

• Riduci la frequenza delle chiamate API.
• Configura intervalli tra le chiamate API, in modo che non vengano eseguite tutte contemporaneamente.
• Usa API che restituiscano più di un valore. Ad esempio, GetParameters e GetParametersByPath possono recuperare 10 parametri con una sola chiamata API.
• Implementa le ripetizioni dei tentativi in caso di errore e il backoff esponenziale quando effettui chiamate API. Per istruzioni, consulta Comportamento di ripetizione.
• Se utilizzi AWS Lambda per chiamare API sull'Archivio dei parametri, memorizza i parametri nella cache.
• Aumenta il throughput dell'Archivio dei parametri.
  Importante: quando aumenti il throughput, ricevi un addebito sul tuo account. Per ulteriori informazioni, consulta Prezzi di AWS Systems Manager.

Richiedi un aumento della quota dei servizi

Se hai provato tutti i passaggi precedenti per la risoluzione dei problemi ma continui a ricevere i messaggi di errore "Rate exceeded", puoi richiedere un aumento della quota dei servizi.

Nota: prima di inviare la richiesta, identifica la chiamata API e la frequenza delle chiamate.

Per richiedere un aumento della quota dei servizi per l'Archivio dei parametri, completa i passaggi seguenti:

1. Apri la console del Centro di supporto AWS, quindi scegli Crea un caso.
2. Scegli Looking for service limit increases? (Vuoi aumentare i limiti dei servizi?)
3. In Limit type (Tipo di limite) scegli EC2 Systems Manager.
4. In Region (Regione) scegli la tua regione AWS in Requests (Richieste).
5. In Tipo di risorsa, scegli Archivio dei parametri.
6. Per Quota, seleziona un elemento, quindi descrivi il motivo dell'aumento della quota API nella casella di testo Descrizione del caso d'uso.
   Nota: non esiste un elemento applicabile per il numero massimo di transazioni al secondo di chiamate API.
7. Inserisci il nuovo valore della quota.
8. Nella casella di testo Use case description (Descrizione del caso d'uso) includi il periodo di tempo relativo al problema di limitazione e il motivo della richiesta di aumento della quota.
9. Scegli le opzioni di contatto preferite, quindi fai clic su Submit (Invia).

Informazioni correlate

Backoff esponenziale e jitter

Risoluzione dei problemi Parameter Store