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.
Objeto de armazenamento
Seção intitulada “Objeto de armazenamento”{ "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.
Criar um armazenamento
Seção intitulada “Criar um armazenamento”POST /api/ott/storageExemplo:
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.
Obter um armazenamento
Seção intitulada “Obter um armazenamento”GET /api/ott/storage?id=<storage_id>Retorna o objeto do armazenamento sem o campo id, ou 404.
Atualizar um armazenamento
Seção intitulada “Atualizar um armazenamento”PUT /api/ott/storage?id=<storage_id>Envie o objeto completo.
- Um novo
durationousave_previewé aplicado imediatamente aos canais que usam o armazenamento. - Um novo
localinterrompe 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.
Excluir um armazenamento
Seção intitulada “Excluir um armazenamento”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.
Status do armazenamento
Seção intitulada “Status do armazenamento”GET /api/ott/storage/statusRetorna 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:
1quando o espaço livre em disco está abaixo do limite, caso contrário0.
Limite de espaço em disco
Seção intitulada “Limite de espaço em disco”PUT /api/ott/storagecommonsettingsDefine o espaço livre em disco abaixo do qual os canais passam para a gravação circular. Saiba mais em Gerenciamento de armazenamento.
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.