Azure Communication Services (Azure 通訊服務) 的服務限制
本文件說明 Azure Communication Services API 的限制和可能的解決方案。
節流模式和架構
當您達到服務的限制數量時,通常會收到 HTTP 狀態碼 429 (太多要求)。 一般而言,以下是處理節流的最佳作法:
- 減少每個要求的作業數目。
- 減少呼叫的頻率。
- 避免立即做出重試,因為所有的要求都會納入使用量限制的計算。
您可以在適用於節流模式的 Azure 架構文件中找到有關如何設定服務架構以處理節流和限制的更多一般指引。 節流限制數量可透過對 Azure 支援的要求來增加。
取得電話號碼
在取得一組門號 (電話號碼) 之前,請確定您的訂用帳戶符合地理和訂用帳戶的需求。 否則,您無法購買一組門號 (電話號碼)。 下列的限制適用於透過電話號碼 SDK 和 Azure 入口網站中來購買門號 (電話號碼)。
作業 | 範圍 | 時間範圍 | 限制 (要求數目) |
---|---|---|---|
購買門號 (電話號碼) | Azure 租用戶 | - | 1 |
搜尋門號 (電話號碼) | Azure 租用戶 | 一週 | 5 |
要採取的動作
如需詳細資訊,請參閱電話號碼類型概念頁面和電話語音概念概觀頁面。
如果您想要購買更多組的門號 (電話號碼) 或下特殊的訂單,請遵循這裡的指示。 如果您想要將免付費電話號碼從外部帳戶移植到其 Azure 通訊服務帳戶,請遵循這裡的指示。
身分識別
作業 | 時間範圍 (秒) | 限制 (要求數目) |
---|---|---|
建立身分識別 | 30 | 500 |
刪除身分識別 | 30 | 500 |
核發存取權杖 | 30 | 500 |
撤銷存取權杖 | 1 | 100 |
createUserAndToken | 30 | 1000 |
exchangeTokens | 30 | 500 |
要採取的動作
建議您先取得身分識別和權杖,再建立聊天對話串或開始通話。 例如,當網頁載入或應用程式啟動時。
如需詳細資訊,請參閱身分識別概念概觀頁面。
SMS
傳送或接收大量訊息時,您可能會收到 429
錯誤。 此錯誤表示您達到了服務的限制數量,一旦要求數量低於閾值,您的訊息便會排入佇列等待傳送。
簡訊 (SMS) 的比率限制:
作業 | 範圍 | 時間範圍 (秒) | 限制 (要求數目) | 每分鐘的訊息單位 |
---|---|---|---|---|
傳送訊息 | 每個號碼 | 60 | 200 | 200 |
要採取的動作
如果您需要傳送超過比率限制的訊息數量,請傳送電子郵件給我們:phone@microsoft.com。
如需 SMS SDK 和服務的詳細資訊,請參閱 SMS SDK 概觀頁面或 SMS 常見問題頁面。
電子郵件
傳送大量的郵件訊息對您可以傳送的電子郵件數量有一組限制。 如果您達到這些限制數量,則您的訊息不會排入佇列等待傳送。 一旦 Retry-After 時間到了,您便能再次提交這些要求。
速率限制
作業 | 範圍 | 時間範圍 (分鐘) | 限制 (電子郵件數目) |
---|---|---|---|
傳送電子郵件 | 每個訂用帳戶 | 1 | 10 |
傳送電子郵件 | 每個訂用帳戶 | 60 | 25 |
取得電子郵件狀態 | 每個訂用帳戶 | 1 | 20 |
取得電子郵件狀態 | 每個訂用帳戶 | 60 | 50 |
大小限制
名稱 | 限制 |
---|---|
電子郵件中的收件者數目 | 50 |
電子郵件要求大小總計 (包括附件) | 10 MB |
要採取的動作
此沙箱設定是為了協助開發人員開始建置應用程式。 一旦應用程式準備好上線,您便可以逐漸要求增加傳送量。 如果您需要傳送超過比率限制的郵件訊息量,請提交支援要求來提高您想要的傳送限制量。
聊天
大小限制
名稱 | 限制 |
---|---|
電子郵件討論串中的參與者數目 | 250 |
大批參與者 - CreateThread | 200 |
大批參與者 - AddParticipant | 200 |
頁面大小 - ListMessages | 200 |
作業限制量
運算 | 貯體儲存者 | 每 10 秒的限制量 | 每分鐘的限制量 |
---|---|---|---|
建立聊天對話串 | User | 10 | - |
刪除聊天對話串 | User | 10 | - |
更新聊天對話串 | 聊天對話串 | 5 | - |
新增參與者/移除參與者 | 聊天對話串 | 10 | 30 |
取得聊天對話串/列出聊天對話串 | User | 50 | - |
取得聊天訊息 | 使用者和聊天對話串 | 50 | - |
取得聊天訊息 | 聊天對話串 | 250 | - |
列出聊天訊息 | 使用者和聊天對話串 | 50 | 200 |
列出聊天訊息 | 聊天對話串 | 250 | 400 |
取得讀取回條 | 使用者和聊天對話串 | 5 | - |
取得讀取回條 | 聊天對話串 | 250 | - |
列出聊天對話串參與者 | 使用者和聊天對話串 | 10 | - |
列出聊天對話串參與者 | 聊天對話串 | 250 | - |
傳送訊息/更新訊息/刪除訊息 | 聊天對話串 | 10 | 30 |
傳送讀取回條 | 使用者和聊天對話串 | 10 | 30 |
傳送輸入指標 | 使用者和聊天對話串 | 5 | 15 |
傳送輸入指標 | 聊天對話串 | 10 | 30 |
語音和視訊通話
通話最大限制量
名稱 | 限制 |
---|---|
參與者數 | 350 |
通話 SDK 串流支援
通訊服務的通話 SDK 支援下列串流設定:
限制 | Web | Windows/Android/iOS |
---|---|---|
您可以同時傳送的最大傳出本機串流數目 | 一支影片或一個螢幕共用 | 一支影片 + 一個螢幕共用 |
您可以同時轉譯呈現的最大傳入遠端串流數目 | 四支影片 + 一個螢幕共用 | 六支影片 + 一個螢幕共用 |
雖然通話 SDK 不會強制執行這些限制,但如果您的使用者超過這些限制,可能會導致效能降低。
通話 SDK 逾時
下列逾時適用於通訊服務通話 SDK:
動作 | 逾時 (秒) |
---|---|
重新連線/移除參與者 | 120 |
從通話 (開始/停止視訊或螢幕共用) 新增或移除新形式 | 40 |
通話轉接作業逾時 | 60 |
1:1 通話建立逾時 | 85 |
群組通話建立逾時 | 85 |
PSTN 通話建立逾時 | 115 |
將 1:1 通話升階為群組通話逾時 | 115 |
要採取的動作
如需語音和視訊通話 SDK 和服務的詳細資訊,請參閱通話 SDK 概觀頁面或已知問題。
Teams 互通性和 Microsoft Graph
使用 Teams 互通性實務範例時,您可能會使用一些 Microsoft Graph API 來建立會議。
透過 Microsoft Graph 所提供的每一個服務都有不同的限制;服務特定的限制會在這裡地更詳細地說明。
要採取的動作
實作錯誤處理時,請使用 HTTP 錯誤碼 429 來偵測用戶端節流。 失敗的回應包括 Retry-After
回應標頭。 使用 Retry-After
延遲來暫停要求,是從節流中復原的最快方式,因為 Microsoft Graph 會在用戶端處於節流狀態時持續記錄資源使用量。
您可以在 Microsoft Graph 文件中找到 Microsoft Graph 節流限制的詳細資訊。
網路周遊
作業 | 時間範圍 (秒) | 限制 (要求數目) |
---|---|---|
核發 TURN 認證 | 5 | 30000 |
發出轉寄組態 | 5 | 30000 |
要採取的動作
建議您先取得權杖,再啟動其他異動,例如建立轉寄連線。
如需詳細資訊,請參閱網路周遊概念概觀頁面。
下一步
請參閱說明及支援選項。