Regolazione

Microsoft Fabric usa la limitazione per mantenere prestazioni e affidabilità ottimali. Fabric limita il numero di chiamate API all'interno di un intervallo di tempo per utente, quindi un chiamante può effettuare solo una determinata quantità di chiamate in un determinato periodo.

I criteri di limitazione si svolgono sia per il chiamante API che per l'API stessa. Ciò significa che Fabric limita il numero di chiamate che un chiamante specifico può eseguire su un'API specifica.

Messaggio di limitazione

Quando si verifica una limitazione, Fabric restituisce un codice di stato HTTP 429 (troppe richieste). Fabric restituisce un codice di stato 429 per due motivi distinti, ognuno identificato da un diverso errorCode nel corpo della risposta:

Esaminare il errorCode valore nella risposta per determinare quale condizione si è verificata e come rispondere.

Limite di velocità superato (RequestBlocked)

Quando un utente invia molte richieste che superano un limite predeterminato durante un intervallo di tempo, Fabric limita ulteriori richieste da tale utente per un breve periodo.

In questo caso, Fabric restituisce un codice di stato HTTP 429 (troppe richieste) con un'intestazione Retry-After HTTP nella risposta, indicando quanti secondi l'applicazione chiamante deve attendere prima di ripetere la chiamata. Il corpo della risposta usa il RequestBlocked codice di errore:

{
    "errorCode": "RequestBlocked",
    "message": "Request is blocked by the upstream service until: 2/18/2026 10:45:04 PM (UTC)"
}

Quando viene visualizzato questo errore, attendere la durata specificata nell'intestazione Retry-After prima di ripetere la richiesta.

Lo screenshot seguente mostra un esempio di risposta che suggerisce che l'utente attende 55 secondi prima di ripetere la chiamata.

Screenshot che mostra un'intestazione di risposta HTTP.

Limite di capacità superato (CapacityLimitExceeded)

Fabric restituisce anche un codice di stato HTTP 429 (troppe richieste) quando la capacità Fabric dell'organizzazione ha superato i limiti. A differenza della limitazione della velocità, questa limitazione non è causata dal numero di chiamate API effettuate da un chiamante specifico. Si verifica invece quando il calcolo (unità di capacità) utilizzato nella capacità supera i limiti del Fabric SKU acquistato. Il corpo della risposta usa il CapacityLimitExceeded codice di errore:

{
    "errorCode": "CapacityLimitExceeded",
    "message": "Your organization's Fabric compute capacity has exceeded its limits. Try again later."
}

Quando viene visualizzato questo errore, provare di nuovo la richiesta in un secondo momento. Poiché questa limitazione dipende dal calcolo complessivo usato per la capacità anziché dalla frequenza delle singole richieste, è improbabile che il nuovo tentativo abbia esito positivo fino a quando l'utilizzo di calcolo della capacità non rientra entro i limiti. Se si verifica spesso questo errore, valutare la possibilità di aumentare o aumentare la capacità di Fabric. Per altre informazioni su unità di capacità, SKU e modalità di utilizzo della capacità Fabric, vedere Pianificare le dimensioni della capacità.

Considerazioni e limitazioni

Ogni chiamata api pubblica di base e amministratore di Fabric viene limitata.

Contenuto correlato

  • Last updated on