Come posso evitare gli errori "ThrottlingException" o "Tasso superato" quando utilizzo Parameter Store di AWS Systems Manager?

Breve descrizione

Le chiamate API di Parameter Store non possono superare il tasso massimo di richieste API consentito per account e per regione AWS. Questo include le chiamate API sia dall'interfaccia della riga di comando AWS (AWS CLI) che dalla Console di gestione AWS. Se le richieste API superano la velocità massima, riceverai un errore "Tasso superato" e le ulteriori chiamate API saranno limitate. Potresti visualizzare un errore simile a uno dei seguenti:

• Si è verificato un errore (ThrottlingException) durante la chiamata all'operazione GetParameters (raggiunto il numero massimo di tentativi: 4): Tasso superato
• Si è verificato un errore (ThrottlingException) durante la chiamata all'operazione GetParameter (raggiunto il numero massimo di tentativi: 4): Tasso superato
• Si è verificato un errore (ThrottlingException) durante la chiamata all'operazione GetParametersByPath (raggiunto il numero massimo di tentativi: 4): Tasso superato
• Si è verificato un errore (ThrottlingException) durante la chiamata all'operazione DescribeParameters (raggiunto il numero massimo di tentativi): 2): Tasso superato

Le richieste di Parameter Store sono limitate per ogni account Amazon Web Services (AWS) su base regionale per favorire le prestazioni del servizio. Per maggiori informazioni sulle quote di velocità di trasmissione effettiva massime di Parameter Store API, consulta Endpoint e quote di AWS Systems Manager.

Risoluzione

Risoluzione dei problemi

Per evitare o ridurre gli errori di tipo "ThrottlingException" o "Tasso superato", prova a seguire i seguenti passaggi per la risoluzione dei problemi:

• Riduci la frequenza delle chiamate API.
• Scagliona gli 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 consentono di recuperare 10 parametri con una sola chiamata API.
• Ripeti i tentativi in caso di errore e implementa un backoff esponenziale quando effettui le chiamate API.
• Aumenta la velocità di trasmissione effettiva di Parameter Store.
  Importante: l'aumento della velocità di trasmissione effettiva comporta un addebito sul tuo account AWS. Per ulteriori informazioni, consulta Prezzi di AWS Systems Manager.
  Nota: puoi aumentare la velocità di trasmissione effettiva utilizzando la console AWS Systems Manager, l'interfaccia AWS CLI o AWS Tools for Windows PowerShell. Se ricevi dei messaggi di errore durante l'esecuzione dei comandi AWS CLI, assicurati di utilizzare la versione più recente di AWS CLI.

Richiedi un aumento della quota di servizio

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

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

Per richiedere un aumento della quota di servizio per Parameter Store, segui questi passaggi:

1. Apri il Centro di Supporto AWS, quindi scegli Crea caso.
2. Scegli Stai cercando un aumento dei limiti di servizio?
3. In Tipo di limite, scegli EC2 Systems Manager.
4. In Regione, scegli la tua regione AWS in Richieste.
5. In Tipo di risorsa, scegli Parameter Store.
6. Scegli il Limite che desideri aumentare, quindi inserisci il Nuovo valore limite.
7. Nella casella di testo Descrizione del caso d'uso, includi il periodo di tempo relativo al problema di limitazione e il motivo della richiesta di aumento della quota.
8. Scegli le tue opzioni di contatto preferite, quindi scegli Invia.

Informazioni correlate

Backoff esponenziale e jitter

Risoluzione dei problemi Parameter Store