logoric
Попробовать
LOGORIC / KNOWLEDGE

Инструкции и шаблоны

Настройка каждого раздела, проверка результата и готовые сценарии для вашего проекта.

Настройка · Руководство на русском

Maintenance: плановые работы через API

В текущей версии окна maintenance управляются REST API; отдельной формы в интерфейсе нет. Нужна роль admin/owner.

Порядок настройки

  1. Создайте control API key с write scope. Возьмите organization_id и service_id своих ресурсов; source token для этого не подходит.
  2. Выполните POST /api/v1/organizations/ORG/maintenance с name и data: service_id, starts_at, ends_at в ISO8601. Конец должен быть позже начала.
  3. Проверьте сохранённое окно через GET того же endpoint. Перед началом подтвердите часовой пояс в самих timestamp; пример использует UTC Z.
  4. Для отмены используйте DELETE /maintenance/ID. После окончания проверьте heartbeat, новые агрегаты, состояние правила и доставки.
{"name":"Scheduled database upgrade","data":{"service_id":"SERVICE_ID","starts_at":"2026-11-01T01:00:00Z","ends_at":"2026-11-01T01:30:00Z"}}

Ожидаемый результат

Окно сохранено для конкретного сервиса; плановое подавление наблюдается в данных инцидента/доставки.

Если не получается

400 invalid_maintenance_window — проверьте формат/порядок времени. 404 — сервис из другой организации или неверный ID.