Microsoft DataverseОгляд обмежень API

Обмеження API Dataverse допомагають забезпечити рівні обслуговування, а також доступність та якість послуг. Обмеження API Dataverse є частиною обмежень та розподілів запитів Power Platform. У цій статті наведено обмеження саме для Dataverse, які застосовуються до Power Apps, Power Automate і програм взаємодії із клієнтами (Dynamics 365 Sales, Dynamics 365 Customer Service, Dynamics 365 Field Service, Dynamics 365 Marketing і Dynamics 365 Project Service Automation), що підключаються до Dataverse.

Для отримання інформації про ліміти для всіх областей Power Platform в межах дивіться Power Platform статтю Запит лімітів і розподілів.

Існує дві категорії обмежень, які застосовуються для Dataverse: Обмеження прав і Ліміти захисту Послуг, як коротко описано нижче.

Обмеження для захисту служби	Обмеження на запити до Power Platform (право на використання API)
Негайно повертайте 429 Too Many Requests при перевищенні лімітів.	Застосовується для циклів Power Automate, але допускається для періодичних перевищень у Dataverse
Оцінюється за 5-хвилинне рухоме вікно.	Оцінюється за 24-годинний період.
Застосовуються до всіх зовнішніх запитів до веб-служб Dataverse.	Застосовується до всіх обчислювальних та аналітичних операцій, які походять із внутрішніх або зовнішніх запитів.
Розробник відповідає за уникнення умов, які можуть спричинити помилки, і організацію повторних спроб у разі їх виникнення.	Адміністратор відповідає за керування призначеним обсягом. Вони можуть придбати додаткові компоненти обсягу для підвищення обмежень.
Застосовується сьогодні в продукті.	- Застосовуватиметься після загального випуску підготовчої версії адміністративних звітів для відстеження й оцінювання використання. - Підготовча версія звітів уже доступна.
Додаткова інформація: https://aka.ms/serviceprotectionlimits	Додаткова інформація: https://aka.ms/PlatformLimits

Обмеження на основі умов обслуговування

Ці обмеження стосуються кількості запитів, яку користувачі можуть робити щодня. Виділене обмеження залежить від типу ліцензії, призначеної кожному користувачу.

Якщо будь-який користувач перевищить свої права на запит, адміністратор буде повідомлений про це та зможе призначити Power Apps та Power Automate запросити повноваження для цього користувача. На даний момент користувачам не буде заборонено використовувати додатки для періодичних і обґрунтованих перевитрат.

Для Dataverse, запити API включають всі операції з даними, що взаємодіють з рядками таблиць, під час яких рядки створюються отримуються, оновлюються або видаляються (CRUD). Спеціальні операції, такі як спільний доступ і призначення, включені, оскільки вони вважаються оновленнями. Ці запити можуть бути отримані від будь-якого клієнта або програми та використовувати будь-яку кінцеву точку. До них належать, зокрема, операції, що виконуються за допомогою плагінів, асинхронних робочих процесів, користувацьких елементів керування та операцій $batch (ExecuteMultiple). Існує невеликий набір внутрішніх операцій системи, які виключаються, як-от вхід, вихід із системи та операції з метаданими системи.

Важливо

Розподіли запитів API Power Platform включають використання Power Automate, AI Builder та API з’єднувача. Усі запити через з’єднувач, результатом яких є запит Dataverse, будуть представляти 1 запит Power Platform.

Щоб дізнатися більше про ці обмеження прав, перегляньте Microsoft Power Platform статтю Розподіл запитів на основі ліцензій.

Інформацію про перегляд і розподіл додаткових компонентів місткості наведено в статті Додаткові компоненти місткості.

Інформацію про придбання додаткових компонентів для окремих потужностей наведено в Довіднику Power Apps з ліцензування та Power Automate Довіднику з ліцензування.

Обмеження на основі захисту послуг

Щоб забезпечити стабільну доступність та продуктивність для кожного, ми застосовуємо деякі обмеження щодо того, як використовуються API з Dataverse. Обмеження API захисту служб гарантують, що користувачі, які запускають програми, не можуть заважати один одному через обмеження ресурсів. Ліміти не вплинуть на звичайних користувачів платформи. Вони стосуватимуться лише програм, які здійснюють велику кількість запитів API. Такі обмеження забезпечують рівень захисту від випадкових та неочікуваних стрибків у кількості запитів, що загрожують характеристикам доступності та продуктивності платформи Dataverse.

Ми обмежуємо кількість одночасних підключень на обліковий запис користувача, кількість запитів API на підключення, а також кількість часу виконання, яку можна використовувати для кожного з’єднання. Ці показники оцінюються протягом п’ятихвилинного ковзного вікна. У разі перевищення одного із цих обмежень платформа згенерує виняток.

Нотатка

Обмеження для захисту послуг застосовуються до всіх зовнішніх запитів веб-послуг, а не лише до операцій CRUD із таблицями, котрі враховуються в обмеженнях обсягу обслуговування.

Обмеження API захисту служб не застосовуються до викликів API, здійснених у межах робочих процесів, користувацьких дій робочого процесу або коду плагіна. Ці операції викликаються на внутрішньому рівні.

З обмеженнями захисту служб стикаються лише програми, які виконують великий обсяг операцій з даними. Ми рекомендуємо розробникам, які створюють програми, які виконують великий обсяг операцій з даними, застосовувати шаблони для повторних операцій після періоду часу, коли ці винятки повертаються. Застосування цих скоромовок дозволить додатку реагувати на винятки, які надсилає сервіс, і зменшити загальну кількість запитів і досягти максимально можливої пропускної здатності.

Щоб отримати відомості про конкретні помилки, які можна повернути, і про те, як розробники можуть застосовувати шаблони для реагування на ці помилки, перегляньте статтю Обмеження API захисту служб.

Статті за темою:

Адміністрування Power Platform / Ліцензування та управління ліцензіями / Запити, ліміти та розподіл
Розробник / Робота з даними за допомогою коду / Ліміти API захисту сервісів