Microsoft DataverseAPI 限制概觀
Dataverse API 限制有助於確保服務等級、可用性和品質。 Dataverse API 限制是 Power Platform 要求限制和配置的一部分。 本文將介紹 Dataverse 的專屬限制,這些限制適用於連接至 Dataverse 的 Power Apps、 Power Automate和 Customer Engagement 應用程式 (Dynamics 365 Sales、Dynamics 365 Customer Service、Dynamics 365 Field Service、Dynamics 365 Marketing 和 Dynamics 365 Project Service Automation)。
如需有關對 Power Platform 中所有區域之限制的詳細資訊,請參閱 Power Platform 要求限制和配置。
適用於 Dataverse 的限制有兩種類別:權利和服務保護限制,摘要如下。
服務保護限制 | Power Platform 要求 (API 權利) 限制 |
---|---|
當超過限制時,立即傳回 429 要求太多。 | 對 Power Automate 流量強制執行,但在強制執行時,將對 Dataverse 的偶爾超額使用作出規定 |
在 5 分鐘滑動視窗中進行評估。 | 在 24 小時期間進行評估。 |
套用至 Dataverse Web 服務的所有外部要求。 | 套用至源自內部或外部要求的計算作業和分析。 |
開發人員負責避免可能導致錯誤的情況,並在錯誤發生時管理重試。 | 管理員負責管理指派的容量。 他們可以購買容量附加元件以提升限制。 |
今天在產品中強制執行。 | - 將在預覽報告 (今天可供系統管理員追蹤和估計使用情況) 正式推出後強制執行。 - 預覽報告現已可用。 |
其他資訊:https://aka.ms/serviceprotectionlimits | 其他資訊:https://aka.ms/PlatformLimits |
權利限制
這些限制代表使用者每天有權提出要求的次數。 配置的限制取決於指派給每個使用者的授權類型。
如果有任何使用者超出其要求權利,系統管理員將會收到通知,並且可以將 Power Apps 及 Power Automate 要求容量指派該使用者。 使用者此時不會因偶爾且合理的超額使用遭封鎖而無法使用應用程式。
對於 Dataverse,API 要求包括與資料表資料列互動的所有資料作業,包括資料列的建立、檢索、更新或刪除 (CRUD)。 包括共用和指派等特殊作業,因為會將這些作業視為更新。 這些要求可以透過任何用戶端或應用程式以及使用任何端點來發出。 這些作業包括但不限於,外掛程式、非同步工作流程、自訂控制項和 $batch (ExecuteMultiple) 作業所執行的作業。 有一小部分系統內部作業 (例如登入、登出和系統中繼資料作業) 不包括在內。
重要
Power Platform API 要求配置包括 Power Automate、AI Builder和連接器 API 的使用。 所有透過產生 Dataverse 要求之連接器發出的要求都代表 1 個 Power Platform 要求。
如需有關這些權利限制的詳細資訊,請參閱根據授權的 Microsoft Power Platform 要求配置。
如需有關檢視和配置產能附加元件的詳細資訊,請參閱產能附加元件。
如需有關購買個別產能附加元件的詳細資訊,請參閱 Power Apps 和 Power Automate 授權指南。
服務保護限制
為了確保對每個人都有一致的可用性和效能,我們將一些限制套用至 API 與 Dataverse 搭配使用的方式。 服務保護 API 限制有助於確保確保執行應用程式的使用者不會因為資源限制而相互干擾。 這些限制不會影響平台的一般使用者。 只有執行大量 API 要求的應用程式可能會受到影響。 這些限制在要求量隨機且突然大增,並對 Dataverse 平台的可用性和效能特性造成威脅時,提供某種程度的保護。
我們會限制每個使用者帳戶的同時連線數目、每個連線的 API 要求數目,以及每個連線可使用的執行時間量。 這些計量是在五分鐘的滑動時間範圍內進行評估。 超過其中一個限制時,平台將會擲回例外狀況。
注意
服務保護限制會套用至所有外部 Web 服務請求,而不只套用至針對權利限制計數之資料表上的 CRUD 作業。
服務保護 API 限制不會根據工作流程、自訂工作流程活動或外掛程式程式碼中進行的 API 呼叫來套用。 這些是在內部叫用的作業。
只有執行大量資料作業的應用程式,才會遇到服務保護限制。 建議建置執行大量資料作業之應用程式的開發人員在傳回這些例外狀況一段時間後,將模式套用至重試作業。 套用這些模式可讓應用程式回應服務傳送的例外狀況,並減少要求總數,進而達到最高的可能輸送量。
如需有關可傳回的特定錯誤以及開發人員如何套用模式以回應這些錯誤的詳細資訊,請參閱服務保護 API 限制。
請參閱
管理 Power Platform / 授權和授權管理 / 要求限制和配置
開發人員 / 使用程式碼處理資料 / 服務保護 API 限制