Руководство по регулированию API для Azure Data Manager для сельского хозяйства
Регулирование ограничивает количество запросов к службе в течение периода времени, чтобы предотвратить чрезмерное использование ресурсов. Регулирование REST API в Azure Data Manager для сельского хозяйства обеспечивает более согласованную производительность в течение определенного периода времени для клиентов, которые вызывают API-интерфейсы службы.
Диспетчер данных Azure для сельского хозяйства может обрабатывать большой объем запросов. Если подавляющее количество запросов происходит от нескольких клиентов, регулирование помогает обеспечить оптимальную производительность и надежность для всех клиентов.
Ограничения регулирования зависят от выбранной версии и возможностей продукта, используемого клиентом. Azure Data Manager для сельского хозяйства поддерживает две разные версии:
- Стандартный: версия, которую мы обычно рекомендуем.
- Базовый: подходит для требований к прототипу.
Эти ограничения работают в течение трех часов (за одну минуту, за пять минут и в месяц) для защиты от внезапных всплесков трафика.
В этой статье показано, как отслеживать количество оставшихся запросов, прежде чем достичь предела, и как реагировать при достижении предела. Ограничения регулирования применяются к этим API.
Классификация API
API-интерфейсы Azure Data Manager для сельского хозяйства делятся на три основные категории:
- Операции записи: API, использующие такие методы REST API, как
PATCH,POSTиDELETEдля изменения данных. - Операции чтения: API, использующие тип
GETметода REST API для извлечения данных, включая API поиска типаPOSTметода. - Длительные операции задания: длительные api асинхронного задания, использующие тип
PUTметода REST API.
Общие доступные единицы квоты, как описано в следующей таблице, являются общими для этих категорий. Например, использование всей квоты для операций записи означает отсутствие оставшейся квоты для других операций. Каждая операция использует определенную единицу квоты, которая помогает отслеживать оставшуюся квоту для дальнейшего использования.
| Операция | Затраты на единицу для каждого запроса |
|---|---|
| Write | 5 |
| Читать | 1 1 |
| Длительное задание: вывод решения | 5 |
| Длительное задание: операция фермы | 5 |
| Длительное задание: растеризация изображений | 2 |
| Длительное задание: каскадное удаление сущности | 2 |
| Длительное задание: прием погоды | 1 |
| Длительное выполнение задания: прием спутниковых данных | 1 |
1Дополнительная плата за единицу учитывается для каждого элемента, возвращаемого в ответе при извлечении нескольких элементов.
Ограничения API для базовой версии
В следующей таблице перечислены общие доступные единицы для каждой категории для базовой версии:
| Операция | Период времени регулирования | Единицы сброса после каждого периода времени |
|---|---|---|
| Запись и чтение | За одну минуту | 25,000 |
| Запись и чтение | За пять минут | 100,000 |
| Запись и чтение | За один месяц | 5 000 000 |
| Длительное задание | За пять минут | 1000 |
| Длительное задание | За один месяц | 100,000 |
Ограничения API для стандартной версии
Стандартная версия предлагает пятикратное увеличение квоты API в месяц по сравнению с базовой версией. Все остальные ограничения квот остаются неизменными.
В следующей таблице перечислены общие доступные единицы для каждой категории для стандартной версии:
| Операция | Период времени регулирования | Единицы сброса после каждого периода времени |
|---|---|---|
| Запись и чтение | За одну минуту | 25,000 |
| Запись и чтение | За пять минут | 100,000 |
| Запись и чтение | За один месяц | 25 000 000 1 |
| Длительное задание | За пять минут | 1000 |
| Длительное задание | За один месяц | 500 000 1 |
1Это ограничение составляет пять раз, чем ограничение базовой версии.
Код ошибки
По достижении ограничения отображается код состояния HTTP 429 — слишком много запросов. Ответ содержит значение Retry-After , указывающее количество секунд, которое должно ожидать (или спящее) приложение перед отправкой следующего запроса.
Если вы отправляете запрос до истечения значения повторных попыток, запрос не обрабатывается и возвращается новое значение повтора. По истечении указанного времени вы можете повторить запросы к Azure Data Manager для сельского хозяйства. При попытке установить TCP-подключение или использовать различные методы проверки подлинности пользователей эти ограничения не обходятся, так как они относятся к каждому клиенту.
Часто задаваемые вопросы
Если квота выделенного API полностью исчерпана для операций записи в течение минутного периода времени, можно ли успешно выполнять запросы на операции чтения в течение одного и того же периода времени?
Ограничения квоты разделяются между перечисленными категориями операций. Использование всей квоты для операций записи не подразумевает оставшейся квоты для других операций. В этой статье подробно описаны единицы квоты, используемые для каждой операции.
Как вычислить общее количество успешных запросов, разрешенных для определенного периода времени?
Общее число успешных запросов API зависит от подготовленной версии и периода времени выполнения запросов.
Например, с стандартной версией можно сделать 25 000 (единицы сброса после каждого периода времени) / 5 (затраты на единицу для каждого запроса) = 5000 API операций записи в течение одного минутного периода времени. Или можно использовать сочетание 4000 операций записи и 5000 операций чтения, что приводит к 4000 * 5 + 5 000 * 1 = 25 000 общих единиц потребления.
Аналогичным образом, для базовой версии можно выполнить 5 000 000 единиц (сброс единиц после каждого периода времени) / 1 (затраты на единицу для каждого запроса) = 5 000 000 API операций чтения в течение одного месяца.
Сколько событий датчика может получать клиент в качестве максимального числа?
Система обеспечивает не более 100 000 приемов событий в час. Хотя новые события постоянно принимаются, может возникнуть задержка в обработке. Задержка может означать, что эти события не сразу доступны для сценариев исходящего трафика в режиме реального времени вместе с приемом.