Limiti del servizio per Servizi di comunicazione di Azure
Questo documento illustra le limitazioni delle API Servizi di comunicazione di Azure e le possibili risoluzioni.
Modelli di limitazione e architettura
Quando si raggiungono le limitazioni del servizio, si riceve un codice di stato HTTP 429 (troppe richieste). In generale, di seguito sono riportate le procedure consigliate per la gestione della limitazione delle richieste:
- Ridurre il numero di operazioni per ogni richiesta.
- Ridurre la frequenza delle chiamate.
- Evitare tentativi immediati perché tutte le richieste si accumulano rispetto ai limiti di utilizzo.
Per informazioni più generali su come configurare l'architettura del servizio per gestire la limitazione e le limitazioni, vedere la documentazione sull'architettura di Azure per i modelli di limitazione. I limiti di limitazione possono essere aumentati tramite una richiesta al supporto tecnico di Azure.
- Aprire il portale di Azure ed eseguire l'accesso.
- Selezionare Guida e supporto.
- Fare clic su Crea nuova richiesta di supporto.
- Nella casella di testo Descrivere il problema immettere
Technical
e quindi fare clic su Vai. - Dal menu a discesa Seleziona un servizio selezionare Limiti servizio e sottoscrizione (quote) e quindi fare clic su Avanti.
- Nella descrizione del problema scegliere tipo di problema, Sottoscrizione e Tipo di quota e quindi fare clic su Avanti.
- Esaminare una soluzione consigliata, se disponibile, quindi fare clic su Avanti.
- Aggiungere altri dettagli in base alle esigenze, quindi fare clic su Avanti.
- In Rivedi e crea controlla le informazioni, apporta modifiche in base alle esigenze, quindi fai clic su Crea.
È possibile seguire la documentazione per la creazione di una richiesta al supporto tecnico di Azure.
Acquisizione dei numeri di telefono
Prima di acquisire un numero di telefono, assicurarsi che la sottoscrizione soddisfi i requisiti geografici e di sottoscrizione . In caso contrario, non è possibile acquistare un numero di telefono. Le limitazioni seguenti si applicano ai numeri di acquisto tramite Telefono Numbers SDK e il portale di Azure.
Operazione | Ambito | Intervallo di tempo | Limite (numero di richieste) |
---|---|---|---|
Acquistare il numero di telefono | Tenant di Azure | - | 1 |
Cercare numeri di telefono | Tenant di Azure | una settimana | 5 |
Azione da eseguire
Per altre informazioni, vedere la pagina del concetto di tipi di numeri di telefono e la pagina di panoramica del concetto di telefonia.
Se vuoi acquistare più numeri di telefono o effettuare un ordine speciale, segui le istruzioni qui. Se si desidera trasferire numeri di telefono gratuiti da account esterni al proprio account Servizi di comunicazione di Azure, seguire le istruzioni riportate qui.
Identità
Operazione | Intervalli di tempo (secondi) | Limite (numero di richieste) |
---|---|---|
Creare un'identità | 30 | 1000 |
Eliminare l'identità | 30 | 500 |
Rilasciare il token di accesso | 30 | 1000 |
Revocare il token di accesso | 30 | 500 |
createUserAndToken | 30 | 1000 |
exchangeTokens | 30 | 500 |
Azione da eseguire
È consigliabile acquisire identità e token prima di creare thread di chat o avviare chiamate. Ad esempio, all'avvio della pagina Web o all'avvio dell'applicazione.
Per altre informazioni, vedere la pagina di panoramica del concetto di identità.
SMS
Quando si invia o si riceve un volume elevato di messaggi, è possibile che venga visualizzato un 429
errore. Questo errore indica che si stanno raggiungendo le limitazioni del servizio e i messaggi vengono accodati per l'invio dopo che il numero di richieste è inferiore alla soglia.
Limiti di frequenza per SMS:
Operazione | Tipo di numero | Ambito | Intervallo di tempo (s) | Limite (richiesta #) | Unità messaggio al minuto |
---|---|---|---|---|---|
Invia messaggio | Numero verde | Per numero | 60 | 200 | 200 |
Invia messaggio | Codice breve | Per numero | 60 | 6000 | 6000 |
Invia messaggio | ID mittente alfanumerico | Per risorsa | 60 | 600 | 600 |
Azione da eseguire
Se si hanno requisiti che superano i limiti di frequenza, inviare una richiesta al supporto tecnico di Azure per abilitare una velocità effettiva più elevata.
Per altre informazioni su SMS SDK e sul servizio, vedere la pagina di panoramica di SMS SDK o la pagina domande frequenti su SMS.
Esiste un limite al numero di messaggi di posta elettronica che è possibile inviare per un determinato periodo di tempo. Se si superano i limiti seguenti per la sottoscrizione, le richieste vengono rifiutate. È possibile tentare di nuovo queste richieste quando è trascorso il tempo di ripetizione dei tentativi. È possibile effettuare una richiesta per aumentare i limiti del volume di invio, se necessario.
Limiti di velocità
Operazione | Ambito | Intervallo di tempo (minuti) | Limite (numero di messaggi di posta elettronica) |
---|---|---|---|
Invia messaggio e-mail | Per sottoscrizione | 1 | 30 |
Invia messaggio e-mail | Per sottoscrizione | 60 | 100 |
Ottenere lo stato della posta elettronica | Per sottoscrizione | 1 | 60 |
Ottenere lo stato della posta elettronica | Per sottoscrizione | 60 | 200 |
Operazione | Ambito | Intervallo di tempo (minuti) | Limite (numero di messaggi di posta elettronica) |
---|---|---|---|
Invia messaggio e-mail | Per sottoscrizione | 1 | 5 |
Invia messaggio e-mail | Per sottoscrizione | 60 | 10 |
Ottenere lo stato della posta elettronica | Per sottoscrizione | 1 | 10 |
Ottenere lo stato della posta elettronica | Per sottoscrizione | 60 | 20 |
Limiti di dimensioni
Nome | Limit |
---|---|
Numero di destinatari nel messaggio di posta elettronica | 50 |
Dimensioni totali della richiesta di posta elettronica (inclusi gli allegati) | 10 MB |
Azione da eseguire
Questa configurazione sandbox consente agli sviluppatori di iniziare a compilare l'applicazione. Dopo aver stabilito una reputazione del mittente inviando messaggi di posta elettronica, è possibile richiedere di aumentare i limiti del volume di invio. Inviare una richiesta di supporto per aumentare il limite di invio di posta elettronica desiderato se è necessario inviare un volume di messaggi che superano i limiti di frequenza. Le richieste di aumento della quota di posta elettronica non vengono approvate automaticamente. Il team di revisione considera la reputazione complessiva del mittente, che include fattori quali i tassi di errore di recapito della posta elettronica, la reputazione del dominio e i rapporti di posta indesiderata e abuso durante la determinazione dello stato di approvazione.
Nota
Le richieste di aumento della quota di posta elettronica possono richiedere fino a 72 ore per essere valutate e approvate, in particolare per le richieste che arrivano il venerdì pomeriggio.
Chat
Limiti di dimensioni
Nome | Limit |
---|---|
Numero di partecipanti nel thread | 250 |
Batch di partecipanti - CreateThread | 200 |
Batch di partecipanti - AddParticipant | 200 |
Dimensioni pagina - ListMessages | 200 |
Dimensioni del messaggio | 28 KB |
Numero di risorse Servizi di comunicazione di Azure per Azure Bot | 1000 |
Limiti di velocità
Operazione | Scope | Limite per 10 secondi | Limite al minuto |
---|---|---|---|
Creare un thread di chat | per utente | 10 | - |
Eliminare il thread di chat | per utente | 10 | - |
Aggiornare il thread di chat | per thread di chat | 5 | - |
Aggiungere partecipanti/rimuovere partecipanti | per thread di chat | 10 | 30 |
Ottenere thread di chat/elencare i thread di chat | per utente | 50 | - |
Ottenere un messaggio di chat | per utente per thread di chat | 50 | - |
Ottenere un messaggio di chat | per thread di chat | 250 | - |
Elencare i messaggi di chat | per utente per thread di chat | 50 | 200 |
Elencare i messaggi di chat | per thread di chat | 250 | 400 |
Ottieni ricevute di lettura (limite di 20 partecipanti**) | per utente per thread di chat | 5 | - |
Ottieni ricevute di lettura (limite di 20 partecipanti**) | per thread di chat | 100 | - |
Elencare i partecipanti al thread di chat | per utente per thread di chat | 10 | - |
Elencare i partecipanti al thread di chat | per thread di chat | 250 | - |
Invia messaggio/aggiorna messaggio/elimina messaggio | per thread di chat | 10 | 30 |
Invia ricevuta di lettura | per utente per thread di chat | 10 | 30 |
Invia indicatore di digitazione | per utente per thread di chat | 5 | 15 |
Invia indicatore di digitazione | per thread di chat | 10 | 30 |
Nota
** Le ricevute di lettura e gli indicatori di digitazione non sono supportati nei thread di chat con più di 20 partecipanti.
Archiviazione chat
Servizi di comunicazione di Azure archivia i messaggi di chat in base ai criteri di conservazione impostati quando si crea un thread di chat.
Importante
La funzionalità descritta in questo articolo è attualmente disponibile in anteprima pubblica. Questa versione di anteprima viene fornita senza contratto di servizio, pertanto se ne sconsiglia l’uso per i carichi di lavoro in ambienti di produzione. Alcune funzionalità potrebbero non essere supportate o potrebbero presentare funzionalità limitate. Per altre informazioni, vedere le Condizioni supplementari per l'uso delle anteprime di Microsoft Azure.
È possibile scegliere tra conservazione illimitata dei messaggi o eliminazione automatica tra 30 e 90 giorni tramite i criteri di conservazione nell'API Crea thread di chat. In alternativa, è possibile scegliere di non impostare criteri di conservazione in un thread di chat.
Se si hanno esigenze di conformità rigorose, è consigliabile eliminare i thread di chat usando il thread di chat di eliminazione API. Tutti i thread creati prima che i nuovi criteri di conservazione non siano interessati a meno che non si modifichi in modo specifico il criterio per quel thread.
Nota
Se i messaggi sono stati eliminati accidentalmente, non possono essere recuperati dal sistema. Inoltre, se si invia una richiesta di supporto per un thread di chat eliminato dopo che i criteri di conservazione hanno eliminato tale thread, non possono più essere recuperate e non sono disponibili informazioni su tale thread. Se necessario, aprire un ticket di supporto il più rapidamente possibile all'interno della finestra di 30 giorni dopo aver creato un thread in modo da potervi assistere.
Chiamate vocali e video
Limitazioni delle chiamate PSTN
Nome | Scope | Limite |
---|---|---|
Numero predefinito di chiamate simultanee* in uscita | per numero | 2 |
*: nessun limite per le chiamate simultanee in ingresso. È anche possibile inviare una richiesta al supporto tecnico di Azure per aumentare il limite di chiamate simultanee in uscita e verrà esaminato dal team di verifica.
Limitazioni massime delle chiamate
Nome | Limit |
---|---|
Numero di partecipanti | 350 |
Supporto per lo streaming sdk per chiamate
Communication Services Calling SDK supporta le configurazioni di streaming seguenti:
Limite | Web | Windows/Android/iOS |
---|---|---|
Numero massimo di flussi locali in uscita che è possibile inviare contemporaneamente | un video o una condivisione dello schermo | un video + una condivisione dello schermo |
Numero massimo di flussi remoti in ingresso di cui è possibile eseguire il rendering contemporaneamente | 9 video + condivisione di uno schermo | 9 video + condivisione di uno schermo |
Sebbene l'SDK per chiamate non applichi questi limiti, gli utenti potrebbero riscontrare una riduzione delle prestazioni se vengono superati.
Timeout dell'SDK per chiamate
I timeout seguenti si applicano agli SDK per chiamate di Servizi di comunicazione:
Azione | Timeout in secondi |
---|---|
Riconnettere/rimuovere un partecipante | 120 |
Aggiungere o rimuovere una nuova modalità da una chiamata (Avvio/arresto video o condivisione dello schermo) | 40 |
Timeout dell'operazione di trasferimento delle chiamate | 60 |
1:1 timeout dell'istituzione di chiamate | 85 |
Timeout dell'istituzione di chiamate di gruppo | 85 |
Timeout dell'istituzione di chiamate PSTN | 115 |
Alzare di livello 1:1 la chiamata a un timeout di chiamata di gruppo | 115 |
Azione da eseguire
Per altre informazioni sull'SDK per chiamate vocali e videochiamate e sul servizio, vedere la pagina di panoramica dell'SDK chiamante o i problemi noti. È anche possibile inviare una richiesta al supporto tecnico di Azure per aumentare alcuni dei limiti e quindi viene esaminato dal team di verifica.
Router processo
Quando si invia o si riceve un volume elevato di richieste, è possibile che venga visualizzato un ThrottleLimitExceededException
errore. Questo errore indica che si stanno raggiungendo le limitazioni del servizio e le richieste verranno eliminate fino a quando il token del bucket per gestire le richieste viene rifornito dopo un determinato periodo di tempo.
Limiti di frequenza per il router processo:
Operazione | Ambito | Intervallo di tempo (secondi) | Limite (numero di richieste) | Timeout in secondi |
---|---|---|---|---|
Richieste generali | Per risorsa | 10 | 1000 | 10 |
Azione da eseguire
Se è necessario inviare un volume di messaggi che superano i limiti di frequenza, inviare un messaggio di posta elettronica all'indirizzo acs-ccap@microsoft.com.
Interoperabilità di Teams e Microsoft Graph
Usando uno scenario di interoperabilità di Teams, è probabile che si usino alcune API Di Microsoft Graph per creare riunioni.
Ogni servizio offerto tramite Microsoft Graph presenta limitazioni diverse; I limiti specifici del servizio sono descritti qui in modo più dettagliato.
Azione da eseguire
Quando si implementa la gestione degli errori, usare il codice di errore HTTP 429 per rilevare la limitazione delle richieste. La risposta non riuscita include l'intestazione della Retry-After
risposta. Il back-off delle richieste che usano il Retry-After
ritardo è il modo più rapido per eseguire il ripristino dalla limitazione perché Microsoft Graph continua a registrare l'utilizzo delle risorse mentre un client viene limitato.
Per altre informazioni sui limiti di limitazione di Microsoft Graph, vedere la documentazione di Microsoft Graph.
Passaggi successivi
Vedere le opzioni della Guida e del supporto tecnico.