Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Cet article explique les limitations des API Azure Communication Services et les résolutions possibles.
Modèles de limitation et architecture
Quand vous atteignez les limites du service, vous recevez le code d’état HTTP 429 (trop de requêtes). D’une façon générale, suivez ces meilleures pratiques pour la limitation :
- Réduisez le nombre d’opérations par requête.
- Réduisez la fréquence des appels.
- Évitez les nouvelles tentatives immédiates car toutes les requêtes exécutées sont comptées dans vos limites d’utilisation.
Trouvez des conseils plus généraux sur la façon de configurer votre architecture de service pour gérer le throttling et les limitations dans la documentation sur l’architecture Azure, concernant les modèles de limitation. Pour augmenter les limites de répartition, faites une demande au Support Azure.
- Ouvrez le portail Azure et connectez-vous.
- Sélectionnez Aide+Support.
- Sélectionnez Créer une demande de support.
- Dans la zone de texte Décrire votre problème , entrez Technical, puis sélectionnez Go.
- Dans le menu déroulant Sélectionner un service , sélectionnez Limites de service et d’abonnement (Quotas), puis sélectionnez Suivant.
- Dans la description du problème , choisissez les valeurs du type de problème, de l’abonnement et du type de quota , puis sélectionnez Suivant.
- Passez en revue toute solution recommandée, le cas échéant, puis sélectionnez Suivant.
- Ajoutez d’autres détails si nécessaire, puis sélectionnez Suivant.
- À Vérifier + créer, vérifiez les informations, apportez des modifications en fonction des besoins, puis sélectionnez Créer.
Suivez les étapes pour effectuer une demande au support Azure.
Acquérir les numéros de téléphone
Avant d’acquérir un numéro de téléphone, vérifiez que votre abonnement répond aux exigences géographiques et d’abonnement . Sinon, vous ne pourrez pas acheter un numéro de téléphone. Les limitations suivantes s’appliquent à l'achat de numéros via le Kit de Développement Logiciel (SDK) Numéros de Téléphone et le Portail Azure.
| Opération | Étendue | Délai d’exécution | Limite (nombre de requêtes) |
|---|---|---|---|
| Acheter un numéro de téléphone | Locataire Azure | - | 1 |
| Rechercher des numéros de téléphone | Locataire Azure | Une semaine | 5 |
Action à effectuer
Pour plus d’informations, consultez les types de numéros de téléphone et les concepts de téléphonie.
Pour augmenter les limites d'achat, adressez une requête à Support Azure.
- Ouvrez le portail Azure et connectez-vous.
- Sélectionnez Aide+Support.
- Sélectionnez Créer une demande de support.
- Dans la zone de texte Décrire votre problème , entrez Technical, puis sélectionnez Go.
- Dans le menu déroulant Sélectionner un service , sélectionnez Limites de service et d’abonnement (Quotas), puis sélectionnez Suivant.
- Dans la description du problème , choisissez les valeurs du type de problème, de l’abonnement et du type de quota , puis sélectionnez Suivant.
- Passez en revue les solutions recommandées, le cas échéant, puis sélectionnez Suivant.
- Ajoutez plus de détails en fonction des besoins, puis sélectionnez Suivant.
- À Vérifier + créer , vérifiez les informations, apportez des modifications en fonction des besoins, puis sélectionnez Créer.
Identité
| Opération | Délais (secondes) | Limite (nombre de requêtes) |
|---|---|---|
| Créer une identité | 30 | 1 000 |
| Supprimer une identité | 30 | 500 |
| Émettre des jetons d’accès | 30 | 1 000 |
| Révoquer des jetons d’accès | 30 | 500 |
createUserAndToken |
30 | 1 000 |
exchangeTokens |
30 | 500 |
Action à effectuer
Nous vous recommandons d’acquérir des identités et des jetons avant de créer des threads de conversation ou de démarrer des appels. Par exemple, effectuez cette tâche lorsque la page web se charge ou que l’application démarre.
Pour plus d’informations, consultez S’authentifier auprès d’Azure Communication Services.
sms
Lorsque vous envoyez ou recevez un grand nombre de messages, il se peut que vous receviez 429 erreur. Cette erreur indique que vous êtes sur le point d’atteindre les limitations du service. Vos messages sont mis en file d’attente et sont envoyés une fois que le nombre de requête est inférieur au seuil.
Limites de débit pour SMS :
| Opération | Type de numéro | Étendue | Délais | Limite (Demander le numéro) | Unités de message par minute |
|---|---|---|---|---|---|
| Envoyer un message | Numéro gratuit | Par numéro | soixante | 200 | 200 |
| Envoyer un message | Code court | Par numéro | soixante | 6 000 | 6 000 |
| Envoyer un message | ID d’expéditeur alphanumérique | Par ressource | soixante | 600 | 600 |
Action à effectuer
Si vous avez des exigences qui dépassent les limites de débit, envoyez une demande au support Azure pour activer un débit plus élevé.
Pour plus d’informations sur le Kit de développement logiciel (SDK) et le service SMS, consultez la vue d’ensemble du Kit de développement logiciel (SDK) SMS ou le FAQ sur SMS.
Vous pouvez envoyer un nombre limité d’e-mails. Si vous dépassez les limites de débit de messagerie pour votre abonnement, vos demandes sont rejetées. Vous pouvez effectuer une nouvelle tentative pour ces requêtes après la fin du délai Retry-After. Prenez des mesures avant d’atteindre la limite en demandant si nécessaire une augmentation de vos limites de volume d’envois.
Le service d’hébergement de courrier Azure Communication Services est conçu pour prendre en charge un débit élevé. Toutefois, le service impose les limites de débit initiales pour aider les clients à effectuer une intégration en douceur et à éviter certains problèmes qui peuvent se produire lorsqu’ils passent à un nouveau service d’hébergement de courrier.
Nous vous recommandons d’augmenter progressivement votre volume d’e-mails en utilisant Email Azure Communication Services pendant deux à quatre semaines, tout en surveillant de près l’état de remise de vos e-mails. Cette augmentation progressive permet aux fournisseurs de service d’hébergement de courrier tiers de s’adapter au changement d’adresse IP pour le trafic d’e-mails de votre domaine. Le changement progressif vous donne le temps de protéger votre réputation d’expéditeur et de maintenir la fiabilité de la livraison de vos e-mails.
Le service de messagerie Azure Communication Services prend en charge un volume élevé allant jusqu’à 1 à 2 millions de messages par heure. Un débit élevé peut être activé en fonction de plusieurs facteurs, notamment :
- Pic de trafic client
- Besoins de l'entreprise
- Capacité à gérer les taux d'échec
- Réputation de domaine
Exigences relatives au taux d'échec
Pour activer un quota de courrier électronique élevé, votre taux d'échec de courrier électronique doit être inférieur à un pour cent (1 %). Si votre taux d’échec est élevé, vous devez résoudre les problèmes avant de demander une augmentation de quota. Les clients sont censés surveiller activement leurs taux d’échec.
Si le taux d’échec augmente après une augmentation de quota, Azure Communication Services contactera le client pour une action immédiate et un calendrier de résolution. Dans les cas extrêmes, si le taux d’échec n’est pas géré dans le délai spécifié, Azure Communication Services peut réduire ou suspendre le service jusqu’à ce que le problème soit résolu.
Articles connexes
Azure Communication Services fournit des journaux et des analyses riches pour aider à surveiller et à gérer les taux d’échec. Pour plus d’informations, consultez les articles suivants :
- Améliorez la réputation de l’expéditeur dans l’e-mail Azure Communication Services.
- Aperçus par e-mail.
- Activez les journaux d’activité via les paramètres de diagnostic dans Azure Monitor.
- Gérer les événements e-mail.
- Gérez les listes de suppression de domaine dans Azure Communication Services à l’aide des bibliothèques clientes de gestion.
Remarque
Pour demander des limites plus élevées, suivez les instructions de l’augmentation du quota pour les domaines de messagerie. Les quotas supérieurs sont disponibles uniquement pour les domaines personnalisés vérifiés, pas pour les domaines managés par Azure.
Limites de débit pour le courrier électronique
| Opération | Étendue | Délai d’exécution (minutes) | Limite (nombre d’e-mails) | Limites plus élevées disponibles |
|---|---|---|---|---|
| Envoyer un courrier électronique | Par abonnement | 1 | 30 | Oui |
| Envoyer un courrier électronique | Par abonnement | soixante | 100 | Oui |
| Obtenir l’état des e-mails | Par abonnement | 1 | soixante | Oui |
| Obtenir l’état des e-mails | Par abonnement | soixante | 200 | Oui |
Le tableau suivant répertorie les limites des domaines managés Azure.
| Opération | Étendue | Délai d’exécution (minutes) | Limite (nombre d’e-mails) | Limites plus élevées disponibles |
|---|---|---|---|---|
| Envoyer un courrier électronique | Par abonnement | 1 | 5 | Non |
| Envoyer un courrier électronique | Par abonnement | soixante | 10 | Non |
| Obtenir l’état des e-mails | Par abonnement | 1 | 10 | Non |
| Obtenir l’état des e-mails | Par abonnement | soixante | 20 | Non |
Limites de taille pour les e-mails
| Nom | Limite |
|---|---|
| Nombre de destinataires dans l’e-mail | 50 |
| Taille totale des demandes d’e-mail (pièces jointes comprises) | 10 Mo |
| Nombre maximal de connexions authentifiées par abonnement | 250 |
Pour toutes les limites de taille des messages, il faut tenir compte du fait que le codage Base64 augmente la taille du message. Vous devez augmenter la valeur de taille pour tenir compte de l’augmentation de la taille du message qui se produit après les pièces jointes du message et toutes les autres données binaires encodées en Base64. L’encodage en base64 augmente la taille du message d’environ 33 %, de sorte que la taille du message est d’environ 33 % supérieure à la taille du message avant l’encodage. Par exemple, si vous spécifiez une valeur maximale de taille de message d’environ 10 Mo, vous pouvez vous attendre à une valeur de taille maximale de message réaliste d’environ 7,5 Mo.
Limites des ressources
| Nom | Limite |
|---|---|
| Ressource SenderUsername/Mailfrom par domaine | 100 |
| Domaines liés à une ressource Communication Service | 100 |
Envoyer des pièces jointes supérieures à 10 Mo
Pour envoyer des pièces jointes à un fichier électronique jusqu’à 30 Mo, effectuez une demande de support.
Si vous devez envoyer des pièces jointes à un e-mail qui sont des fichiers d’une taille supérieure à 30 Mo, utilisez cette solution alternative. Stockez les fichiers dans un compte Stockage Blob Azure et incluez dans votre e-mail un lien vers les fichiers. Vous pouvez sécuriser les fichiers avec une signature d’accès partagé (SAP). Une signature d’accès partagé (SAS) fournit un accès délégué et sécurisé aux ressources incluses dans le compte de stockage. Avec une SAP, vous avez un contrôle granulaire sur la façon dont des clients peuvent accéder à vos données.
Avantages de l’utilisation d’un compte Stockage Blob :
- Vous pouvez gérer des fichiers à grande échelle.
- Vous pouvez utiliser des clés iou un SAP pour gérer de façon précise l’accès aux fichiers.
Pour plus d’informations, consultez l’article suivant :
- Introduction à Azure Blob Storage
- Accorder un accès limité aux ressources stockage Azure à l’aide de signatures d’accès partagé
Envoyer un e-mail à plus de 50 destinataires
Si vous souhaitez envoyer des e-mails à plus de 50 destinataires, effectuez une demande de support. Toutefois, l’envoi d’e-mails via SMTP à plus de 50 destinataires n’est pas pris en charge.
Action à effectuer
Pour augmenter votre quota de courrier électronique, suivez les instructions de l’augmentation du quota pour les domaines de messagerie.
Remarque
L'évaluation et l'approbation des demandes d'augmentation des quotas par e-mail peuvent prendre jusqu'à 72 heures, en particulier pour les requêtes reçues le vendredi après-midi. Les demandes d’augmentation de quota pour le nombre de destinataires dans l’e-mail smtp ne sont pas prises en charge pour l’instant.
Conversation
Azure Communication Services prend en charge la conversation.
Limites de taille pour le chat
| Nom | Limite |
|---|---|
| Nombre de participants dans le thread | 250 |
Groupe de participants : CreateThread |
200 |
Groupe de participants : AddParticipant |
200 |
Taille de page : ListMessages |
200 |
| Taille des messages | 28 Ko |
| Nombre de ressources Azure Communication Services par Azure Bot Service | 1 000 |
Limites de débit pour la conversation
| Opération | Étendue | Limite par 10 secondes | Limite par minute |
|---|---|---|---|
| Créer un fil de conversation | Par utilisateur | 10 | - |
| Créer un fil de conversation | Par ressource | - | 3000 |
| Supprimer un fil de conversation | Par utilisateur | 10 | - |
| Mettre à jour un fil de conversation | Par thread de conversation | 5 | - |
| Ajouter des participants ou supprimer des participants | Par thread de conversation | 10 | 30 |
| Ajouter des participants | Par ressource | - | 3000 |
| Obtenir le fil de conversation ou lister les fils de conversation | Par utilisateur | 50 | - |
| Recevoir un message de conversation | Par utilisateur, par fil de discussion | 50 | - |
| Recevoir un message de conversation | Par thread de conversation | 250 | - |
| Lister les messages de conversation | Par utilisateur, par fil de discussion | 50 | 200 |
| Lister les messages de conversation | Par thread de conversation | 250 | 400 |
| Obtenir des confirmations de lecture (limite de 20 participants) | Par utilisateur, par fil de discussion | 5 | - |
| Obtenir des confirmations de lecture (limite de 20 participants) | Par thread de conversation | 100 | - |
| Répertorier les participants d’un fil de conversation | Par utilisateur, par fil de discussion | 10 | - |
| Répertorier les participants d’un fil de conversation | Par thread de conversation | 250 | - |
| Envoyer un message/mettre à jour un message ou supprimer un message | Par thread de conversation | 10 | 30 |
| Envoyer une confirmation de lecture | Par utilisateur, par fil de discussion | 10 | 30 |
| Envoyer un indicateur de saisie | Par utilisateur, par fil de discussion | 5 | 15 |
| Envoyer un indicateur de saisie | Par thread de conversation | 10 | 30 |
Remarque
Les confirmations de lecture et les indicateurs de saisie ne sont pas pris en charge sur les threads de conversation ayant plus de 20 participants.
Stockage de conversation
Azure Communication Services stocke les messages de conversation en fonction de la stratégie de rétention que vous définissez quand vous créez une conversation.
Vous pouvez choisir entre la rétention de messages indéfinie ou la suppression automatique entre 30 et 90 jours via la stratégie de rétention sur l’API Créer un fil de conversation. Vous pouvez également choisir de ne pas définir de stratégie de rétention pour une conversation.
Si vous avez des besoins de conformité stricts, nous vous recommandons d’utiliser l’API Supprimer le fil de conversation pour supprimer les threads de conversation. Les conversations créées avant la nouvelle stratégie de rétention ne sont pas affectées, sauf si vous changez spécifiquement la stratégie pour ces conversations.
Remarque
Si vous supprimez accidentellement des messages, le système ne peut pas les récupérer. Si vous envoyez une requête de support pour une discussion supprimée après que la politique de rétention ait supprimé le thread, celui-ci ne peut pas être récupéré. Les informations relatives à ce thread ne sont plus disponibles. Si nécessaire, ouvrez un ticket de support le plus rapidement possible dans un délai de 30 jours après la création d’une conversation pour que nous puissions vous aider.
Appel vocal et appel vidéo
Azure Communication Services prend en charge les appels vocaux et vidéo.
Limitations des appels RTC
| Nom | Étendue | Limite |
|---|---|---|
| Nombre d’appels sortants simultanés par défaut | Par numéro | 2 |
Remarque
Il n'y a pas de limites aux appels simultanés entrants. Vous pouvez également envoyer une demande au support Azure pour augmenter la limite des appels simultanés sortants. Notre équipe de vérification examine toutes les requêtes.
Limitation du nombre maximal d’appels
| Nom | Limite |
|---|---|
| Nombre de participants | 350 |
Prise en charge du streaming du Kit de développement logiciel (SDK) Appel
Le SDK d'Appel des services de communication d'Azure prend en charge les configurations de streaming suivantes :
| Limite | Le Web | Windows/Android/iOS |
|---|---|---|
| Nombre maximum de flux locaux sortants que vous pouvez envoyer simultanément. | Une vidéo ou un partage d’écran | Une vidéo + un partage d’écran |
| Nombre maximum de flux distants entrants que vous pouvez rendre simultanément. | 9 vidéos + un partage d’écran | 9 vidéos + un partage d’écran |
Le SDK d'appel n'applique pas ces limites, mais vos utilisateurs pourraient connaître une dégradation des performances si ces limites sont dépassées.
Délais d’expiration du Kit de développement logiciel (SDK) Appel
Les délais d’attente suivants s’appliquent aux SDK d'appel Azure Communication Services :
| Action | Délai d’expiration en secondes |
|---|---|
| Reconnecter ou supprimer un(e) participant(e). | 120 |
| Ajoutez ou supprimez une nouvelle modalité d’un appel. (Démarrer ou arrêter le partage vidéo ou d’écran.) | 40 |
| Délai d’expiration des opérations de transfert d’appel. | soixante |
| Délai d’expiration de l’établissement d’un appel en tête-à-tête (1:1). | 85 % |
| Délai d’expiration de l’établissement d’un appel de groupe. | 85 % |
| Délai d’expiration de l’établissement d’un appel RTC. | 115 |
| Délai d’expiration de la promotion d’un appel en tête-à-tête (1:1) en appel de groupe. | 115 |
Salles virtuelles
Les stratégies de limitation du service salles sont déterminées par le regroupement des demandes par le biais de l’ID de la ressource.
| API (Interface de Programmation d'Applications) | Seuil |
|---|---|
| Créer une salle | 20 req/sec |
| Mettre à jour la salle | 20 req/sec |
| Supprimer une salle | 20 req/sec |
| Obtenir une chambre | 40 requêtes/sec |
| Lister les salles | 10 req/sec |
| Mettre à jour le participant | 20 req/sec |
| Lister les participants | 40 requêtes/sec |
Action à effectuer
Pour plus d'informations sur le SDK et le service d'appel vocal et vidéo, consultez l'aperçu du SDK d'appel ou les problèmes connus des SDK et des API. Vous pouvez également envoyer une demande au support Azure pour augmenter certaines des limites. Notre équipe de vérification examine toutes les requêtes.
Routeur de tâches
Lorsque vous envoyez ou recevez un grand nombre de requêtes, il se peut que vous receviez ThrottleLimitExceededException erreur. Cette erreur indique que vous atteignez les limites du service. Vos requêtes échouent jusqu’à ce que le compartiment de jetons utilisé pour gérer les requêtes soit réapprovisionné après un certain temps.
Limites de débit pour le Routeur de tâches
| Opération | Étendue | Délai d’exécution (secondes) | Limite (nombre de requêtes) | Délai d’expiration en secondes |
|---|---|---|---|---|
| Requêtes générales | Par ressource | 10 | 3 000 | 5 |
| Obtenir des jobs (limitation de niveau de route) | Par ressource | 10 | 332 | 5 |
| Obtenir les statistiques de file d’attente (limitation au niveau de la route) | Par ressource | 10 | 166 | 5 |
| Obtenir la position en file d'attente (limitation au niveau de la route) | Par ressource | 10 | 166 | 5 |
| Obtenir des workers (limitation au niveau de la route) | Par ressource | 10 | 332 | 5 |
Action à effectuer
Si vous devez envoyer un volume de messages qui dépasse les limites de débit. envoyez-nous un e-mail à l’adresse acs-ccap@microsoft.com.
L'interopérabilité de Microsoft Teams et Microsoft Graph
En utilisant un scénario d’interopérabilité Teams, vous utilisez probablement certaines API Microsoft Graph pour créer des réunions.
Chaque service proposé via Microsoft Graph présente des limitations différentes. Les limites spécifiques au service sont décrites plus en détail sur cette page web .
Action à effectuer
Lorsque vous implémentez la gestion des erreurs, utilisez le code d'erreur HTTP 429 pour détecter le throttling. La réponse ayant échoué comprend l’en-tête de réponse Retry-After. Utilisez le délai Retry-After pour désactiver les requêtes. C’est la méthode la plus rapide pour se rétablir après un ralentissement, car Microsoft Graph continue de consigner l’utilisation des ressources pendant qu’un client est ralenti.
Vous trouverez plus d’informations sur les limites de limitationde Microsoft Graph dans la documentation Microsoft Graph.