Поделиться через


Ограничения и шаблоны вызовов

В этом документе описываются ограничения SharePoint Embedded во время общедоступной предварительной версии.

Примечание.

Это предварительные ограничения, которые могут быть изменены.

Ограничения размера

В следующей таблице определены ограничения на размер контейнеров"

Ресурс Ограничение
Типы контейнеров, которые может создать клиент партнера 5*
Типы контейнеров, которыми может владеть приложение 1
Контейнеры типа контейнера на потребляющий клиент 100k*
Хранилище на тип контейнера на потребляющий клиент 100 ТБ*
Файлы и папки на контейнер 30 млн
Хранилище на контейнер 25 ТБ
Файлы и папки с аддитивные разрешения на контейнер 5k
Размер файла 250 ГБ
Количество версий на файл 500 (автоматический параметр ограничений журнала версий по умолчанию)
Количество пользователей, которыми предоставлен общий доступ для каждой папки или файла 5k

Примечание.

Ограничение можно увеличить на запрос.

Регулирование

Шаблоны и рекомендации

Когда приложения достигнут пределов службы, вы получаете код состояния HTTP 429 ("Слишком много запросов"). Вы также можете получить код состояния HTTP 503 ("Сервер слишком занят").

Как правило, ниже приведены рекомендации по регулированию.

  • Уменьшите количество одновременных запросов.
  • Избегайте пиков запросов.
  • Соблюдай Retry-After заголовок HTTP.

В обоих случаях в отклик включается заголовок Retry-After, в котором указывается, сколько вызывающее приложение должно подождать перед повторным или новым запросом. Регулируемые запросы учитываются в отношении ограничений использования, поэтому несоблюдение может привести к большему Retry-After регулированию.

Ограничения скорости API

SharePoint Embedded предоставляет различные API. Разные API имеют разные затраты в зависимости от функциональности и сложности API. Стоимость API нормализуется и выражается единицами ресурсов. Ограничения скорости API также определяются с помощью единиц ресурсов.

Единицы ресурсов на запрос Операции
1 Запрос с одним элементом, например получение элемента
2 Запрос с несколькими элементами, например создание, обновление, удаление и отправка дочерних элементов списка
5 Все операции с ресурсами разрешений, включая $expand=permissions

Примечание.

Мы оставляем за собой право изменить стоимость единицы ресурса API.

В следующей таблице перечислены ограничения скорости API для приложений и контейнеров.

Ресурс Ограничения
Запросы на контейнер 3k единиц ресурсов в минуту
Запросы на приложение на клиента 12k единиц ресурсов в минуту*
Запросы на пользователя 600 единиц ресурсов в минуту

Примечание.

* Для каждого запроса можно увеличить ограничение.

Ограничения приложений определяются в единицах ресурсов, а фактическая скорость запросов, например запросов в минуту, зависит от выбранного API и соответствующей стоимости единицы ресурса. Как правило, можно оценить частоту запросов, в среднем около двух единиц ресурсов на запрос и разделив ограничения на единицу ресурсов приложения на 2. Сокращение использования операций с разрешениями может значительно повысить частоту вызовов, так как эти операции оказывают наиболее значительное влияние на общее потребление ресурсов.