Обновление медиасервера

У медиасерверов есть поля, которые нужны только для определённого типа медиасервера.

Для media_server_v2 это: storages и token

Для flussonic это: proxy

Поле has_cache только для flussonic (для других медиасерверов оно будет null). Оно не устанавливается с API, а получает данные от медиасервера. Токен будет менять только в том случае, если его прислать в запросе.

CODE

Если на сервере есть потоки, то поменять можно только следующие поля:
is_enabled,
streams_limit,
bitrate_limit,
schema,
is_stream_condition_management_enabled,
is_need_to_enable_disabled_streams

Если будут присылаться другие поля, они будут игнорироваться.

PUT /api/admin/v1/servers/{server}

Параметры метода

int server, уникальный идентификатор Медиасервера

string type, тип сервера

array storages, массив хранилищ

string internal_domain, адрес, по которому будут обращаться к API медиасервера

string external_domain, адрес, по которому клиенты будут получать стримы, скриншоты и архивы

int internal, внутренний порт

int external, внешний порт

int rtsp, rtsp порт

bool is_enabled, включить распределение

string proxy, адрес прокси, только для flussonic, это нужно чтобы скачать preview и архив могли только пользователи платформы

string group_type, группа

int streams_limit, лимит количества потоков

int bitrate_limit, лимит входящего трафика, Кбит/с

string token, токен для доступа к медиасерверу. Обрабатывается только для серверов с типом media_server_v2

string schema, URL схема

bool is_stream_condition_management_enabled, нужно ли включать функционал

bool is_need_to_enable_disabled_streams, нужно ли включить отключенные стримы , которые находятся на этом медиасервере.

Будет обрабатываться в случае, если изменяется is_stream_condition_management_enabled с true на false и к медиасерверу относятся стримы

200 OK

Успешный ответ

JSON

{
    "id": 3,
    "type": "media_server_v2",
    "schema": "https",
    "internal_domain": "host-name-3.vms.local",
    "external_domain": "host-name-3.vms.local",
    "domain": "host-name-3.vms.local",
    "internal": "8080",
    "external": "8443",
    "rtsp": "5554",
    "traffic_in": 1960,
    "traffic_out": 0,
    "status": true,
    "is_enabled": true,
    "has_cache": false,
    "proxy": "host-name-3.vms.local",
    "created_at": "2022-12-06 20:20:50",
    "updated_at": "2022-12-26 14:19:43",
    "group_type": "all",
    "can_delete": false,
    "streams_limit": 100,
    "bitrate_limit": 1000000,
    "extra": {
        "io": {
            "read_rate": 0,
            "read_bytes": 0,
            "write_rate": 0,
            "write_bytes": 0
        },
        "cpu": {
            "total": 33,
            "usage": 3,
            "stime_sec": 3531,
            "utime_sec": 3531
        },
        "mem": {
            "rss": 89370624,
            "share": 9932800,
            "usage": 2443603968
        },
        "net": {
            "in_bitrate": 2006784,
            "out_bitrate": 0
        },
        "drives": {
            "/": {
                "fs": "ext4",
                "mount": "/",
                "inode_free": 1479423,
                "inode_total": 1605632,
                "capacity_free": 18977148928,
                "capacity_total": 25713446912
            },
            "/boot": {
                "fs": "ext4",
                "mount": "/boot",
                "inode_free": 65220,
                "inode_total": 65536,
                "capacity_free": 806346752,
                "capacity_total": 1020702720
            },
            "/storage": {
                "fs": "ext4",
                "mount": "/storage",
                "inode_free": 32767681,
                "inode_total": 32768000,
                "capacity_free": 518499958784,
                "capacity_total": 527298822144
            }
        },
        "server": {
            "ip4": "192.168.200.17",
            "name": "MS-21.03.3-lts-rc-3",
            "build": "caeb03b",
            "uptime": 247945,
            "startat": 1670595943,
            "version": "21.03.3",
            "hostname": "host-name-3.vms.local",
            "revision": "lts-rc-3",
            "timestamp": "20221129093237"
        },
        "cluster": {
            "id": "2",
            "node": "5",
            "enable": "true",
            "hostname": "host-name-3.vms.local"
        },
        "license": {
            "type": "enterprise",
            "issued": 4102433999
        },
        "streams": {
            "total": 18,
            "active": 2,
            "clients": 0
        },
        "storages": {
            "/storage": {
                "fs": "",
                "err": 0,
                "name": "default",
                "mount": "/storage",
                "inode_free": 32767681,
                "inode_total": 32768000,
                "capacity_free": 518499958784,
                "capacity_total": 527298822144
            }
        }
    },
    "storages": [
        {
            "id": 3,
            "server_id": 3,
            "path": "/storage",
            "usage": "1.669",
            "is_confirmed": 1,
            "can_delete": false,
            "created_at": "2022-12-06 20:20:50",
            "updated_at": "2022-12-12 14:18:08"
        }
    ],
    "cluster": {
        "id": 4,
        "name": "cluster 2",
        "type": "main_secondary",
        "internal": null,
        "external": null,
        "rtsp": null,
        "streams_limit": null,
        "bitrate_limit": null,
        "created_at": "2022-12-16 10:25:53",
        "updated_at": "2022-12-16 10:25:53",
        "pack": null
    },
    "is_editable": true,
    "is_stream_condition_management_enabled": false,
    "is_have_incorrect_cameras": true
}

401 Unauthorized

Токен авторизации не передан или не валидный Получение токена

cURL

BASH

curl -k --request POST \
	--url 'https://your-domain/api/admin/v1/servers/{server}' \
	--header 'Content-Type: application/json' \
	--header 'Accept: application/json' \
	--data '{
    "server": 0,
    "type": "string",
    "storages": [],
    "internal_domain": "string",
    "external_domain": "string",
    "internal": 0,
    "external": 0,
    "rtsp": 0,
    "is_enabled": true,
    "proxy": "string",
    "group_type": "string",
    "streams_limit": 0,
    "bitrate_limit": 0,
    "token": "string",
    "schema": "string",
    "is_stream_condition_management_enabled": true,
    "is_need_to_enable_disabled_streams": true
}'

PHP

$data = array (
  'server' => 0,
  'type' => 'string',
  'storages' => 
  array (
  ),
  'internal_domain' => 'string',
  'external_domain' => 'string',
  'internal' => 0,
  'external' => 0,
  'rtsp' => 0,
  'is_enabled' => true,
  'proxy' => 'string',
  'group_type' => 'string',
  'streams_limit' => 0,
  'bitrate_limit' => 0,
  'token' => 'string',
  'schema' => 'string',
  'is_stream_condition_management_enabled' => true,
  'is_need_to_enable_disabled_streams' => true,
);
$context = stream_context_create([
	'ssl'=>['verify_peer' => false],
	'http' => [
		'method' => 'PUT',
		'header' => "Content-Type: application/json\r
Accept: application/json",
		'content'=>json_encode($data)
	]
]);
$result = file_get_contents('https://your-domain/api/admin/v1/servers/{server}', false, $context);