API de almacenamientos
Un almacenamiento es un directorio del servidor donde Alta graba el archivo de los canales. Un canal usa un almacenamiento mediante su campo storage. Más información sobre la configuración en Gestión del almacenamiento.
Todas las solicitudes de esta página están disponibles solo para el rol admin.
Objeto de almacenamiento
Sección titulada «Objeto de almacenamiento»{ "id": "archive", "duration": 48, "local": "/var/lib/alta/archive", "save_preview": true}- id: ID del almacenamiento. Solo en la solicitud de creación.
- duration: duración del archivo en horas. Obligatorio.
- local: ruta absoluta al directorio del archivo en el servidor. Envíela en cada solicitud de creación y actualización.
- save_preview (opcional): guarda clips de vista previa MP4 para transmisiones con video H.264 y H.265.
Crear un almacenamiento
Sección titulada «Crear un almacenamiento»POST /api/ott/storageEjemplo:
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}'Devuelve 204, o 409 si ya existe un almacenamiento con este ID.
Obtener un almacenamiento
Sección titulada «Obtener un almacenamiento»GET /api/ott/storage?id=<storage_id>Devuelve el objeto de almacenamiento sin el campo id, o 404.
Actualizar un almacenamiento
Sección titulada «Actualizar un almacenamiento»PUT /api/ott/storage?id=<storage_id>Envíe el objeto completo.
- Un nuevo valor de
durationosave_previewse aplica de inmediato a los canales que usan el almacenamiento. - Un nuevo valor de
localdetiene los canales del almacenamiento, mueve el almacenamiento al nuevo directorio y vuelve a iniciar los canales. Alta no copia el archivo antiguo y elimina el archivo de los canales del directorio anterior.
Devuelve 204, o 404.
Eliminar un almacenamiento
Sección titulada «Eliminar un almacenamiento»DELETE /api/ott/storage?id=<storage_id>Antes de eliminar un almacenamiento, quítelo de los canales con Actualizar un canal: envíe el canal sin el campo storage. Un canal no debe hacer referencia a un almacenamiento que no existe.
Devuelve 204, o 404.
Estado del almacenamiento
Sección titulada «Estado del almacenamiento»GET /api/ott/storage/statusDevuelve el tamaño de cada almacenamiento y del archivo de cada variante de canal. Úselo para obtener la lista de ID de almacenamientos y para encontrar los canales que graban.
Respuesta:
{ "storages": { "archive": { "size": 52428800000 } }, "channels": { "news/main": { "storage": "archive", "size": 5242880000, "duration": 172800, "diskFull": 0 } }}- storages: tamaño del archivo en bytes de cada almacenamiento.
- channels: archivo de cada variante que graba.
- storage: ID del almacenamiento.
- size: tamaño en bytes.
- duration: duración grabada en segundos.
- diskFull:
1cuando el espacio libre en disco está por debajo del umbral, de lo contrario0.
Umbral de espacio en disco
Sección titulada «Umbral de espacio en disco»PUT /api/ott/storagecommonsettingsDefine el espacio libre en disco por debajo del cual los canales pasan a la grabación circular. Más información en Gestión del almacenamiento.
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: umbral en megabytes. Obligatorio.
Devuelve 204. Para consultar el espacio libre del disco, lea Estado.