Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Questo articolo 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, seguire queste procedure consigliate per la limitazione delle richieste:
- Ridurre il numero di operazioni per ogni richiesta.
- Ridurre la frequenza delle chiamate.
- Evitare richieste immediate perché tutte le richieste incidono sui limiti di utilizzo.
Trova ulteriori indicazioni generali su come configurare l'architettura del servizio per gestire il throttling e le restrizioni nella documentazione sull'architettura di Azure per i modelli di throttling. Per aumentare i limiti di limitazione, effettuare una richiesta al supporto tecnico di Azure.
- Passare al portale di Azure ed eseguire l'accesso.
- Selezionare Guida e supporto.
- Selezionare Crea nuova richiesta di supporto.
- Nella casella di testo Describe your issue (Descrivere il problema) immettere Technical (Tecnico) e quindi selezionare Go (Vai).
- Dal menu a discesa Seleziona un servizio selezionare Limiti servizio e sottoscrizione (quote) e quindi selezionare Avanti.
- Nella descrizione del problema scegliere i valori Tipo di problema, Sottoscrizione e Tipo di quota e quindi selezionare Avanti.
- Esaminare qualsiasi soluzione consigliata, se disponibile, e quindi selezionare Avanti.
- Aggiungere altri dettagli in base alle esigenze e quindi selezionare Avanti.
- In Rivedi e crea controllare le informazioni, apportare modifiche in base alle esigenze e quindi selezionare Crea.
Seguire la procedura per effettuare una richiesta al supporto tecnico di Azure.
Acquisire 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 seguenti limitazioni si applicano all'acquisto di numeri tramite il Phone 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 Tipi di numeri di telefono e concetti di telefonia.
Per aumentare i limiti di acquisto numerici, effettuare una richiesta al supporto tecnico di Azure.
- Passare al portale di Azure ed eseguire l'accesso.
- Selezionare Guida e supporto.
- Selezionare Crea nuova richiesta di supporto.
- Nella casella di testo Describe your issue (Descrivere il problema) immettere Technical (Tecnico) e quindi selezionare Go (Vai).
- Dal menu a discesa Seleziona un servizio selezionare Limiti servizio e sottoscrizione (quote) e quindi selezionare Avanti.
- Nella descrizione del problema scegliere i valori Tipo di problema, Sottoscrizione e Tipo di quota e quindi selezionare Avanti.
- Esaminare le soluzioni consigliate, se disponibili e quindi selezionare Avanti.
- Aggiungere altri dettagli in base alle esigenze e quindi selezionare Avanti.
- In Rivedi e crea controllare le informazioni, apportare modifiche in base alle esigenze e quindi selezionare Crea.
Identità
Operazione | Intervalli di tempo (secondi) | Limite (numero di richieste) |
---|---|---|
Creare l'identità | 30 | 1.000 |
Eliminare l'identità | 30 | 500 |
Emettere un token di accesso | 30 | 1.000 |
Revocare token di accesso | 30 | 500 |
createUserAndToken |
30 | 1.000 |
exchangeTokens |
30 | 500 |
Azione da eseguire
È consigliabile acquisire identità e token prima di creare thread di chat o avviare chiamate. Ad esempio, eseguire questa attività all'avvio della pagina Web o all'avvio dell'applicazione.
Per altre informazioni, vedere Eseguire l'autenticazione a Servizi di comunicazione di Azure.
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 per raggiungere le limitazioni del servizio. I messaggi vengono accodati e inviati dopo che il numero di richieste è inferiore alla soglia.
Limiti di frequenza per SMS:
Operazione | Tipo di numero | Ambito | Intervalli di tempo | Limite (numero richiesta) | Unità messaggio al minuto |
---|---|---|---|---|---|
Invia messaggio | Numero verde | Per numero | 60 | 200 | 200 |
Invia messaggio | Codice breve | Per numero | 60 | 6.000 | 6.000 |
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 servizio, vedere Panoramica di SMS SDK o domande frequenti su SMS.
Posta elettronica
È 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, i Servizi di Comunicazione di Azure contatteranno il cliente per intraprendere un'azione immediata e definire le tempistiche 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 nella posta elettronica di Servizi di comunicazione di Azure.
- Informazioni dettagliate sulla posta elettronica.
- Abilitare i log tramite impostazioni di diagnostica in Monitoraggio di Azure.
- Gestire gli eventi di posta elettronica.
- 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) | Limiti più elevati disponibili |
---|---|---|---|---|
Invia messaggio e-mail | Per sottoscrizione | 1 | 30 | Sì |
Invia messaggio e-mail | Per sottoscrizione | 60 | 100 | Sì |
Ottenere lo stato della posta elettronica | Per sottoscrizione | 1 | 60 | Sì |
Ottenere lo stato della posta elettronica | Per sottoscrizione | 60 | 200 | Sì |
La tabella seguente elenca i limiti per i domini gestiti di Azure.
Operazione | Ambito | Intervallo di tempo (minuti) | Limite (numero di messaggi di posta elettronica) | Limiti più elevati disponibili |
---|---|---|---|---|
Invia messaggio e-mail | Per sottoscrizione | 1 | 5 | NO |
Invia messaggio e-mail | Per sottoscrizione | 60 | 10 | NO |
Ottenere lo stato della posta elettronica | Per sottoscrizione | 1 | 10 | NO |
Ottenere lo stato della posta elettronica | Per sottoscrizione | 60 | 20 | NO |
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 dei messaggi, 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.
Limiti delle risorse
Nome | Limite |
---|---|
Risorsa SenderUsername/Mailfrom per dominio | 100 |
Domini collegati a una risorsa del servizio di comunicazione | 100 |
Inviare allegati maggiori di 10 MB
Per inviare allegati di file di posta elettronica fino a 30 MB, effettuare una richiesta di supporto.
Se è necessario inviare allegati di file di posta elettronica di dimensioni superiori a 30 MB, 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.You can secure the files with a shared access signature (SAS). Una SAS fornisce un accesso delegato sicuro alle risorse nel tuo account di archiviazione. L'utilizzo di una firma di accesso condiviso permette di controllare in modo granulare il modo in cui i client possono accedere ai dati.
Vantaggi dell'uso di un account di archiviazione BLOB:
- È possibile gestire file su larga scala.
- È possibile usare una firma di accesso condiviso o chiavi per gestire con precisione l'accesso ai file.
Per altre informazioni, vedi:
- Introduzione all'archiviazione blob di Azure
- Concedere l'accesso limitato alle risorse Archiviazione di Azure usando 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 potrebbero richiedere fino a 72 ore per la valutazione e l'approvazione, in particolare per le richieste che arrivano il venerdì pomeriggio. Al momento, le richieste di aumento della quota per il numero di destinatari nella posta elettronica di SMTP non sono supportate.
Conversazione
Servizi di comunicazione di Azure supporta chat.
Limiti di dimensioni per la chat
Nome | Limite |
---|---|
Numero di partecipanti nel thread | 250 |
Gruppo di partecipanti: CreateThread |
200 |
Gruppo di partecipanti: AddParticipant |
200 |
Dimensioni pagina: ListMessages |
200 |
Dimensione del messaggio | 28 kB |
Numero di risorse dei Servizi di comunicazione di Azure per Servizio bot di Azure | 1.000 |
Limiti di frequenza per la chat
Operazione | Ambito | 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 o 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 un messaggio, aggiornare un messaggio o eliminare un messaggio | Per thread di chat | 10 | 30 |
Inviare una ricevuta di lettura | Per utente, per thread di chat | 10 | 30 |
Invia l'indicatore di digitazione | Per utente, per thread di chat | 5 | 15 |
Invia l'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
Questa funzionalità di Servizi di comunicazione di Azure è attualmente in anteprima. Le funzionalità in anteprima sono disponibili pubblicamente e possono essere usate da tutti i clienti Microsoft nuovi ed esistenti.
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 essere vincolate.
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 usare l'API Elimina thread chat per eliminare i thread di chat. Tutti i thread creati prima dei nuovi criteri di conservazione non sono interessati, a meno che non si modifichino in modo specifico i criteri per quel thread.
Nota
Se si eliminano accidentalmente messaggi, il sistema non può recuperarli. Se si invia una richiesta di supporto per un thread di chat eliminato dopo che i criteri di conservazione eliminano tale thread, non è possibile recuperarlo. Le informazioni su tale thread non sono più disponibili. 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 che sia possibile assistervi.
Chiamate vocali e video
Servizi di comunicazione di Azure supporta chiamate vocali e videochiamate.
Limitazioni delle chiamate PSTN
Nome | Ambito | Limite |
---|---|---|
Numero predefinito di chiamate simultanee in uscita | Per numero | 2 |
Nota
Non esistono limiti alle chiamate simultanee in ingresso. È anche possibile inviare una richiesta al supporto tecnico di Azure per aumentare il limite per le chiamate simultanee in uscita. Il nostro team di controllo esamina tutte le richieste.
Limitazioni massime delle chiamate
Nome | Limite |
---|---|
Numero di partecipanti | 350 |
Supporto allo streaming per il Calling SDK
Calling SDK dei Servizi di comunicazione di Azure supporta le configurazioni di streaming seguenti:
Limite | Rete Internet | 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 che è possibile eseguire 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 SDK Chiamata
I timeout seguenti si applicano agli SDK per chiamate Servizi di comunicazione di Azure:
Azione | Timeout in secondi |
---|---|
Riconnettere o rimuovere un partecipante. | 120 |
Aggiungere o rimuovere una nuova modalità da una chiamata. (Avviare o arrestare la condivisione di video o schermate). | 40 |
Timeout dell'operazione di trasferimento delle chiamate. | 60 |
Timeout di esecuzione chiamate 1:1. | 85 |
Timeout di esecuzione chiamate di gruppo. | 85 |
Timeout di esecuzione chiamate PSTN. | 115 |
Timeout di promozione di una chiamata 1:1 a una chiamata di gruppo. | 115 |
Stanze virtuali
I criteri di limitazione del servizio delle stanze sono determinati raggruppando le richieste tramite ID risorsa.
API (Interfaccia di Programmazione delle Applicazioni) | Soglia |
---|---|
Crea stanza | 20 richieste/secondo |
Aggiornare la sala | 20 richieste/secondo |
Elimina stanza | 20 richieste/secondo |
Ottieni una stanza | 40 richieste/sec |
Elenco delle Stanze | 10 richieste/sec |
Aggiornare il partecipante | 20 richieste/secondo |
Elencare i partecipanti | 40 richieste/sec |
Azione da eseguire
Per ulteriori informazioni sull'SDK per chiamate vocali e video e sul servizio, vedere Panoramica delle SDK per chiamate o Problemi noti negli SDK e nelle API. È anche possibile inviare una richiesta al supporto tecnico di Azure per aumentare alcuni dei limiti. Il nostro team di controllo esamina tutte le richieste.
Router processi
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. Le richieste hanno esito negativo fino a quando il bucket di token usato per gestire le richieste viene rifornito dopo un determinato periodo di tempo.
Limiti di frequenza per il router processi
Operazione | Ambito | Intervallo di tempo (secondi) | Limite (numero di richieste) | Timeout in secondi |
---|---|---|---|---|
Richieste generali | Per risorsa | 10 | 1.000 | 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 in questa pagina Web 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
. Utilizzare il ritardo Retry-After
per eseguire l’interruzione temporanea delle richieste. È il modo più rapido per riprendersi dalla limitazione delle richieste perché Microsoft Graph continua a registrare l'utilizzo delle risorse mentre la limitazione delle richieste client è attiva.
Altre informazioni sui limiti di limitazione di Microsoft Graph sono disponibili nella documentazione di Microsoft Graph.