TransferStream

Transfer a stream with archive from one server to another

The stream configuration with the same ID must be created on both the current and target nodes.

POST /api/streams/{stream-uid}/transfer/

Body
json	JSON `{ "stream_config": "", "current_primary": "hostname-1", "current_secondary": [ "hostname-2", "hostname-3" ], "target_primary": "hostname-4", "target_secondary": [ "hostname-5", "hostname-6" ], "is_save_current": true }`
stream-uid^optional	uid	Unique identifier of the stream {@hint:uid}
token^required	string	Authorization token for API requests. see Mediaserver/Web API/Authorization/CreateApiToken
stream_config^optional	str
target_primary^optional	str
current_secondary^optional	array
target_primary^optional	str
target_secondary^optional	array
is_save_current^optional	bool

Response
200		Returns the UID of the stream
JSON `{ "uid": "0a20f93c-d370-4107-8548-97bb64c53ed2" }`
404		Stream with such UID not found
403		Authorization error. Invalid or missing API access token. see Mediaserver/Web API/Authorization/CreateApiToken for details.

Example

JSON

curl -k --location --request POST 'https://localhost:8080/api/streams/{stream-uid}/transfer/?token=string' \
--header 'Content-Type: application/json \
--data-raw '{
    "stream_config": "",
    "current_primary": "hostname-1",
    "current_secondary": [
        "hostname-2",
        "hostname-3"
    ],
    "target_primary": "hostname-4",
    "target_secondary": [
        "hostname-5",
        "hostname-6"
    ],
    "is_save_current": true
}'