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 riceverà 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.
- Passare al portale di Azure
- Selezionare Guida e supporto
- Fare clic su Crea nuova richiesta di supporto
- Nella descrizione del problema scegliere Tipo di problema come Tecnico e aggiungere i dettagli.
È 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 verranno accodati per l'invio quando 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. Se si superano i limiti seguenti per la sottoscrizione, le richieste verranno rifiutate. È possibile tentare di nuovo queste richieste dopo il superamento del tempo di ripetizione dei tentativi. Eseguire le azioni necessarie e richiedere di 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 considererà la reputazione complessiva del mittente, che include fattori come i tassi di errore di recapito della posta elettronica, la reputazione del dominio e i report 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 a tempo indeterminato fino a quando non vengono eliminati dal cliente.
A partire da CY24 Q1, i clienti devono scegliere tra conservazione illimitata dei messaggi o eliminazione automatica dopo 90 giorni. I messaggi esistenti rimangono invariati, ma i clienti possono optare per un periodo di conservazione di 90 giorni, se necessario.
Nota
I messaggi eliminati accidentalmente non sono recuperabili dal sistema.
Chiamate vocali e video
Limitazioni delle chiamate PSTN
Nome | Scope | Limite |
---|---|---|
Numero predefinito di chiamate simultanee in uscita | per numero | 2 |
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.
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.