Partager via


Limites de service pour Azure Communication Services

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.

  1. Ouvrez le portail Azure et connectez-vous.
  2. Sélectionnez Aide+Support.
  3. Sélectionnez Créer une demande de support.
  4. Dans la zone de texte Décrire votre problème , entrez Technical, puis sélectionnez Go.
  5. Dans le menu déroulant Sélectionner un service , sélectionnez Limites de service et d’abonnement (Quotas), puis sélectionnez Suivant.
  6. 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.
  7. Passez en revue toute solution recommandée, le cas échéant, puis sélectionnez Suivant.
  8. Ajoutez d’autres détails si nécessaire, puis sélectionnez Suivant.
  9. À 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.

  1. Ouvrez le portail Azure et connectez-vous.
  2. Sélectionnez Aide+Support.
  3. Sélectionnez Créer une demande de support.
  4. Dans la zone de texte Décrire votre problème , entrez Technical, puis sélectionnez Go.
  5. Dans le menu déroulant Sélectionner un service , sélectionnez Limites de service et d’abonnement (Quotas), puis sélectionnez Suivant.
  6. 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.
  7. Passez en revue les solutions recommandées, le cas échéant, puis sélectionnez Suivant.
  8. Ajoutez plus de détails en fonction des besoins, puis sélectionnez Suivant.
  9. À 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.

E-mail

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.

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 :

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

Domaines personnalisés

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 :

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.