Limites de service pour Azure Communication Services
Ce document 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 méthodes recommandées pour la gestion de la limitation sont les suivantes :
- 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.
Vous trouverez 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. Les limites de la limitation peuvent être augmentées à l’aide d’une demande adressée au support Azure.
- Ouvrez le portail Azure et connectez-vous.
- Sélectionnez Aide et support.
- Cliquez sur Créer une demande de support.
- Dans la zone de texte Décrivez votre problème, entrez
Technical, puis cliquez sur OK. - Dans le menu déroulant Sélectionner un service, sélectionnez Limites du service et de l’abonnement (quotas), puis cliquez sur Suivant.
- Dans la description du problème, choisissez le Type de problème, l’Abonnement et le Type de quota, puis cliquez sur Suivant.
- Passez en revue la Solution recommandée, si elle est disponible, puis cliquez sur Suivant.
- Ajoutez des Détails supplémentaires selon les besoins, puis cliquez sur Suivant.
- Dans Vérifier + créer, vérifiez les informations, apportez des changements selon les besoins, puis cliquez sur Créer.
Vous pouvez suivre la documentation pour créer une demande Support Azure.
Acquisition de 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, consultez la page concept Types de numéro de téléphone et la page de vue d’ensemble du concept de téléphonie.
Les limites d’achat peuvent être augmentées à l’aide d’une demande adressée au Support Azure.
- Ouvrez le portail Azure et connectez-vous.
- Sélectionnez Aide et support.
- Cliquez sur Créer une demande de support.
- Dans la zone de texte Décrivez votre problème, entrez
Technical, puis cliquez sur OK. - Dans le menu déroulant Sélectionner un service, sélectionnez Limites du service et de l’abonnement (quotas), puis cliquez sur Suivant.
- Dans la description du problème, choisissez le Type de problème, l’Abonnement et le Type de quota, puis cliquez sur Suivant.
- Passez en revue la Solution recommandée, si elle est disponible, puis cliquez sur Suivant.
- Ajoutez des Détails supplémentaires selon les besoins, puis cliquez sur Suivant.
- Dans Vérifier + créer, vérifiez les informations, apportez des changements selon les besoins, puis cliquez sur 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 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, lorsque la page web se charge ou que l’application démarre.
Pour plus d’informations, consultez la page Vue d’ensemble du concept d’identité.
SMS
Lors de l’envoi ou de la réception d’un grand nombre de messages, vous pouvez recevoir une erreur 429. Cette erreur indique que vous atteignez les limites du service. Vos messages sont donc mis en file d’attente pour être envoyés une fois que le nombre de requêtes sera inférieur au seuil.
Limites de débit pour SMS :
| Opération | Type de numéro | Étendue | Délai(s) d’exécution | Limite (n{^>bre<^} de demandes) | Unités de message par minute |
|---|---|---|---|---|---|
| Envoyer un message | 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 demande au 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 la page Vue d’ensemble du SDK SMS ou la page 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 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 services d’hébergement de courrier tiers de s’adapter au changement d’adresse IP pour le trafic d’e-mails de votre domaine. Ainsi, votre réputation d’expéditeur est protégée et la fiabilité de la remise de vos e-mails est maintenue.
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. Notez que les quotas supérieurs sont disponibles uniquement pour les domaines personnalisés vérifiés, pas pour les domaines managés par Azure.
Limites du débit
| Opération | Étendue | Délai d’exécution (minutes) | Limite (nombre d’e-mails) |
|---|---|---|---|
| Envoyer un courrier électronique | Par abonnement | 1 | 30 |
| Envoyer un courrier électronique | Par abonnement | 60 | 100 |
| Obtenir l’état des e-mails | Par abonnement | 1 | 60 |
| Obtenir l’état des e-mails | Par abonnement | 60 | 200 |
| Opération | Étendue | Délai d’exécution (minutes) | Limite (nombre d’e-mails) |
|---|---|---|---|
| Envoyer un courrier électronique | Par abonnement | 1 | 5 |
| Envoyer un courrier électronique | Par abonnement | 60 | 10 |
| Obtenir l’état des e-mails | Par abonnement | 1 | 10 |
| Obtenir l’état des e-mails | Par abonnement | 60 | 20 |
Limites de taille
| Nom | Limite |
|---|---|
| Nombre de destinataires dans l’e-mail | 50 |
| Taille totale des demandes d’e-mail (pièces jointes comprises) | 10 Mo |
Pour toutes les limites de taille de message, vous devez prendre en compte le fait que l’encodage 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 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, vous pouvez utiliser 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é (SAP) fournit un accès délégué et sécurisé aux ressources de votre 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 Azure :
- Vous pouvez gérer des fichiers à grande échelle.
- Vous pouvez utiliser des clés 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 du 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 de messagerie.
Remarque
L’évaluation et l’approbation des demandes d’augmentation du quota d’e-mails peuvent prendre jusqu’à 72 heures, notamment pour les demandes arrivant un vendredi après-midi.
Converser
Limites de taille
| Nom | Limite |
|---|---|
| Nombre de participants dans le thread | 250 |
| Lot de participants - CreateThread | 200 |
| Lot de participants - AddParticipant | 200 |
| Taille de page - ListMessages | 200 |
| Taille des messages | 28 Ko |
| Nombre de ressources Azure Communication Services par bot Azure | 1 000 |
Limites du débit
| Opération | Portée | 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/supprimer des participants | par Thread de conversation | 10 | 30 |
| Obtenir le fil de conversation/répertorier les fils de conversation | par Utilisateur | 50 | - |
| Recevoir un message de conversation | par Utilisateur par thread de conversation | 50 | - |
| Recevoir un message de conversation | par Thread de conversation | 250 | - |
| Lister les messages de conversation | par Utilisateur 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 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 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/supprimer un message | par Thread de conversation | 10 | 30 |
| Envoyer une confirmation de lecture | par Utilisateur par thread de conversation | 10 | 30 |
| Envoyer un indicateur de saisie | par Utilisateur 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 besoins de conformité stricts, nous vous recommandons de supprimer les conservations à l’aide de l’API de suppression 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 avez supprimé accidentellement des messages, le système ne peut pas les récupérer. De plus, si vous envoyez une demande de support pour une conversation supprimée par la stratégie de rétention, cette conversation ne pourra plus être récupérée, et aucune information la concernant ne sera disponible. 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
Limitations d’appel RTC
| Nom | Portée | Limite |
|---|---|---|
| Nombre d’appels sortants* simultanés par défaut | par Nombre | 2 |
Remarque
* Pas de limites sur les appels simultanés entrants. Vous pouvez également envoyer une demande au Support Azure pour augmenter la limite des appels simultanés entrants, qui sera traitée par notre équipe de vérification.
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 Communication Services prend en charge les configurations de streaming suivantes :
| Limite | web | Windows/Android/iOS |
|---|---|---|
| Nombre maximal 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 maximal de flux distants entrants que vous pouvez restituer 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 Communication Services :
| Action | Délai d’attente en secondes |
|---|---|
| Reconnecter/supprimer un participant | 120 |
| Ajouter ou supprimer une nouvelle modalité à partir d'un appel (démarrage/arrêt d'une vidéo ou partage d'écran) | 40 |
| Délai d’attente de l’opération de transfert d’appel | 60 |
| 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 |
| Délai de la promotion de l’appel en tête-à-tête en appel de groupe | 115 |
Action à effectuer
Pour plus d’informations sur le service et le kit de développement logiciel (SDK) d’appel vocal et vidéo, consultez la page Vue d’ensemble du SDK appelant ou Problèmes connus. Vous pouvez aussi envoyer une demande au Support Azure pour augmenter certaines limites, qui sera examinée par notre équipe de vérification.
Routeur de tâches
Lors de l’envoi ou de la réception d’un grand volume de demandes, il est possible que vous receviez une erreur ThrottleLimitExceededException. Cette erreur indique que vous atteignez les limites du service, et vos requêtes échouent jusqu’à ce que le jeton du compartiment pour traiter les requêtes soit réapprovisionné après un certain temps.
Limites de transfert pour le Routeur de tâches :
| Opération | Étendue | Plage de temps (secondes) | Limite (nombre de requêtes) | Délai d’attente en secondes |
|---|---|---|---|---|
| Demandes 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 utiliserez probablement des 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 aux services sont décrites ici 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. Retarder les requêtes avec un délai Retry-After 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 sur la limitation de requêtes Microsoft Graph dans la documentation Microsoft Graph.
Étapes suivantes
Consultez les options d’aide et de support.