Viz Channel Branding User Guide

Version 5.0 | Published July 10, 2023 ©

GET Machine Address

Returns a specific machine address for the channel.

Syntax

GET /config/channels/{channel}/machineaddresses/{address}

Request

GET /config/channels/Test/machineaddresses/localhost HTTP/1.1

Response - Machine Address returned

HTTP/1.1 200 OK
Content-Type: application/vizrt.promoserver+xml; type=machineAddress
<promoserver:machineAddress xmlns:promoserver="http://www.vizrt.com/promoserver">
<promoserver:refLink rel="self" type="application/vizrt.promoserver+xml; type=machineAddress" href="http://localhost:9980/config/channels/Test/machineaddresses/localhost" />
<promoserver:refLink rel="edit" type="application/vizrt.promoserver+xml; type=machineAddress" href="http://localhost:9980/config/channels/Test/machineaddresses/localhost" />
<promoserver:refLink rel="status" type="application/vizrt.promoserver+xml; type=machineAddressStatus" href="http://localhost:9980/config/channels/Test/machineaddresses/localhost/status" />
<promoserver:name>localhost</promoserver:name>
</promoserver:machineAddress>

Error Response - Channel not found

HTTP/1.1 404 Not Found
Content-Type: application/xml; charset=utf-8
<string xmlns="http://schemas.microsoft.com/2003/10/Serialization/">Element Test could not be found</string>

Error Response - Address not found

HTTP/1.1 404 Not Found
Content-Type: application/xml; charset=utf-8
<string xmlns="http://schemas.microsoft.com/2003/10/Serialization/">Element localhost could not be found</string>

Disallowed Actions

This end-point does not allow POST or PUT, and will return a 'HTTP/1.1 405 Method Not Allowed'.