InputDevices - AWS Elemental MediaLive API Reference

InputDevices

URI

/prod/inputDevices

HTTP Methods

GET

Operation ID: ListInputDevices

List input devices

Query Parameters
Name Type Required Description
nextToken String False
maxResults String False
Responses
Status Code Response Model Description
200 ListInputDevicesResultModel

200 response

400 InvalidRequest

400 response

403 AccessDenied

403 response

429 LimitExceeded

429 response

500 InternalServiceError

500 response

502 BadGatewayException

502 response

504 GatewayTimeoutException

504 response

Schemas

Response Bodies

Example ListInputDevicesResultModel

{ "inputDevices": [ { "id": "string", "arn": "string", "name": "string", "serialNumber": "string", "macAddress": "string", "type": enum, "connectionState": enum, "deviceSettingsSyncState": enum, "hdDeviceSettings": { "maxBitrate": integer, "configuredInput": enum, "activeInput": enum, "deviceState": enum, "width": integer, "height": integer, "scanType": enum, "framerate": number }, "networkSettings": { "ipAddress": "string", "subnetMask": "string", "dnsAddresses": [ "string" ], "gateway": "string", "ipScheme": enum } } ], "nextToken": "string" }

Example InvalidRequest

{ "message": "string" }

Example AccessDenied

{ "message": "string" }

Example LimitExceeded

{ "message": "string" }

Example InternalServiceError

{ "message": "string" }

Example BadGatewayException

{ "message": "string" }

Example GatewayTimeoutException

{ "message": "string" }

Properties

AccessDenied

Property Type Required Description
message

string

False

BadGatewayException

Property Type Required Description
message

string

False

DeviceSettingsSyncState

The status of the action to synchronize the device configuration. If you change the configuration of the input device (for example, the maximum bitrate), MediaLive sends the new data to the device. The device might not update itself immediately. SYNCED means the device has updated its configuration. SYNCING means that it has not updated its configuration.

  • SYNCED

  • SYNCING

GatewayTimeoutException

Property Type Required Description
message

string

False

InputDeviceActiveInput

The source at the input device that is currently active.

  • HDMI

  • SDI

InputDeviceConfiguredInput

The source to activate (use) from the input device.

  • AUTO

  • HDMI

  • SDI

InputDeviceConnectionState

The state of the connection between the input device and AWS.

  • DISCONNECTED

  • CONNECTED

InputDeviceHdSettings

Settings that describe the active source from the input device, and the video characteristics of that source.

Property Type Required Description
maxBitrate

integer

False

The current maximum bitrate for ingesting this source, in bits per second. You can specify this maximum.

configuredInput

InputDeviceConfiguredInput

False

The source at the input device that is currently active. You can specify this source.

activeInput

InputDeviceActiveInput

False

If you specified Auto as the configured input, specifies which of the sources is currently active (SDI or HDMI).

deviceState

InputDeviceState

False

The state of the input device.

width

integer

False

The width of the video source, in pixels.

height

integer

False

The height of the video source, in pixels.

scanType

InputDeviceScanType

False

The scan type of the video source.

framerate

number

False

The frame rate of the video source.

InputDeviceIpScheme

Specifies whether the input device has been configured (outside of MediaLive) to use a dynamic IP address assignment (DHCP) or a static IP address.

  • STATIC

  • DHCP

InputDeviceNetworkSettings

The network settings for the input device.

Property Type Required Description
ipAddress

string

False

The IP address of the input device.

subnetMask

string

False

The subnet mask of the input device.

dnsAddresses

Array of type string

False

The DNS addresses of the input device.

gateway

string

False

The network gateway IP address.

ipScheme

InputDeviceIpScheme

False

Specifies whether the input device has been configured (outside of MediaLive) to use a dynamic IP address assignment (DHCP) or a static IP address.

InputDeviceScanType

The scan type of the video source.

  • INTERLACED

  • PROGRESSIVE

InputDeviceState

The state of the input device.

  • IDLE

  • STREAMING

InputDeviceSummary

Details of the input device.

Property Type Required Description
id

string

False

The unique ID of the input device.

arn

string

False

The unique ARN of the input device.

name

string

False

A name that you specify for the input device.

serialNumber

string

False

The unique serial number of the input device.

macAddress

string

False

The network MAC address of the input device.

type

InputDeviceType

False

The type of the input device.

connectionState

InputDeviceConnectionState

False

The state of the connection between the input device and AWS.

deviceSettingsSyncState

DeviceSettingsSyncState

False

The status of the action to synchronize the device configuration. If you change the configuration of the input device (for example, the maximum bitrate), MediaLive sends the new data to the device. The device might not update itself immediately. SYNCED means the device has updated its configuration. SYNCING means that it has not updated its configuration.

hdDeviceSettings

InputDeviceHdSettings

False

Settings that describe an input device that is type HD.

networkSettings

InputDeviceNetworkSettings

False

Network settings for the input device.

InputDeviceType

The type of the input device. For an AWS Elemental Link device that outputs resolutions up to 1080, choose "HD".

  • HD

InternalServiceError

Property Type Required Description
message

string

False

InvalidRequest

Property Type Required Description
message

string

False

LimitExceeded

Property Type Required Description
message

string

False

ListInputDevicesResultModel

The list of input devices owned by the AWS account.

Property Type Required Description
inputDevices

Array of type InputDeviceSummary

False

The list of input devices.

nextToken

string

False

A token to get additional list results.

See Also

For more information about using this API in one of the language-specific AWS SDKs and references, see the following:

ListInputDevices