Saltearse al contenido
Productos

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.

{
"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.
Ventana de terminal
POST /api/ott/storage

Ejemplo:

Ventana de terminal
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.

Ventana de terminal
GET /api/ott/storage?id=<storage_id>

Devuelve el objeto de almacenamiento sin el campo id, o 404.

Ventana de terminal
PUT /api/ott/storage?id=<storage_id>

Envíe el objeto completo.

  • Un nuevo valor de duration o save_preview se aplica de inmediato a los canales que usan el almacenamiento.
  • Un nuevo valor de local detiene 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.

Ventana de terminal
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.

Ventana de terminal
GET /api/ott/storage/status

Devuelve 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: 1 cuando el espacio libre en disco está por debajo del umbral, de lo contrario 0.
Ventana de terminal
PUT /api/ott/storagecommonsettings

Define 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.

Ventana de terminal
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.