Limiti del servizio per Servizi di comunicazione di Azure
Questo documento illustra le limitazioni delle API di 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, le procedure illustrate di seguito sono quelle 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 a causa dei limiti di utilizzo.
Per informazioni più generali su come configurare l'architettura del servizio per gestire le limitazioni, vedere la documentazione sull'architettura di Azure per i modelli di limitazione. I limiti possono essere aumentati tramite una richiesta al supporto tecnico di Azure.
- Passare al portale di Azure ed eseguire l'accesso.
- Selezionare Guida e supporto.
- Fare clic su Crea una nuova richiesta di supporto.
- Nella casella di testo Descrivi il problema, immettere
Technicale 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 l'SDK Numeri di telefono 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 sul concetto di tipi di numeri di telefono e la pagina di panoramica sul concetto di telefonia.
I limiti possono essere aumentati tramite una richiesta al supporto tecnico di Azure.
- Passare al portale di Azure ed eseguire l'accesso.
- Selezionare Guida e supporto.
- Fare clic su Crea una nuova richiesta di supporto.
- Nella casella di testo Descrivi il problema, immettere
Technicale 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.
Identità
| Operazione | Intervalli di tempo (secondi) | Limite (numero di richieste) |
|---|---|---|
| Creare l'identità | 30 | 1000 |
| Eliminare l'identità | 30 | 500 |
| Risolvere i problemi dei token di accesso | 30 | 1000 |
| Revocare 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 errore 429. Questo errore indica che si stanno raggiungendo le limitazioni del servizio e i messaggi vengono accodati per l'invio, una volta 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.
È possibile inviare un numero limitato di messaggi di posta elettronica. Se si superano i limiti di frequenza di posta elettronica per la sottoscrizione, le richieste vengono rifiutate. È possibile riprovare a eseguire queste richieste una volta passato il tempo di Retry-After. Intervenire prima di raggiungere il limite richiedendo di aumentare i limiti del volume di invio, se necessario.
Il servizio di posta elettronica Servizi di comunicazione di Azure è progettato per supportare una velocità effettiva elevata. Tuttavia, il servizio impone limiti di velocità iniziali per aiutare i clienti a eseguire l'onboarding senza problemi ed evitare alcuni dei problemi che possono verificarsi quando si passa a un nuovo servizio di posta elettronica.
È consigliabile aumentare gradualmente il volume di posta elettronica usando Servizi di comunicazione di Azure Messaggio di posta elettronica in un periodo da due a quattro settimane, monitorando attentamente lo stato di recapito dei messaggi di posta elettronica. Questo aumento graduale consente ai provider di servizi di posta elettronica di terze parti di adattarsi alla modifica dell'INDIRIZZO IP per il traffico di posta elettronica del dominio. La modifica graduale consente di proteggere la reputazione del mittente e mantenere l'affidabilità del recapito tramite posta elettronica.
Servizi di comunicazione di Azure servizio di posta elettronica supporta un volume elevato fino a 1-2 milioni di messaggi all'ora. La velocità effettiva elevata può essere abilitata in base a diversi fattori, tra cui:
- Picco del traffico dei clienti
- Esigenze aziendali
- Possibilità di gestire i tassi di errore
- Reputazione del dominio
Requisiti relativi alla frequenza degli errori
Per abilitare una quota elevata di posta elettronica, la percentuale di errori di posta elettronica deve essere inferiore all'1% (1%). Se il tasso di errore è elevato, è necessario risolvere i problemi prima di richiedere un aumento della quota. Si prevede che i clienti monitorino attivamente i tassi di errore.
Se il tasso di errore aumenta dopo un aumento della quota, Servizi di comunicazione di Azure contatterà il cliente per un'azione immediata e una sequenza temporale di risoluzione. In casi estremi, se la frequenza di errore non viene gestita all'interno della sequenza temporale specificata, Servizi di comunicazione di Azure può ridurre o sospendere il servizio fino a quando il problema non viene risolto.
Articoli correlati
Servizi di comunicazione di Azure offre log avanzati e analisi per monitorare e gestire i tassi di errore. Per altre informazioni, vedere gli articoli seguenti:
- Migliorare la reputazione del mittente nel messaggio di posta elettronica di Servizi di comunicazione di Azure
- Informazioni dettagliate sulla posta elettronica
- Abilitare i log tramite impostazioni di diagnostica in Monitoraggio di Azure
- Guida introduttiva: Gestire gli eventi di posta elettronica
- Guida introduttiva: Gestire gli elenchi di eliminazione dei domini in Servizi di comunicazione di Azure usando le librerie client di gestione
Nota
Per richiedere limiti più elevati, seguire le istruzioni riportate in Aumento della quota per i domini di posta elettronica. Le quote più elevate sono disponibili solo per i domini personalizzati verificati, non per i domini gestiti da Azure.
Limiti di frequenza per la posta elettronica
| 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 per la posta elettronica
| Nome | Limite |
|---|---|
| Numero di destinatari nel messaggio di posta elettronica | 50 |
| Dimensioni totali della richiesta di posta elettronica (inclusi gli allegati) | 10 MB |
| Numero massimo di connessioni autenticate per sottoscrizione | 250 |
Per tutti i limiti delle dimensioni del messaggio, è necessario considerare che la codifica base64 aumenta le dimensioni del messaggio. È necessario aumentare il valore della dimensione per tenere conto dell'aumento delle dimensioni del messaggio che si verifica dopo che gli allegati del messaggio e tutti gli altri dati binari sono codificati in Base64. La codifica Base64 aumenta le dimensioni del messaggio di circa il 33%, quindi le dimensioni del messaggio sono maggiori del 33% rispetto alle dimensioni del messaggio prima della codifica. Ad esempio, se si specifica un valore massimo di dimensione del messaggio di circa 10 MB, è possibile prevedere un valore di dimensione massima realistica del messaggio di circa 7,5 MB.
Inviare allegati maggiori di 10 MB
Per inviare file di posta elettronica allegati fino a 30 MB, completare una richiesta di supporto.
Se è necessario inviare allegati di file di posta elettronica di dimensioni superiori a 30 MB, è possibile usare questa soluzione alternativa. Archiviare i file in un account di Archiviazione BLOB di Azure e includere un collegamento ai file nel messaggio di posta elettronica. È possibile proteggere i file con una firma di accesso condiviso (SAS). Una firma di accesso condiviso assicura un accesso delegato alle risorse in un account di archiviazione. Usando la firma di accesso condiviso, è possibile controllare in modo granulare il modo in cui i client possono accedere ai dati.
Vantaggi dell'uso di un account di Archiviazione BLOB di Azure:
- È possibile gestire file su larga scala.
- È possibile usare le chiavi di firma di accesso condiviso per gestire con precisione l'accesso ai file.
Per altre informazioni, vedi:
- Introduzione all'Archiviazione BLOB di Azure
- Concedere accesso limitato alle risorse di Archiviazione di Azure tramite firme di accesso condiviso
Azione da eseguire
Per aumentare la quota di posta elettronica, seguire le istruzioni riportate in Aumento della quota per i domini di posta elettronica.
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 per chat
| Nome | Limite |
|---|---|
| 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 di Servizi di comunicazione di Azure per Azure Bot | 1000 |
Limiti di frequenza per chat
| 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 messaggio della chat | per Utente per thread di chat | 50 | - |
| Ottenere messaggio della 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 |
| Ottenere ricevute di lettura (limite di 20 partecipanti*) | per Utente per thread di chat | 5 | - |
| Ottenere 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 | - |
| Inviare messaggio/aggiornare messaggio/eliminare messaggio | per thread di chat | 10 | 30 |
| Inviare ricevuta di lettura | per Utente per thread di chat | 10 | 30 |
| Indicatore di digitazione | per Utente per thread di chat | 5 | 15 |
| 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
Attualmente la funzionalità descritta in questo articolo è 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 l'API Elimina thread di chat. 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 può essere più recuperato e non sono disponibili informazioni su tale thread. Se necessario, aprire un ticket di supporto il più rapidamente possibile entro 30 giorni dopo aver creato un thread in modo da ottenere assistenza.
Chiamate vocali e video
Limitazioni delle chiamate PSTN
| Nome | Scope | Limite |
|---|---|---|
| Numero predefinito di chiamate simultanee* in uscita | per Numero | 2 |
Nota
* 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, che viene esaminato dal team di verifica.
Limitazioni massime delle chiamate
| Nome | Limite |
|---|---|
| Numero di partecipanti | 350 |
Supporto per lo streaming di SDK Calling
Calling SDK dei Servizi di comunicazione 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 | nove video + condivisione di uno schermo | nove video + condivisione di uno schermo |
L'SDK Calling non applica questi limiti, ma gli utenti potrebbero riscontrare una riduzione delle prestazioni se si superano questi limiti.
Timeout di Calling SDK
I timeout seguenti si applicano ai Calling SDK di Servizi di comunicazione:
| Azione | Timeout in secondi |
|---|---|
| Riconnessione/Rimozione di un partecipante | 120 |
| Aggiungere o rimuovere una nuova modalità da una chiamata (avvio/arresto di video o condivisione dello schermo) | 40 |
| Timeout dell'operazione di trasferimento delle chiamate | 60 |
| Timeout di effettuazione di chiamate 1:1 | 85 |
| Timeout di effettuazione di chiamate di gruppo | 85 |
| Timeout di effettuazione di chiamate PSTN | 115 |
| Timeout di promozione di una chiamata 1:1 a una 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 Calling o i problemi noti. È anche possibile inviare una richiesta al supporto tecnico di Azure per aumentare alcuni dei limiti, in attesa di revisione da parte del team di verifica.
Router processo
Quando si invia o si riceve un volume elevato di richieste, è possibile che venga visualizzato un errore ThrottleLimitExceededException. Questo errore indica che si stanno raggiungendo le limitazioni del servizio e le richieste hanno esito negativo 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 del 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, spesso si usano le API 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 risposta Retry-After. Il back-off delle richieste che usano il ritardo Retry-After è 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.
Altre informazioni sui limiti di limitazione di Microsoft Graph sono disponibili nella documentazione di Microsoft Graph.
Passaggi successivi
Vedere le opzioni della Guida e del supporto tecnico.