Azure Communication Service에 대한 서비스 제한
이 문서에서는 Azure Communication Services API의 제한 사항과 가능한 해결 방법을 설명합니다.
제한 패턴 및 아키텍처
서비스 제한에 도달하면 일반적으로 HTTP 상태 코드 429(요청이 너무 많음)를 받게 됩니다. 일반적으로 제한 처리에 대한 모범 사례는 다음과 같습니다.
- 요청당 작업 수를 줄입니다.
- 호출 빈도를 줄입니다.
- 모든 요청은 사용량 제한에 누적되므로 즉각적인 재시도는 피합니다.
제한 패턴에 대한 Azure 아키텍처 설명서에서 제한 및 제한 사항을 처리하도록 서비스 아키텍처를 설정하는 방법에 대한 보다 일반적인 참고 자료를 찾을 수 있습니다. Azure 지원에 요청하여 제한을 늘릴 수 있습니다.
- Azure Portal로 이동
- 도움말+지원을 선택합니다.
- 새 지원 요청 만들기를 클릭합니다.
- 문제 설명에서 문제 형식을 기술로 선택하고 세부 정보에 추가하세요.
Azure 지원에 대한 요청 작성용 설명서를 따르면 됩니다.
전화 번호 가져오기
전화 번호를 획득하기 전에 구독이 지리 및 구독 요구 사항을 충족하는지 확인합니다. 그렇지 않으면 전화 번호를 구입할 수 없습니다. 아래 제한 사항은 전화 번호 SDK 및 Azure Portal을 통해 구매 번호에 적용됩니다.
| 연산 | 범위 | 시간 프레임 | 제한(총 요청 수) |
|---|---|---|---|
| 전화 번호 구매 | Azure 테넌트 | - | 1 |
| 전화 번호 검색 | Azure 테넌트 | 1주 | 5 |
수행할 작업
자세한 내용은 전화 번호 유형 개념 페이지 및 전화 통신 개념 개요 페이지를 참조하세요.
더 많은 전화 번호를 구입하거나 특별 주문을 하려면 여기의 지침을 따르세요. 외부 계정의 무료 전화 번호를 해당 Azure Communication Services 계정으로 포팅하려면 여기의 지침을 따르세요.
ID
| 연산 | 시간 프레임(초) | 제한(총 요청 수) |
|---|---|---|
| ID 만들기 | 30 | 1000 |
| ID 삭제 | 30 | 500 |
| 액세스 토큰 발급 | 30 | 1000 |
| 액세스 토큰 철회 | 30 | 500 |
| createUserAndToken | 30 | 1000 |
| exchangeTokens | 30 | 500 |
수행할 작업
채팅 스레드를 만들거나 통화를 시작하기 전에 ID 및 토큰을 획득하는 것이 좋습니다. 예를 들어 웹 페이지가 로드되거나 애플리케이션이 시작될 때입니다.
자세한 내용은 ID 개념 개요 페이지를 참조하세요.
SMS
대량의 메시지를 보내거나 받을 때 429 오류가 발생할 수 있습니다. 이 오류는 서비스 제한에 도달했음을 나타내며 요청 수가 임계값보다 낮으면 메시지가 큐에 대기됩니다.
SMS의 속도 제한:
| 연산 | 전화 번호 유형 | 범위 | 시간 범위 | 제한(요청 #) | 분당 메시지 단위 |
|---|---|---|---|---|---|
| 메시지 보내기 | 수신자 부담 | 숫자당 | 60 | 200 | 200 |
| 메시지 보내기 | 짧은 코드 | 숫자당 | 60 | 6000 | 6000 |
| 메시지 보내기 | 영숫자 보낸 사람 ID | 리소스당 | 60 | 600 | 600 |
수행할 작업
속도 제한을 초과하는 요구 사항이 있는 경우 Azure 지원에 요청을 제출하여 처리량을 높일 수 있습니다.
SMS SDK 및 서비스에 대한 자세한 내용은 SMS SDK 개요 페이지 또는 SMS FAQ 페이지를 참조하세요.
전자 메일
보낼 수 있는 전자 메일 메시지 수에는 제한이 있습니다. 구독에 대한 아래 제한을 초과하면 요청이 거부됩니다. Retry-After 시간이 지나면 이러한 요청을 다시 시도할 수 있습니다. 필요한 경우 필요한 조치를 취하고 전송 볼륨 제한을 높이도록 요청하세요.
속도 제한
| 연산 | 범위 | 시간 프레임(분) | 제한(이메일 수) |
|---|---|---|---|
| 전자 메일 보내기 | 구독당 | 1 | 30 |
| 전자 메일 보내기 | 구독당 | 60 | 100 |
| 이메일 상태 가져오기 | 구독당 | 1 | 60 |
| 이메일 상태 가져오기 | 구독당 | 60 | 200 |
| 연산 | 범위 | 시간 프레임(분) | 제한(이메일 수) |
|---|---|---|---|
| 전자 메일 보내기 | 구독당 | 1 | 5 |
| 전자 메일 보내기 | 구독당 | 60 | 10 |
| 이메일 상태 가져오기 | 구독당 | 1 | 10 |
| 이메일 상태 가져오기 | 구독당 | 60 | 20 |
크기 한도
| 이름 | 한도 |
|---|---|
| 이메일의 받는 사람 수 | 50 |
| 총 메일 요청 크기(첨부 파일 포함) | 10MB |
수행할 작업
이 샌드박스 설정은 개발자가 애플리케이션 빌드를 시작하는 데 도움이 됩니다. 메일을 전송하여 보낸 사람 평판을 설정한 후에는 전송 볼륨 제한을 늘리도록 요청할 수 있습니다. 속도 제한을 초과하는 메시지 볼륨을 보내야 하는 경우 원하는 이메일 전송 제한을 높이기 위해 지원 요청을 제출합니다. 이메일 할당량 증가 요청은 자동으로 승인되지 않습니다. 승인 상태를 정할 때는 검토 팀에서 이메일 배달 실패율, 도메인 평판, 스팸 및 남용 보고서 등의 요소를 포함하는 보낸 사람 종합 평판을 고려합니다.
참고 항목
이메일 할당량 증가 요청은 평가 및 승인되는 데 최대 72시간이 걸릴 수 있으며, 특히 금요일 오후에 들어오는 요청의 경우 그렇습니다.
채팅
크기 한도
| 이름 | 한도 |
|---|---|
| 호출당 참가자 수 | 250 |
| 참가자 일괄 처리 - CreateThread | 200 |
| 참가자 일괄 처리 - AddParticipant | 200 |
| 페이지 크기 - ListMessages | 200 |
| 메시지 크기 | 28KB |
| Azure 봇당 Azure Communication Services 리소스 수 | 1000 |
속도 제한
| 연산 | 범위 | 10초당 제한 | 분당 제한 |
|---|---|---|---|
| 채팅 스레드 만들기 | 사용자당 | 10 | - |
| 채팅 스레드 삭제 | 사용자당 | 10 | - |
| 채팅 스레드 업데이트 | 채팅 스레드당 | 5 | - |
| 참가자 추가/참가자 제거 | 채팅 스레드당 | 10 | 30 |
| 채팅 스레드 가져오기/채팅 스레드 나열 | 사용자당 | 50 | - |
| 채팅 메시지 가져오기 | 채팅 스레드당 사용자당 | 50 | - |
| 채팅 메시지 가져오기 | 채팅 스레드당 | 250 | - |
| 채팅 메시지 나열 | 채팅 스레드당 사용자당 | 50 | 200 |
| 채팅 메시지 나열 | 채팅 스레드당 | 250 | 400 |
| 읽음 확인 받기(참가자 제한 20명**) | 채팅 스레드당 사용자당 | 5 | - |
| 읽음 확인 받기(참가자 제한 20명**) | 채팅 스레드당 | 100 | - |
| 채팅 스레드 참가자 나열하기 | 채팅 스레드당 사용자당 | 10 | - |
| 채팅 스레드 참가자 나열하기 | 채팅 스레드당 | 250 | - |
| 메시지 보내기/메시지 업데이트/메시지 삭제 | 채팅 스레드당 | 10 | 30 |
| 읽음 확인 보내기 | 채팅 스레드당 사용자당 | 10 | 30 |
| 입력 표시기 전송 | 채팅 스레드당 사용자당 | 5 | 15 |
| 입력 표시기 전송 | 채팅 스레드당 | 10 | 30 |
참고 항목
** 참가자가 20명이 넘는 채팅 스레드의 경우 수신 확인 및 입력 표시기 기능이 지원되지 않습니다.
채팅 스토리지
Azure Communication Services는 고객이 삭제할 때까지 채팅 메시지를 무기한 저장합니다.
2024년 1분기부터 고객은 메시지 무기한 보존과 90일 후 자동 삭제 중 하나를 선택해야 합니다. 기존 메시지는 영향을 받지 않지만 원하는 경우 고객은 90일로 보존 기간을 선택할 수 있습니다.
참고 항목
시스템에서는 실수로 삭제된 메시지를 복구할 수 없습니다.
음성 및 비디오 통화
PSTN 호출 제한 사항
| 이름 | 범위 | 제한 |
|---|---|---|
| 아웃바운드 동시 호출 수 기본값 | 숫자당 | 2 |
최대 제한 사항 호출
| 이름 | 한도 |
|---|---|
| 참가자 수 | 350 |
통화 SDK 스트리밍 지원
Communication Services 통화 SDK는 다음과 같은 스트리밍 구성을 지원합니다.
| 제한 | 웹 | Windows/Android/iOS |
|---|---|---|
| 동시에 보낼 수 있는 최대 송신 로컬 스트림 수 | 비디오 1개 또는 화면 공유 1개 | 비디오 1개 + 화면 공유 1개 |
| 동시에 렌더링할 수 있는 최대 수신 원격 스트림 수 | 비디오 9개 + 화면 공유 1개 | 비디오 9개 + 화면 공유 1개 |
통화 SDK는 이러한 제한을 적용하지 않지만 초과할 경우 사용자에게 성능 저하가 발생할 수 있습니다.
통화 SDK 제한 시간
Communication Services 통화 SDK에는 다음 제한 시간이 적용됩니다.
| 작업 | 시간 제한(초) |
|---|---|
| 참가자 다시 연결/제거 | 120 |
| 통화에서 새 형식을 추가하거나 제거합니다(비디오 또는 화면 공유 시작/중지). | 40 |
| 통화 전송 작업 제한 시간 | 60 |
| 1:1 통화 설정 제한 시간 | 85 |
| 그룹 통화 설정 제한 시간 | 85 |
| PSTN 통화 설정 제한 시간 | 115 |
| 1:1 통화를 그룹 통화 제한 시간으로 승격 | 115 |
수행할 작업
음성 및 비디오 통화 SDK 및 서비스에 대한 자세한 내용은 호출 SDK 개요 페이지 또는 알려진 문제를 참조하세요.
작업 라우터
대량의 요청을 보내거나 받을 때 ThrottleLimitExceededException 오류가 발생할 수 있습니다. 이 오류는 서비스 제한에 도달했음을 의미하며 일정 시간이 지나 요청을 처리하는 버킷의 토큰이 보충될 때까지 요청이 삭제됩니다.
작업 라우터의 속도 제한:
| 연산 | 범위 | 시간 프레임(초) | 제한(총 요청 수) | 시간 제한(초) |
|---|---|---|---|---|
| 일반 요청 | 리소스당 | 10 | 1000 | 10 |
수행할 작업
속도 제한을 초과하는 메시지 볼륨을 보내야 하는 경우 acs-ccap@microsoft.com에 이메일을 보내주세요.
Teams 상호 운용성 및 Microsoft Graph
Teams 상호 운용성 시나리오를 사용하면 일부 Microsoft Graph API를 사용하여 모임을 만들 수 있습니다.
Microsoft Graph를 통해 제공되는 각 서비스에는 서로 다른 제한 사항이 있습니다. 서비스별 제한은 여기에 자세히 설명되어 있습니다.
수행할 작업
오류 처리를 구현하는 경우 HTTP 오류 코드 429를 사용하여 제한을 검색합니다. 실패한 응답에는 Retry-After 응답 헤더가 포함됩니다. Microsoft Graph는 클라이언트가 제한되는 동안 계속 리소스 사용량을 로그하므로 제한에서 복구하는 가장 빠른 방법은 Retry-After 지연을 사용하여 요청을 늦추는 것입니다.
Microsoft Graph 제한 한도에 대한 자세한 내용은 Microsoft Graph 설명서에서 확인할 수 있습니다.
Network Traversal
| 연산 | 시간 프레임(초) | 제한(총 요청 수) |
|---|---|---|
| TURN 자격 증명 발급 | 5 | 30000 |
| 릴레이 구성 발급 | 5 | 30000 |
수행할 작업
릴레이 연결 만들기와 같은 다른 트랜잭션을 시작하기 전에 토큰을 획득하는 것이 좋습니다.
자세한 내용은 네트워크 순회 개념 개요 페이지를 참조하세요.
다음 단계
도움말 및 지원 옵션을 참조하세요.