API хранилищ
Хранилище — это каталог на сервере, в котором Alta записывает архив каналов. Канал использует хранилище через поле storage. Подробнее о настройках в разделе Управление хранилищем.
Все запросы этой страницы доступны только роли admin.
Объект хранилища
Заголовок раздела «Объект хранилища»{ "id": "archive", "duration": 48, "local": "/var/lib/alta/archive", "save_preview": true}- id: ID хранилища. Только в запросе создания.
- duration: длительность архива в часах. Обязательное поле.
- local: абсолютный путь к каталогу архива на сервере. Передавайте его в каждом запросе создания и изменения.
- save_preview (необязательный): сохранять MP4-превью для потоков с видео H.264 и H.265.
Создание хранилища
Заголовок раздела «Создание хранилища»POST /api/ott/storageПример:
curl -sS -X POST -H "Authorization: Bearer $TOKEN" \ -H 'Content-Type: application/json' \ 'http://alta.example.com:8100/api/ott/storage' \ -d '{"id": "archive", "duration": 48, "local": "/var/lib/alta/archive", "save_preview": true}'Возвращает 204 или 409, если хранилище с таким ID существует.
Получение хранилища
Заголовок раздела «Получение хранилища»GET /api/ott/storage?id=<storage_id>Возвращает объект хранилища без поля id или 404.
Изменение хранилища
Заголовок раздела «Изменение хранилища»PUT /api/ott/storage?id=<storage_id>Передайте объект целиком.
- Новое значение
durationилиsave_previewсразу применяется к каналам, которые используют хранилище. - Новое значение
localостанавливает каналы хранилища, переносит хранилище в новый каталог и снова запускает каналы. Alta не копирует старый архив и удаляет архив каналов из старого каталога.
Возвращает 204 или 404.
Удаление хранилища
Заголовок раздела «Удаление хранилища»DELETE /api/ott/storage?id=<storage_id>Перед удалением хранилища уберите его из каналов через Изменение канала: передайте канал без поля storage. Канал не должен ссылаться на несуществующее хранилище.
Возвращает 204 или 404.
Состояние хранилища
Заголовок раздела «Состояние хранилища»GET /api/ott/storage/statusВозвращает размер каждого хранилища и архива каждого варианта канала. Используйте этот запрос, чтобы получить список ID хранилищ и найти каналы, которые записываются.
Ответ:
{ "storages": { "archive": { "size": 52428800000 } }, "channels": { "news/main": { "storage": "archive", "size": 5242880000, "duration": 172800, "diskFull": 0 } }}- storages: размер архива в байтах для каждого хранилища.
- channels: архив каждого варианта, который записывается.
- storage: ID хранилища.
- size: размер в байтах.
- duration: записанная длительность в секундах.
- diskFull:
1, когда свободное место на диске ниже порога, иначе0.
Порог свободного места
Заголовок раздела «Порог свободного места»PUT /api/ott/storagecommonsettingsЗадаёт объём свободного места на диске, ниже которого каналы переключаются на циклическую запись. Подробнее в разделе Управление хранилищем.
curl -sS -X PUT -H "Authorization: Bearer $TOKEN" \ -H 'Content-Type: application/json' \ 'http://alta.example.com:8100/api/ott/storagecommonsettings' \ -d '{"disk_space_threshold_mb": 10240}'- disk_space_threshold_mb: порог в мегабайтах. Обязательное поле.
Возвращает 204. Свободное место на диске смотрите в разделе Состояние.