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. Забагато запитів у разі перевищення обмежень.	Застосовується для циклів 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 на основі захисту послуг

Примітка

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

Проходження опитування займе близько семи хвилин. Персональні дані не збиратимуться (декларація про конфіденційність).