GET List: Get a List of Routers - AWS Elemental Conductor Live 3

This is version 3.19 of the AWS Elemental Conductor Live 3 documentation. This is the latest version. For prior versions, see the Previous Versions section of AWS Elemental Conductor Live 3 Documentation.

GET List: Get a List of Routers

Get a list of all video SDI routers, including the data that is contained in the Router Input and Router Output entities.

HTTP Request and Response

Request URL

GET http://<Conductor IP address>/routers

Call Header

  • Accept: Set to application/xml

If you are implementing user authentication, you must also include three authorization headers; see Header Content for User Authentication.

Response

The response is XML content consisting of one routers element that contains:

  • An HREF attribute that specifies the product and version installed on the AWS Elemental Conductor Live 3 node.

  • Zero or more router elements, one for each router found. Each router element consists of several elements.

Element Value Description
id Integer The ID for this router, assigned by the system when the router is created.
name See POST: Create a Router.
ip
router_type
level_id
user_id
id See POST: Create a Router Input.
name
router_id
input_number
id See POST: Create a Router Output.
output_number
router_id
device_id

Example

Request

GET http://198.51.100.0/routers

Response

<?xml version="1.0" encoding="UTF-8"?> <routers href="/routers" product="AWS Elemental Conductor Live" version="3.3.nnnnn">> <router> <id>1</id> <name>BlackMagic1</name> <ip>192.168.10.10</ip> <router_type>blackmagic_videohub</router_type> <max_inputs>12</max_inputs> <max_outputs>12</max_outputs> <inputs> <input> <id>1</id> <name>Input 1</name> <router_id>1</router_id> <input_number>1</input_number> </input> <input> <id>2</id> <name>Input 2</name> <router_id>1</router_id> <input_number>2</input_number> </input> </inputs> <outputs> <output> <id>9</id> <router_id>1</router_id> <output_number>1</output_number> <device_id>1</device_id> <device_type>Device</device_type> </output> </outputs> </router> . . . <router> . . . </router> </routers>