Limiti della piattaforma
La piattaforma non fornisce una quantità infinita di risorse e vengono imposti limiti al numero di chiamate API che possono essere effettuate.
Un architetto di soluzioni deve garantire che la soluzione non superi i limiti imposti dalla piattaforma mediante una progettazione appropriata e codice personalizzato in grado di gestire l'eventuale violazione dei limiti.
Richieste API
Le richieste in Microsoft Power Platform consistono di varie azioni che un utente esegue in vari prodotti. L'elenco seguente descrive ciò che a livello generale costituisce una richiesta API:
- Power Apps: tutte le richieste API ai connettori e a Microsoft Dataverse.
- Power Automate: tutte le richieste API a connettori, azioni HTTP e azioni predefinite, dall'inizializzazione delle variabili a una semplice azione di composizione. Nel calcolo di queste limitazioni vengono conteggiate sia le azioni completate che quelle non riuscite. Inoltre, i nuovi tentativi e altre richieste dall'impaginazione contano come implementazioni di azioni. In regola generale, ogni passaggio in un flusso cloud di Power Automate è una richiesta API.
- Dataverse: tutte le operazioni di creazione, lettura, aggiornamento ed eliminazione (CRUD), assegnazione e condivisione, incluse le richieste di sistema guidate dall'utente e interne necessarie per completare le transazioni CRUD, nonché operazioni speciali come la condivisione o l'assegnazione. Queste richieste possono provenire da qualsiasi client o applicazione e possono usare qualsiasi endpoint. Queste richieste includono, ad esempio, plug-in, flussi di lavoro classici e controlli personalizzati che eseguono le operazioni menzionate in precedenza.
Limiti di diritto
I limiti di diritto rappresentano il numero di richieste API che gli utenti hanno il diritto di effettuare ogni giorno. Il limite allocato dipende dal tipo di licenza assegnata a ogni utente. I limiti di diritto per le API si basano su un periodo di 24 ore, come mostrato nella tabella seguente.
| Prodotti | Richieste per licenza a pagamento per 24 ore |
|---|---|
| Utenti con licenza a pagamento per Power Platform (fatta esclusione per Power Apps per app, Power Automate per flusso e Power Virtual Agents) e Dynamics 365 fatta esclusione per Dynamics 365 Team Member | 40.000 |
| Piano con pagamento in base al consumo per Power Apps e utenti con licenza a pagamento per Power Apps per app, app Microsoft 365 con accesso a Power Platform e Dynamics 365 Team Member | 6.000 |
| Piano per Power Automate per flusso, offerta base per Power Virtual Agents e pacchetto aggiuntivo Power Virtual Agents | 250.000 |
| Accesso a pagamento ai portali Power Apps | 200 |
Con Dataverse è possibile avere identità che non richiedono una licenza utente per interagire con il servizio. I quattro tipi di utenti sono:
- Utenti dell'applicazione
- Utenti non interattivi
- Utenti amministrativi
- Utente di sistema
Ogni tenant ha una capacità di richiesta di base per tenant utilizzabile solo da questi utenti e non da utenti con licenze standard. Questa capacità di richiesta di base si basa sul tipo di sottoscrizione, come segue:
- Se un tenant include almeno una sottoscrizione Enterprise di Dynamics 365, ottiene 100.000 richieste ogni 24 ore.
- Se un tenant include almeno una sottoscrizione Professional di Dynamics 365, ottiene 50.000 richieste ogni 24 ore.
- Se un tenant include almeno una sottoscrizione Microsoft Power Apps o Power Automate, ottiene 25.000 richieste ogni 24 ore.
Il componente aggiuntivo di capacità di Power Apps e Power Automate consente ai clienti di aumentare i limiti per un determinato utente. Ogni componente aggiuntivo di capacità aumenta i limiti di richieste di altre 10.000 richieste ogni 24 ore.
Nota
Per altre informazioni, consultare Limiti e allocazioni delle richieste.
Limiti del servizio
Oltre al limite giornaliero di richieste API, sono disponibili limiti di protezione del servizio specifici di ogni servizio. Come con i limiti giornalieri, i limiti del servizio assicurano la qualità del servizio proteggendo il servizio da comportamenti dannosi o perturbatori che potrebbero interrompere il servizio per tutti i clienti.
I limiti dell'API di protezione dei servizi impediscono agli utenti che eseguono applicazioni di interferire tra loro in base a vincoli di risorse. I limiti non interesseranno i normali utenti della piattaforma. È possibile che siano interessate solo le applicazioni che eseguono numerose richieste API. I limiti forniscono un livello di protezione da picchi aleatori e imprevisti nei volumi di richieste che minacciano le caratteristiche di disponibilità e prestazioni della piattaforma Dataverse.
Microsoft limita il numero di connessioni simultanee per ogni account utente, il numero di richieste API per ogni connessione e la quantità di tempo di esecuzione che può essere usata per ogni connessione. Queste limiti vengono valutati entro una finestra temporale scorrevole di cinque minuti. Quando uno di questi limiti viene superato, la piattaforma genera un'eccezione.
Importante
I limiti di protezione del servizio non possono essere aumentati.
Nota
Per altre informazioni, consultare Panoramica dei limiti delle API.
Modelli e criteri per tentativi
La logica personalizzata che usa le API deve gestire i tentativi. Quando si verifica un errore nel limite delle API di protezione dei servizi, viene fornito un valore che indica la durata prima che qualsiasi nuova richiesta dell'utente possa essere elaborata.
L'API Web restituisce un errore 429 se viene raggiunto il limite. La risposta include una chiave Retry-After con il numero di secondi. Con il servizio organizzazione, viene restituito un valore TimeSpan nella raccolta OrganizationServiceFault.ErrorDetails con la chiave Retry-After.
Nota
È necessario fare attenzione a non peggiorare la situazione effettuando un numero eccessivo di tentativi.
Per altre informazioni, consultare l'articolo sui limiti di protezione del servizio.
Riduzione delle chiamate API
La progettazione della soluzione non deve dipendere da una capacità infinita disponibile. Per gli utenti che fanno un uso normale di app interattive, i limiti sono stati definiti a un livello sufficientemente elevato da non avere conseguenze.
Le applicazioni progettate per caricare dati in Dataverse o eseguire aggiornamenti in blocco devono anche essere in grado di gestire gli errori nei limiti dell'API di protezione dei servizi. Queste applicazioni privilegiano la velocità di modo che possano completare il lavoro nel minor tempo possibile. Devono disporre di una strategia per ritentare le operazioni.
Le applicazioni del portale in genere inviano richieste da utenti anonimi tramite un account dell'entità servizio. Poiché i limiti dell'API di protezione dei servizi sono basati su ogni singolo utente, le applicazioni del portale possono raggiungere i limiti dell'API di protezione dei servizi in base alla quantità di traffico nel portale.
Le integrazioni dovrebbero essere ottimizzate per ridurre al minimo il numero di chiamate API.
Gli architetti di soluzioni devono anche valutare come includere la disponibilità elevata nella progettazione della soluzione.