Create a Stream

Creates a stream either to the specified IP address and port, or when re-streaming multisource videos, to a destinations list.

Note

For multi-source videos, the address and port are ignored, and a destinations list must be present.

Authorizations: Recordings - STREAM

Requests

Stream

POST /apis/assets/:id/streams

{
  "address": "239.134.32.100",
  "port": 4900
}

Multi-Source Video

POST /apis/assets/:id/streams

{
   "address": "ignored",
   "port": 1,
   "destinations": [{
     "trackId": 3,
     "address": "239.134.32.100",
     "port": 4900
   }, {
     "trackId": 4,
     "address": "239.134.32.100",
     "port": 4901
   }]
}

Response

Success

Stream

{
  "data": {
    "address": "239.134.32.100",
    "port": 4900,
    "asset": "a907804b-d6d5-4328-9bd6-5aca9abbac8c",
    "username": "haiadmin",
    "id": "5e33bc64-4ff7-47aa-a7d6-562b35a9c4aa"
  }
}

Multi-Source Video

{
  "data": {
    "address": "239.134.32.100",
    "port": 4900,
    "asset": "a907804b-d6d5-4328-9bd6-5aca9abbac8c",
    "username": "haiadmin",
    "id": "5e33bc64-4ff7-47aa-a7d6-562b35a9c4aa",
     "destinations": [{
       "trackId": 3,
       "address": "239.134.32.100",
       "port": 4900
     }]
  }
}

Note

For multiple destinations, address and port are overwritten respectively to multiple and 0.

Error

Code	Payload	Description
400	{"code":"010005", "name":"MultiSourcesStream", "message":"Multi-Source recordings must have a destination list", "httpStatusCode":400}	You must provide a list of destinations for videos that contain multiple sources. You cannot just provide a list of IP addresses.
400	{"code":"010006", "name":"AddressPortAlreadyInUse", "message":"Address or port already in use", "httpStatusCode":400}	The system is already streaming to the specified IP address or port.
400	{"code":"010006", "name":"AddressPortAlreadyInUse", "message":"Address or port already in use by a source", "httpStatusCode":400}	The system is already configured to use a Source with the specified IP address or port.
400	{"code":"010001", "name":"InputValidation", "message":<Error message>, "httpStatusCode":400}	Supplied data was insufficient or incorrect.
404	{"code":"040002", "name":"AssetNotFound", "message":"Video not found", "httpStatusCode":404}	Video with UUID `Id` not found.