Límites de servicio para Azure Communication Services
En este documento se explican las limitaciones de las API de Azure Communication Services y las posibles soluciones.
Arquitectura y patrones de limitación
Al alcanzar las limitaciones del servicio, recibirá un código de estado HTTP 429 (demasiadas solicitudes). En general, los procedimientos recomendados para controlar la limitación son los siguientes:
- Reduzca el número de operaciones por solicitud.
- Reduzca la frecuencia de las llamadas.
- Evite reintentos inmediatos, ya que todas las solicitudes se acumulan en los límites de uso.
Puede encontrar instrucciones más generales sobre cómo configurar la arquitectura de servicio para controlar las limitaciones en la documentación Arquitectura de Azure para los patrones de limitación. Los límites de ancho de banda se pueden aumentar a través de una solicitud al Soporte técnico de Azure.
- Abra Azure Portal e inicie sesión.
- Seleccione Ayuda y soporte técnico.
- Haga clic Creación de una solicitud de soporte técnico.
- En el cuadro de texto Describir el problema, escriba
Technicaly luego haga clic en Ir. - En el menú desplegable Seleccionar un servicio, seleccione Límites de servicio y suscripción (cuotas) y luego haga clic en Siguiente.
- En la descripción del problema, elija el tipo de problema, suscripción y Tipo de cuota haga clic en Siguiente.
- Revise cualquier solución recomendada si está disponible y haga clic en Siguiente.
- Agregue detalles adicionales según sea necesario y luego haga clic en Siguiente.
- En Revisar y crear compruebe la información, realice cambios según sea necesario y, a continuación, haga clic en Crear.
Puede seguir la documentación para crear una solicitud para soporte técnico de Azure.
Adquisición de números de teléfono
Antes de adquirir un número de teléfono, asegúrese de que la suscripción cumple los requisitos geográficos y de suscripción. De lo contrario, no puede comprar un número de teléfono. Las limitaciones siguientes se aplican a la adquisición de números mediante el SDK de números de teléfono y Azure Portal.
| Operación | Ámbito | Plazo de tiempo | Límite (número de solicitudes) |
|---|---|---|---|
| Compra de un número de teléfono | Inquilino de Azure | - | 1 |
| Búsqueda de números de teléfono | Inquilino de Azure | una semana | 5 |
Acción que realizar
Para más información, consulte la página de concepto de tipos de números de teléfono y la página de información general del concepto de telefonía.
Si quiere adquirir más números de teléfono o realizar un pedido especial, siga las instrucciones que se indican aquí. Si quiere realizar la portabilidad de números de teléfono gratuitos de cuentas externas a su cuenta de Azure Communication Services, siga las instrucciones que se indican aquí.
identidad
| Operación | Períodos de tiempo (segundos) | Límite (número de solicitudes) |
|---|---|---|
| Creación de la identidad | 30 | 1000 |
| Eliminar identidad | 30 | 500 |
| Emitir tokens de acceso | 30 | 1000 |
| Revocar token de acceso | 30 | 500 |
| createUserAndToken | 30 | 1000 |
| exchangeTokens | 30 | 500 |
Acción que realizar
Se recomienda adquirir identidades y tokens antes de crear subprocesos de chat o iniciar llamadas. Por ejemplo, cuando se carga la página web o se inicia la aplicación.
Para más información, consulte la página de información general del concepto de identidad.
SMS
Al enviar o recibir un gran volumen de mensajes, es posible que reciba un error 429. Este error indica que está alcanzando las limitaciones del servicio y los mensajes se pondrán en cola para enviarse una vez que el número de solicitudes esté por debajo del umbral.
Límites de frecuencia para SMS:
| Operación | Tipo de número de teléfono | Ámbito | Períodos de tiempo | Límite (número de solicitudes) | Unidades de mensaje por minuto |
|---|---|---|---|---|---|
| Enviar mensaje | Gratuito | Por número | 60 | 200 | 200 |
| Enviar mensaje | Código corto | Por número | 60 | 6000 | 6000 |
| Enviar mensaje | Id. de remitente alfanumérico | Por recurso | 60 | 600 | 600 |
Acción que realizar
Si tiene requisitos que superan los límites de velocidad, envíe una solicitud al soporte técnico de Azure para habilitar un mayor rendimiento.
Para más información sobre el SDK y el servicio SMS, consulte la página de información general del SDK de SMS o la página de preguntas frecuentes sobre SMS.
Hay un límite en el número de mensajes de correo electrónico que puede enviar durante un periodo de tiempo determinado. Si supera los límites siguientes en la suscripción, se rechazan las solicitudes. Puede volver a intentar estas solicitudes, cuando transcurra el tiempo de reintento. Puede solicitar que se aumenten los límites de volumen de envío si es necesario.
Límites de velocidad
| Operación | Ámbito | Período de tiempo (minutos) | Límite (número de correos electrónicos) |
|---|---|---|---|
| Enviar correo | Por suscripción | 1 | 30 |
| Enviar correo | Por suscripción | 60 | 100 |
| Obtén el estado del correo electrónico | Por suscripción | 1 | 60 |
| Obtén el estado del correo electrónico | Por suscripción | 60 | 200 |
Dominios administrados de Azure
| Operación | Ámbito | Período de tiempo (minutos) | Límite (número de correos electrónicos) |
|---|---|---|---|
| Enviar correo | Por suscripción | 1 | 5 |
| Enviar correo | Por suscripción | 60 | 10 |
| Obtén el estado del correo electrónico | Por suscripción | 1 | 10 |
| Obtén el estado del correo electrónico | Por suscripción | 60 | 20 |
Límites de tamaño
| Nombre | Límite |
|---|---|
| Número de destinatarios en correo electrónico | 50 |
| Tamaño total de la solicitud de correo electrónico (datos adjuntos incluidos) | 10 MB |
Acción que realizar
Esta configuración de espacio aislado sirve para ayudar a los desarrolladores a empezar a compilar la aplicación. Una vez que haya establecido una reputación de remitente mediante el envío de correos, podrá solicitar el aumento de los límites de volumen de envío. Envíe una solicitud de soporte técnico para aumentar el límite de envío de correo electrónico deseado si necesita enviar un volumen de mensajes que superen los límites de frecuencia. Las solicitudes de aumento de cuota de correo electrónico no se aprueban automáticamente. El equipo de revisión tiene en cuenta su reputación general de remitente, que incluye factores como sus tasas de error en la entrega de correo electrónico, la reputación de su dominio y los informes de spam y abuso a la hora de determinar el estado de aprobación.
Nota:
Las solicitudes de aumento de cuota de correo electrónico pueden tardar hasta 72 horas en ser evaluadas y aprobadas, especialmente en el caso de las solicitudes que llegan el viernes por la tarde.
Chat
Límites de tamaño
| Nombre | Límite |
|---|---|
| Número de participantes en el subproceso | 250 |
| Lote de participantes: CreateThread | 200 |
| Lote de participantes: AddParticipant | 200 |
| Tamaño de página: ListMessages | 200 |
| Tamaño de los mensajes | 28 KB |
| Número de recursos de Azure Communication Services por Azure Bot | 1000 |
Límites de velocidad
| Operación | Ámbito | Límite por cada 10 segundos | Límite por cada minuto |
|---|---|---|---|
| Creación de subprocesos de chat | por usuario | 10 | - |
| Eliminación de subprocesos de chat | por usuario | 10 | - |
| Actualización de subprocesos de chat | por subproceso de chat | 5 | - |
| Agregación o eliminación de participantes | por subproceso de chat | 10 | 30 |
| Obtención o enumeración de subprocesos de chat | por usuario | 50 | - |
| Obtener mensaje de chat | por usuario por subproceso de chat | 50 | - |
| Obtener mensaje de chat | por subproceso de chat | 250 | - |
| Mostrar mensajes de chat | por usuario por subproceso de chat | 50 | 200 |
| Mostrar mensajes de chat | por subproceso de chat | 250 | 400 |
| Obtener recibos de lectura (límite de 20 participantes**) | por usuario por subproceso de chat | 5 | - |
| Obtener recibos de lectura (límite de 20 participantes**) | por subproceso de chat | 100 | - |
| Enumeración de los participantes de los subprocesos de chat | por usuario por subproceso de chat | 10 | - |
| Enumeración de los participantes de los subprocesos de chat | por subproceso de chat | 250 | - |
| Enviar, actualizar o eliminar mensajes | por subproceso de chat | 10 | 30 |
| Envío de confirmación de lectura | por usuario por subproceso de chat | 10 | 30 |
| Envío de indicadores de escritura | por usuario por subproceso de chat | 5 | 15 |
| Envío de indicadores de escritura | por subproceso de chat | 10 | 30 |
Nota:
** Los recibos de lectura y los indicadores de escritura no se admiten en los subprocesos de chat con más de 20 participantes.
Almacenamiento de chats
Azure Communication Services almacena mensajes de chat según la directiva de retención que establezca al crear un subproceso de chat.
Importante
La funcionalidad descrita en este artículo se encuentra actualmente en versión preliminar pública. Esta versión preliminar se ofrece sin un Acuerdo de Nivel de Servicio y no se recomienda para cargas de trabajo de producción. Es posible que algunas características no sean compatibles o que tengan sus funcionalidades limitadas. Para más información, consulte Términos de uso complementarios de las Versiones Preliminares de Microsoft Azure.
Puede elegir entre retención de mensajes indefinida o eliminación automática entre 30 y 90 días a través de la directiva de retención en Crear API de subproceso de chat. Como alternativa, puede optar por no establecer una directiva de retención en un subproceso de chat.
Si tiene necesidades estrictas de cumplimiento, se recomienda eliminar subprocesos de chat mediante la API Eliminar subproceso de chat. Los subprocesos creados antes de la nueva directiva de retención no se ven afectados a menos que cambie específicamente la directiva de ese subproceso.
Nota:
Si eliminó accidentalmente los mensajes, el sistema no podrá recuperarlos. Además, si envía una solicitud de soporte técnico para un subproceso de chat eliminado después de que la directiva de retención haya eliminado ese subproceso, ya no se puede recuperar y no hay información sobre ese subproceso disponible. Si es necesario, abra una incidencia de soporte técnico lo antes posible en el período de 30 días después de crear un subproceso para que podamos ayudarle.
Llamadas de voz y vídeo
Limitaciones de llamadas RTC
| Nombre | Ámbito | Límite |
|---|---|---|
| Número predeterminado de llamadas simultáneas salientes* | por número | 2 |
*: sin límites en las llamadas simultáneas entrantes. También puede enviar una solicitud al Soporte técnico de Azure para aumentar el límite de llamadas simultáneas salientes y nuestro equipo de investigación la revisará.
Limitaciones máximas de la llamada
| Nombre | Límite |
|---|---|
| Número de participantes | 350 |
Compatibilidad con streaming de Calling SDK
Calling SDK de Communication Services admite las siguientes configuraciones de streaming:
| Límite | Web | Windows/Android/iOS |
|---|---|---|
| Número máximo de secuencias salientes que se pueden enviar simultáneamente | un vídeo o un uso compartido de pantalla | un vídeo + un uso compartido de pantalla |
| Número máximo de secuencias remotas entrantes que se pueden enviar simultáneamente | 9 vídeos + un uso compartido de pantalla | 9 vídeos + un uso compartido de pantalla |
Aunque el SDK de llamada no aplicará estos límites, los usuarios pueden experimentar una degradación del rendimiento si se superan.
Tiempos de espera de Calling SDK
Los siguientes tiempos de espera se aplican a las instancias de Calling SDK de Communication Services:
| Action | Tiempo de espera en segundos |
|---|---|
| Participante de reconexión/eliminación | 120 |
| Agregar o quitar una nueva modalidad de una llamada (iniciar/detener el uso compartido de la pantalla o un vídeo) | 40 |
| Tiempo de espera de la operación de transferencia de llamadas | 60 |
| Tiempo de espera del establecimiento de llamadas entre dos personas | 85 |
| Tiempo de espera del establecimiento de llamadas de grupo | 85 |
| Tiempo de espera del establecimiento de llamadas RTC | 115 |
| Tiempo de espera de promoción de una llamada entre dos personas para que sea una llamada de grupo | 115 |
Acción que realizar
Para más información sobre el SDK y el servicio de llamadas de voz y vídeo, consulte la página de información general del SDK de llamada o los problemas conocidos. También puede Enviar una solicitud al de soporte técnico de Azure para aumentar algunos de los límites y a continuación, nuestro equipo de investigación lo revisa.
Enrutador de trabajos
Al enviar o recibir un gran volumen de solicitudes, es posible que reciba un error ThrottleLimitExceededException. Este error indica que está alcanzando las limitaciones del servicio y las solicitudes se quitarán hasta que el token de bucket para controlar las solicitudes se reabastece después de un tiempo determinado.
Límites de velocidad para el enrutador de trabajos:
| Operación | Ámbito | Período de tiempo (segundos) | Límite (número de solicitudes) | Tiempo de espera en segundos |
|---|---|---|---|---|
| Solicitudes generales | Por recurso | 10 | 1000 | 10 |
Acción que realizar
Si necesita enviar un volumen de mensajes que supere los límites de velocidad, envíenos un correo electrónico a acs-ccap@microsoft.com.
Interoperabilidad de Teams y Microsoft Graph
Si usa un escenario de interoperabilidad de Teams, es probable que use algunas API de Microsoft Graph para crear reuniones.
Cada servicio ofrecido a través de Microsoft Graph tiene limitaciones diferentes; los límites específicos del servicio se describen aquí con más detalle.
Acción que realizar
Cuando implemente el control de errores, utilice el código de error HTTP 429 para detectar la limitación. La respuesta con error incluye el encabezado de respuesta Retry-After. Realizar una copia de seguridad de las solicitudes que usan el retraso Retry-After es la manera más rápida de recuperarse de la limitación porque Microsoft Graph sigue registrando el uso de recursos mientras se imponen límites a cliente.
Puede encontrar más información sobre los límites de Microsoft Graph en la documentación de Microsoft Graph.
Pasos siguientes
Consulte las opciones de ayuda y soporte técnico.
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente las Cuestiones de GitHub como mecanismo de retroalimentación para el contenido y lo sustituiremos por un nuevo sistema de retroalimentación. Para más información, consulta: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de