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). En général, les meilleures pratiques suivantes sont utilisées pour l'étranglement :
- 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 plus d’informations générales sur la façon de configurer votre architecture de service pour gérer la restriction et les limitations dans la documentation de l’Architecture Azure pour les modèles de limitation. Pour augmenter les limites de limitation de requêtes, vous devez envoyer une requête au Support Azure.
- Ouvrez le portail Azure et connectez-vous.
- Sélectionnez Aide et support.
- Sélectionnez Créer une requête de support.
- Dans la zone de texte Décrivez votre problème, entrez Technique, puis sélectionnez Aller.
- Dans le menu déroulant Sélectionner un service, sélectionnez Limites du service et de l’abonnement (quotas), puis sélectionnez Suivant.
- Dans la description du problème, sélectionnez les valeurs Type de problème, Abonnement et Type de quota, puis sélectionnez Suivant.
- Examinez les solutions recommandées, le cas échéant, puis sélectionnez Suivant.
- Ajoutez d'autres détails si nécessaire, puis sélectionnez Suivant.
- Dans Vérifier + créer, vérifiez les informations, apportez des changements selon les besoins, puis sélectionnez Créer.
Suivez les étapes pour effectuer une requête au support Azure.
Acquérir les numéros de téléphone
Avant d’acquérir un numéro de téléphone, assurez-vous que votre abonnement répond aux exigences d’abonnement et de géographie. 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, voir Types de numéros de téléphone et 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 et support.
- Sélectionnez Créer une requête de support.
- Dans la zone de texte Décrivez votre problème, entrez Technique, puis sélectionnez Aller.
- Dans le menu déroulant Sélectionner un service, sélectionnez Limites du service et de l’abonnement (quotas), puis sélectionnez Suivant.
- Dans la description du problème, sélectionnez les valeurs Type de problème, Abonnement et Type de quota, puis sélectionnez Suivant.
- Examinez les solutions recommandées, le cas échéant, puis sélectionnez Suivant.
- Ajoutez d'autres détails si nécessaire, puis sélectionnez Suivant.
- Dans Vérifier + créer, vérifiez les informations, apportez des changements selon les 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 Authentifier à 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 nombre | Étendue | Délais | Limite (Demander le numéro) | Unités de message par minute |
|---|---|---|---|---|---|
| Envoyer un message | Numéro gratuit | Par nombre | 60 | 200 | 200 |
| Envoyer un message | Code court | Par nombre | 60 | 6000 | 6000 |
| Envoyer un message | ID d’expéditeur alphanumérique | Par ressource | 60 | 600 | 600 |
Action à effectuer
Si vous avez des besoins qui dépassent les limites de transfert, envoyez une requête à Support Azure pour autoriser un débit plus élevé.
Pour plus d’informations sur le kit de développement logiciel (SDK) et le service SMS, consultez Vue d’ensemble du SDK SMS ou FAQ SMS.
Vous pouvez envoyer un nombre limité d’e-mails. Si vous dépassez les limites suivantes pour votre abonnement, vos requêtes 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. Demandez à augmenter vos limites de volume d'envoi, si nécessaire.
Le service d’hébergement de courrier Azure Communication Services est conçu pour prendre en charge un débit élevé. 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’utiliser la messagerie Azure Communication Services sur une période de deux à quatre semaines pour augmenter progressivement votre volume d’e-mails. Pendant ce temps, surveillez étroitement 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.
Limites de débit pour l’e-mail
Nous approuvons des limites plus élevées pour les clients en fonction des conditions des cas d’usage, de la réputation du domaine, des modèles de trafic et des taux d’échec. Pour demander des limites plus élevées, suivez les instructions dans Augmentation du quota pour les domaines de messagerie. Des quotas plus élevés ne sont disponibles que pour les domaines personnalisés vérifiés, et non pour les domaines managés par Azure.
Le tableau suivant répertorie les limites de domaines personnalisés.
| Opération | Étendue | Délai d’exécution (minutes) | Limite (nombre d’e-mails) |
|---|---|---|---|
| Envoyer un e-mail | Par abonnement | 1 | 30 |
| Envoyer un e-mail | Par abonnement | 60 | 100 |
| Obtenir l’état de l’e-mail | Par abonnement | 1 | 60 |
| Obtenir l’état de l’e-mail | Par abonnement | 60 | 200 |
Le tableau suivant répertorie les limites des domaines managés par Azure.
| Opération | Étendue | Délai d’exécution (minutes) | Limite (nombre d’e-mails) |
|---|---|---|---|
| Envoyer un e-mail | Par abonnement | 1 | 5 |
| Envoyer un e-mail | Par abonnement | 60 | 10 |
| Obtenir l’état de l’e-mail | Par abonnement | 1 | 10 |
| Obtenir l’état de l’e-mail | Par abonnement | 60 | 20 |
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.
Envoyer des pièces jointes supérieures à 10 Mo
Pour envoyer des pièces jointes à un e-mail qui sont des fichiers d’une taille allant jusqu’à 30 Mo, effectuez une requête 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 :
- Présentation de Stockage Blob Azure
- Accorder un accès limité aux ressources Stockage Azure à l’aide des signatures d’accès partagé (SAP)
Action à effectuer
Pour augmenter votre quota d’e-mails, suivez les instructions de Augmentation du quota pour les domaines d’e-mail.
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.
Conversation instantanée
Azure Communication Services prend en charge la conversation.
Limites de taille pour le chat
| Nom | Limite |
|---|---|
| Nombre de participants dans le thread | 250 |
Lot des participants : CreateThread |
200 |
Lot des 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 | - |
| 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 |
| Obtenir le fil de conversation ou répertorier les fils de conversation | Par utilisateur | 50 | - |
| Recevoir un message de conversation | Par Utilisateur(-trice) par thread de conversation | 50 | - |
| Recevoir un message de conversation | Par Thread de conversation | 250 | - |
| Lister les messages de conversation | Par Utilisateur(-trice) par thread de conversation | 50 | 200 |
| Lister les messages de conversation | Par Thread de conversation | 250 | 400 |
| Obtenir des confirmations de lecture (limite de 20 participants) | Par Utilisateur(-trice) par thread de conversation | 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(-trice) par thread de conversation | 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(-trice) par thread de conversation | 10 | 30 |
| Envoyer un indicateur de saisie | Par Utilisateur(-trice) par thread de conversation | 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.
Important
Les fonctionnalités décrites dans cet article sont actuellement en préversion publique. Cette préversion est fournie sans contrat de niveau de service et n’est pas recommandée pour les charges de travail de production. Certaines fonctionnalités peuvent être limitées ou non prises en charge. Pour plus d’informations, consultez Conditions d’Utilisation Supplémentaires relatives aux Évaluations Microsoft Azure.
Vous pouvez choisir entre la rétention indéfinie des messages ou leur suppression automatique après une période comprise entre 30 et 90 jours via la stratégie de rétention de l’API de création de conversation. Vous pouvez également choisir de ne pas définir de stratégie de rétention pour une conversation.
Si vous avez des exigences strictes en matière de conformité, nous vous recommandons d'utiliser l'API Supprimer le thread de conversation pour supprimer les fils de discussion. 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 un thread de conversation supprimé après la suppression de cette stratégie de rétention, elle ne peut pas être récupérée. 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 d’appel RTC
| Nom | Étendue | Limite |
|---|---|---|
| Nombre d’appels sortants simultanés par défaut | Par nombre | 2 |
Remarque
Il n'y a pas de limites aux appels simultanés entrants. Vous pouvez également demander à Support Azure d'augmenter la limite des appels sortants simultanés. 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 SDK Appel
Le kit SDK Appel Azure Communication Services prend en charge les configurations de streaming suivantes :
| Limite | 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 Kit de développement logiciel (SDK) Appel n’applique pas ces limites, mais vos utilisateurs peuvent subir une détérioration des performances si vous les dépassez.
Délais d’attente du kit SDK Appel
Les délais d’attente suivants s’appliquent aux kits SDK Appel Azure Communication Services :
| Action | Délai d’attente 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’attente de l’opération de transfert d’appel. | 60 |
| Un délai d’établissement de l’appel en tête-à-tête. | 85 % |
| Délai d’établissement de l’appel de groupe. | 85 % |
| Délai d’établissement de l’appel PSTN. | 115 |
| Promouvoir un appel 1:1 vers un appel de groupe de délai d'expiration. | 115 |
Action à effectuer
Pour plus d'informations sur le SDK et le service d'appels vocaux et vidéo, voir Vue d'ensemble du SDK d'appel ou Problèmes connus dans les SDK et API. Vous pouvez aussi envoyer une requête au Support Azure pour augmenter certaines 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’attente en secondes |
|---|---|---|---|---|
| Requêtes générales | Par ressource | 10 | 1 000 | 10 |
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.
Interopérabilité 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 sur cette page web plus en détail.
Action à effectuer
Lorsque vous implémentez la gestion des erreurs, utilisez le code d’erreur HTTP 429 pour détecter la limitation. 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 récupérer des requêtes après limitation, car Microsoft Graph continue à consigner l’utilisation des ressources pendant qu’un client est limité.
Vous trouverez plus d’informations concernant la limitation de requêtes Microsoft Graph dans la documentation Microsoft Graph.
Contenu connexe
Consultez les options d’aide et de support.