Condividi tramite

Limitazione

  • Articolo

Gli archivi di configurazione hanno limiti per le richieste che possono servire. Tutte le richieste che superano una quota assegnata per un archivio di configurazione riceveranno una risposta HTTP 429 (troppe richieste).

La limitazione è suddivisa in criteri di quota diversi:

  • Totale richieste - Numero totale di richieste
  • Larghezza di banda totale : dati in uscita in byte
  • Archiviazione - Dimensioni totali di archiviazione dei dati utente in byte

Gestione delle risposte limitate

Quando è stato raggiunto il limite di velocità per una determinata quota, il server risponderà a ulteriori richieste di tale tipo con un codice di stato 429 . La risposta 429 conterrà un'intestazione retry-after-ms che fornisce al client un tempo di attesa suggerito (in millisecondi) per consentire il rifornimento della quota della richiesta.

HTTP/1.1 429 (Too Many Requests)
retry-after-ms: 10
Content-Type: application/problem+json; charset=utf-8

{
  "type": "https://azconfig.io/errors/too-many-requests",
  "title": "Resource utilization has surpassed the assigned quota",
  "policy": "Total Requests",
  "status": 429
}

Nell'esempio precedente, il client ha superato la quota consentita ed è consigliabile rallentare e attendere 10 millisecondi prima di tentare altre richieste. I client devono considerare anche il backoff progressivo.

Altri tentativi

Il servizio potrebbe identificare situazioni diverse dalla limitazione che richiede un nuovo tentativo client (ad esempio 503 Servizio non disponibile). In tutti questi casi, verrà fornita l'intestazione della retry-after-ms risposta. Per aumentare l'affidabilità, è consigliabile che il client segua l'intervallo suggerito ed esegua un nuovo tentativo.

HTTP/1.1 503 Service Unavailable
retry-after-ms: 787

Monitoraggio

Per visualizzare l'utilizzo della quota delle richieste totali, Configurazione app fornisce una metrica denominata Utilizzo quota richiesta. La metrica di utilizzo della quota di richiesta mostra l'utilizzo della quota corrente come percentuale.

Per altre informazioni sulla metrica di utilizzo della quota di richiesta e altre metriche di Configurazione app, vedere Informazioni di riferimento sul monitoraggio dei dati Configurazione app.