2.4 KiB
2.4 KiB
Contract: Hardware Ingest JSON
Version: 2.10
Source: bee/bible-local/docs/hardware-ingest-contract.md (canonical upstream)
Стандартный JSON-контракт для передачи данных об аппаратном обеспечении серверов в Reanimator.
Используется в bee, logpile, core и внешних интеграторах (Redfish-коллекторы, CMDB-экспортёры).
Актуальная версия: https://git.mchus.pro/reanimator/core/src/branch/main/bible-local/docs/hardware-ingest-contract.md
Принципы
- Snapshot — JSON описывает состояние сервера на момент сбора. Может включать историю изменений статуса.
- Идемпотентность — повторная отправка идентичного payload не создаёт дублей (дедупликация по хешу).
- Частичность — можно передавать только те секции, данные по которым доступны. Пустой массив и отсутствие секции эквивалентны.
- Строгая схема — endpoint использует строгий JSON-декодер; неизвестные поля приводят к
400 Bad Request. - Event-driven — импорт создаёт события в timeline (LOG_COLLECTED, INSTALLED, REMOVED, FIRMWARE_CHANGED и др.).
- Без синтеза — сборщик передаёт только фактически собранные значения. Запрещено придумывать
serial_number,component_ref,message,message_idили иные идентификаторы, если источник их не предоставил.
Endpoint
POST /ingest/hardware
Content-Type: application/json
Ответ 202 Accepted с job_id. Результат: GET /ingest/hardware/jobs/{job_id}.