Pular para o conteúdo
Produtos

API de armazenamentos

Um armazenamento é um diretório no servidor onde o Alta grava o arquivo dos canais. Um canal usa um armazenamento por meio do campo storage. Saiba mais sobre as configurações em Gerenciamento de armazenamento.

Todas as requisições desta página estão disponíveis apenas para a função admin.

{
"id": "archive",
"duration": 48,
"local": "/var/lib/alta/archive",
"save_preview": true
}
  • id: ID do armazenamento. Somente na requisição de criação.
  • duration: Duração do arquivo em horas. Obrigatório.
  • local: Caminho absoluto do diretório do arquivo no servidor. Envie-o em toda requisição de criação e de atualização.
  • save_preview (opcional): Salva clipes de preview em MP4 para streams com vídeo H.264 e H.265.
Terminal window
POST /api/ott/storage

Exemplo:

Terminal window
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}'

Retorna 204, ou 409 se já existir um armazenamento com este ID.

Terminal window
GET /api/ott/storage?id=<storage_id>

Retorna o objeto do armazenamento sem o campo id, ou 404.

Terminal window
PUT /api/ott/storage?id=<storage_id>

Envie o objeto completo.

  • Um novo duration ou save_preview é aplicado imediatamente aos canais que usam o armazenamento.
  • Um novo local interrompe os canais do armazenamento, move o armazenamento para o novo diretório e inicia os canais novamente. O Alta não copia o arquivo antigo e remove o arquivo dos canais do diretório antigo.

Retorna 204, ou 404.

Terminal window
DELETE /api/ott/storage?id=<storage_id>

Antes de excluir um armazenamento, remova-o dos canais com Atualizar um canal: envie o canal sem o campo storage. Um canal não deve referenciar um armazenamento que não existe.

Retorna 204, ou 404.

Terminal window
GET /api/ott/storage/status

Retorna o tamanho de cada armazenamento e do arquivo de cada variante de canal. Use-o para obter a lista de IDs de armazenamentos e para encontrar os canais que estão gravando.

Resposta:

{
"storages": {
"archive": { "size": 52428800000 }
},
"channels": {
"news/main": { "storage": "archive", "size": 5242880000, "duration": 172800, "diskFull": 0 }
}
}
  • storages: Tamanho do arquivo em bytes de cada armazenamento.
  • channels: Arquivo de cada variante que está gravando.
    • storage: ID do armazenamento.
    • size: Tamanho em bytes.
    • duration: Duração gravada em segundos.
    • diskFull: 1 quando o espaço livre em disco está abaixo do limite, caso contrário 0.
Terminal window
PUT /api/ott/storagecommonsettings

Define o espaço livre em disco abaixo do qual os canais passam para a gravação circular. Saiba mais em Gerenciamento de armazenamento.

Terminal window
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: Limite em megabytes. Obrigatório.

Retorna 204. Para o espaço livre do disco, leia Status.