AWS Elemental MediaLive API Reference
API Reference

Inputs inputId

URI

/prod/inputs/inputId

HTTP Methods

GET

Operation ID: DescribeInput

Produces details about an input

Path Parameters

Name Type Required Description
inputId String True

Unique ID of the input

Responses

Status Code Response Model Description
200 Input

Input details

400 InvalidRequest

This request was invalid.

403 AccessDenied

You do not have permission to list channels.

404 ResourceNotFound

The channel you're requesting to describe does not exist.

429 LimitExceeded

Request limit exceeded on list channel calls to channel service.

500 InternalServiceError

Unexpected internal service error.

502 BadGatewayException

Bad Gateway Error

504 GatewayTimeoutException

Gateway Timeout Error

PUT

Operation ID: UpdateInput

Updates an input.

Path Parameters

Name Type Required Description
inputId String True

Unique ID of the input

Responses

Status Code Response Model Description
200 UpdateInputResultModel

The input update is successfully initiated.

400 InvalidRequest

This request was invalid.

403 AccessDenied

You do not have permission to list channels.

404 ResourceNotFound

The channel you're requesting to describe does not exist.

409 ResourceConflict

The channel is unable to create due to an issue with channel resources.

500 InternalServiceError

Unexpected internal service error.

502 BadGatewayException

Bad Gateway Error

504 GatewayTimeoutException

Gateway Timeout Error

DELETE

Operation ID: DeleteInput

Deletes the input end point

Path Parameters

Name Type Required Description
inputId String True

Unique ID of the input

Responses

Status Code Response Model Description
200 Empty

Successful deletion

400 InvalidRequest

This request was invalid.

403 AccessDenied

You do not have permission to list channels.

404 ResourceNotFound

The channel you're requesting to describe does not exist.

409 ResourceConflict

The channel is unable to create due to an issue with channel resources.

429 LimitExceeded

Request limit exceeded on list channel calls to channel service.

500 InternalServiceError

Unexpected internal service error.

502 BadGatewayException

Bad Gateway Error

504 GatewayTimeoutException

Gateway Timeout Error

Schemas

Request Bodies

Example PUT

{ "inputSecurityGroups": [ "string" ], "mediaConnectFlows": [ { "flowArn": "string" } ], "sources": [ { "passwordParam": "string", "url": "string", "username": "string" } ], "roleArn": "string", "destinations": [ { "streamName": "string" } ], "name": "string" }

Response Bodies

Example Input

{ "mediaConnectFlows": [ { "flowArn": "string" } ], "attachedChannels": [ "string" ], "sources": [ { "passwordParam": "string", "url": "string", "username": "string" } ], "roleArn": "string", "destinations": [ { "port": "string", "ip": "string", "url": "string" } ], "name": "string", "securityGroups": [ "string" ], "id": "string", "state": enum, "arn": "string", "type": enum, "tags": { } }

Example UpdateInputResultModel

{ "input": { "mediaConnectFlows": [ { "flowArn": "string" } ], "attachedChannels": [ "string" ], "sources": [ { "passwordParam": "string", "url": "string", "username": "string" } ], "roleArn": "string", "destinations": [ { "port": "string", "ip": "string", "url": "string" } ], "name": "string", "securityGroups": [ "string" ], "id": "string", "state": enum, "arn": "string", "type": enum, "tags": { } } }

Example Empty

{ }

Example InvalidRequest

{ "message": "string" }

Example AccessDenied

{ "message": "string" }

Example ResourceNotFound

{ "message": "string" }

Example ResourceConflict

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

Empty

Property Type Required Description

GatewayTimeoutException

Property Type Required Description
message

string

False

Input

Property Type Required Description
mediaConnectFlows

array

False

A list of MediaConnect Flows for this input.

attachedChannels

array

False

A list of channel IDs that that input is attached to (currently an input can only be attached to one channel).

sources

array

False

A list of the sources of the input (PULL-type).

roleArn

string

False

The Amazon Resource Name (ARN) of the role this input assumes during and after creation.

destinations

array

False

A list of the destinations of the input (PUSH-type).

name

string

False

The user-assigned name (This is a mutable value).

securityGroups

array

False

A list of IDs for all the security groups attached to the input.

id

string

False

The generated ID of the input (unique for user account, immutable).

state

InputState

False
arn

string

False

The Unique ARN of the input (generated, immutable).

type

InputType

False
tags

Tags

False

A collection of key-value pairs.

InputDestination

The settings for a PUSH type input.

Property Type Required Description
port

string

False

The port number for the input.

ip

string

False

The system-generated static IP address of endpoint. It remains fixed for the lifetime of the input.

url

string

False

This represents the endpoint that the customer stream will be pushed to.

InputDestinationRequest

Endpoint settings for a PUSH type input.

Property Type Required Description
streamName

string

False

A unique name for the location the RTMP stream is being pushed to.

InputSource

The settings for a PULL type input.

Property Type Required Description
passwordParam

string

False

The key used to extract the password from EC2 Parameter store.

url

string

False

This represents the customer's source URL where stream is pulled from.

username

string

False

The username for the input source.

InputSourceRequest

Settings for for a PULL type input.

Property Type Required Description
passwordParam

string

False

The key used to extract the password from EC2 Parameter store.

url

string

False

This represents the customer's source URL where stream is pulled from.

username

string

False

The username for the input source.

InputState (enum)

  • CREATING

  • DETACHED

  • ATTACHED

  • DELETING

  • DELETED

InputType (enum)

  • UDP_PUSH

  • RTP_PUSH

  • RTMP_PUSH

  • RTMP_PULL

  • URL_PULL

  • MP4_FILE

  • MEDIACONNECT

InternalServiceError

Property Type Required Description
message

string

False

InvalidRequest

Property Type Required Description
message

string

False

LimitExceeded

Property Type Required Description
message

string

False

MediaConnectFlow

The settings for a MediaConnect Flow.

Property Type Required Description
flowArn

string

False

The unique ARN of the MediaConnect Flow being used as a source.

MediaConnectFlowRequest

The settings for a MediaConnect Flow.

Property Type Required Description
flowArn

string

False

The ARN of the MediaConnect Flow that you want to use as a source.

ResourceConflict

Property Type Required Description
message

string

False

ResourceNotFound

Property Type Required Description
message

string

False

Tags

Property Type Required Description

UpdateInput

Property Type Required Description
inputSecurityGroups

array

False

A list of security groups referenced by IDs to attach to the input.

mediaConnectFlows

array

False

A list of the MediaConnect Flow ARNs that you want to use as the source of the input. You can specify as few as one Flow and presently, as many as two. The only requirement is when you have more than one is that each Flow is in a separate Availability Zone as this ensures your EML input is redundant to AZ issues.

sources

array

False

The source URLs for a PULL-type input. Every PULL type input needs exactly two source URLs for redundancy. Only specify sources for PULL type Inputs. Leave Destinations empty.

roleArn

string

False

The Amazon Resource Name (ARN) of the role this input assumes during and after creation.

destinations

array

False

Destination settings for PUSH type inputs.

name

string

False

Name of the input.

UpdateInputResultModel

Property Type Required Description
input

Input

False