Перейти к содержимому
Продукты

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. Свободное место на диске смотрите в разделе Состояние.