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

CODE

POST /apis/assets/:assetId/streams
{
  "address": "239.134.32.100",
  "port": 4900
}

Multi-Source Video

CODE

POST /apis/assets/:assetId/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

CODE

{
  "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

CODE

{
  "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.