Документация › Changelog › Registry v2.2
Релиз
Registry API v2.2: bulk-операции, фильтр по тегам
Обновление Registry API добавляет пакетные операции над устройствами и заявками. Раньше массовое обновление инвентаря требовало одного запроса на объект, что упиралось в лимит 200 RPS на токен.
Новое
POST /v2/registry/devices/bulk— до 500 объектов за запрос, ответ с построчным статусом.PATCH /v2/registry/requests/bulk— смена статуса и исполнителя пачкой.- Параметр
?tags=с поддержкойAND/ORи отрицания через!. - Поле
updated_sinceдля инкрементальной синхронизации внешних CMDB.
curl -X POST https://api.—/v2/registry/devices/bulk \
-H "Authorization: Bearer $ATLAS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"op":"patch","items":[{"id":"dev_8812","tags":["byod","msk"]}]}'
На что обратить внимание
- Пакетный запрос всегда возвращает
207 Multi-Status— проверяйте статус каждого элемента, а не код ответа. - Частичный отказ не откатывает успешные элементы; повторный вызов идемпотентен по
Idempotency-Key. - Bulk-запросы учитываются в квоте как 10 обычных.
Клиентские SDK версии 3.2 уже содержат методы
devices.bulk_patch() и requests.bulk_patch(). Отдельного обновления схемы OpenAPI не требуется — она подтягивается автоматически.