Media streams: update, remove

A media stream represents one component of your content, such as video, audio, or ancillary data. After you add a media stream to your flow, you can associate it with sources and outputs that use the ST 2110 JPEG XS or CDI protocol.

URI

/v1/flows/flowArn/mediaStreams/mediaStreamName

HTTP methods

PUT

Operation ID: UpdateFlowMediaStream

Updates an existing media stream.

Path parameters

Name	Type	Required	Description
flowArn	String	True	The Amazon Resource Name (ARN) of the flow.
mediaStreamName	String	True	The name of the media stream that you want to update.

Responses

Status code	Response model	Description
202	UpdateFlowMediaStreamResponse	MediaConnect is starting the flow.
400	ResponseError	The request that you submitted is not valid.
403	ResponseError	You don't have the required permissions to perform this operation.
404	ResponseError	MediaConnect did not find the resource that you specified in the request.
429	ResponseError	You have exceeded the service request rate limit for your MediaConnect account.
500	ResponseError	MediaConnect can't fulfill your request because it encountered an unexpected condition.
503	ResponseError	MediaConnect is currently unavailable. Try again later.

DELETE

Operation ID: RemoveFlowMediaStream

Removes a media stream from a flow. If the media stream is already associated with a source or output, that association is also removed.

Path parameters

Name	Type	Required	Description
flowArn	String	True	The Amazon Resource Name (ARN) of the flow.
mediaStreamName	String	True	The name of the media stream that you want to update.

Responses

Status code	Response model	Description
200	RemoveFlowMediaStreamResponse	The media stream was successfully removed from the flow.
400	ResponseError	The request that you submitted is not valid.
403	ResponseError	You don't have the required permissions to perform this operation.
404	ResponseError	MediaConnect did not find the resource that you specified in the request.
429	ResponseError	You have exceeded the service request rate limit for your MediaConnect account.
500	ResponseError	MediaConnect can't fulfill your request because it encountered an unexpected condition.
503	ResponseError	MediaConnect is currently unavailable. Try again later.

Schemas

Request bodies

PUT schema

{
  "mediaStreamType": enum,
  "videoFormat": "string",
  "description": "string",
  "attributes": {
    "fmtp": {
      "colorimetry": enum,
      "par": "string",
      "tcs": enum,
      "scanMode": enum,
      "range": enum,
      "channelOrder": "string",
      "exactFramerate": "string"
    },
    "lang": "string"
  },
  "clockRate": integer
}

Response bodies

RemoveFlowMediaStreamResponse schema

{
  "flowArn": "string",
  "mediaStreamName": "string"
}

UpdateFlowMediaStreamResponse schema

{
  "mediaStream": {
    "mediaStreamId": integer,
    "mediaStreamType": enum,
    "videoFormat": "string",
    "mediaStreamName": "string",
    "description": "string",
    "attributes": {
      "fmtp": {
        "colorimetry": enum,
        "par": "string",
        "tcs": enum,
        "scanMode": enum,
        "range": enum,
        "channelOrder": "string",
        "exactFramerate": "string"
      },
      "lang": "string"
    },
    "fmt": integer,
    "clockRate": integer
  },
  "flowArn": "string"
}

ResponseError schema

{
  "message": "string"
}

Properties

Fmtp

A set of parameters that define the media stream.

Property	Type	Required	Description
channelOrder	string	False	The format of the audio channel.
colorimetry	string Values: BT601 | BT709 | BT2020 | BT2100 | ST2065-1 | ST2065-3 | XYZ	False	The format used for the representation of color.
exactFramerate	string	False	The frame rate for the video stream, in frames/second. For example: 60000/1001.
par	string	False	The pixel aspect ratio (PAR) of the video.
range	string Values: NARROW | FULL | FULLPROTECT	False	The encoding range of the video.
scanMode	string Values: progressive | interlace | progressive-segmented-frame	False	The type of compression that was used to smooth the video’s appearance.
tcs	string Values: SDR | PQ | HLG | LINEAR | BT2100LINPQ | BT2100LINHLG | ST2065-1 | ST428-1 | DENSITY	False	The transfer characteristic system (TCS) that is used in the video.

FmtpRequest

The settings that you want to use to define the media stream.

Property	Type	Required	Description
channelOrder	string	False	The format of the audio channel.
colorimetry	string Values: BT601 | BT709 | BT2020 | BT2100 | ST2065-1 | ST2065-3 | XYZ	False	The format that is used for the representation of color.
exactFramerate	string	False	The frame rate for the video stream, in frames/second. For example: 60000/1001.
par	string	False	The pixel aspect ratio (PAR) of the video.
range	string Values: NARROW | FULL | FULLPROTECT	False	The encoding range of the video.
scanMode	string Values: progressive | interlace | progressive-segmented-frame	False	The type of compression that was used to smooth the video’s appearance
tcs	string Values: SDR | PQ | HLG | LINEAR | BT2100LINPQ | BT2100LINHLG | ST2065-1 | ST428-1 | DENSITY	False	The transfer characteristic system (TCS) that is used in the video.

MediaStream

A single track or stream of media that contains video, audio, or ancillary data. After you add a media stream to a flow, you can associate it with sources and outputs on that flow, as long as they use the CDI protocol or the ST 2110 JPEG XS protocol. Each source or output can consist of one or many media streams.

Property	Type	Required	Description
attributes	MediaStreamAttributes	False	Attributes that are related to the media stream.
clockRate	integer Format: int32	False	The sample rate for the stream. This value in measured in kHz.
description	string	False	A description that can help you quickly identify what your media stream is used for.
fmt	integer Format: int32	True	The format type number (sometimes referred to as RTP payload type) of the media stream. MediaConnect assigns this value to the media stream. For ST 2110 JPEG XS outputs, you need to provide this value to the receiver.
mediaStreamId	integer Format: int32	True	A unique identifier for the media stream.
mediaStreamName	string	True	A name that helps you distinguish one media stream from another.
mediaStreamType	string Values: video | audio | ancillary-data	True	The type of media stream.
videoFormat	string	False	The resolution of the video.

MediaStreamAttributes

Attributes that are related to the media stream.

Property	Type	Required	Description
fmtp	Fmtp	True	A set of parameters that define the media stream.
lang	string	False	The audio language, in a format that is recognized by the receiver.

MediaStreamAttributesRequest

Attributes that are related to the media stream.

Property	Type	Required	Description
fmtp	FmtpRequest	False	The settings that you want to use to define the media stream.
lang	string	False	The audio language, in a format that is recognized by the receiver.

RemoveFlowMediaStreamResponse

The result of a successful RemoveFlowMediaStream request.

Property	Type	Required	Description
flowArn	string	True	The Amazon Resource Name (ARN) of the flow.
mediaStreamName	string	True	A name that helps you distinguish one media stream from another.

ResponseError

An exception raised by MediaConnect when you submit a request that cannot be completed. For more information, see the error message and documentation for the operation.

Property	Type	Required	Description
message	string	True	The specific error message that MediaConnect returns to help you understand the reason that the request did not succeed.

UpdateFlowMediaStreamRequest

Update a media stream on a flow.

Property	Type	Required	Description
attributes	MediaStreamAttributesRequest	False	The attributes that you want to assign to the media stream.
clockRate	integer Format: int32	False	The sample rate (in kHz) for the stream. If the media stream type is video or ancillary data, set this value to 90000. If the media stream type is audio, set this value to either 48000 or 96000.
description	string	False	Description
mediaStreamType	string Values: video | audio | ancillary-data	False	The type of media stream.
videoFormat	string	False	The resolution of the video.

UpdateFlowMediaStreamResponse

The result of a successful UpdateFlowMediaStream request.

Property	Type	Required	Description
flowArn	string	True	The ARN of the flow that is associated with the media stream that you updated.
mediaStream	MediaStream	True	The media stream that you updated.

See also

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

UpdateFlowMediaStream

• AWS Command Line Interface

• AWS SDK for .NET

• AWS SDK for C++

• AWS SDK for Go v2

• AWS SDK for Java V2

• AWS SDK for JavaScript V3

• AWS SDK for PHP V3

• AWS SDK for Python

• AWS SDK for Ruby V3

RemoveFlowMediaStream

• AWS Command Line Interface

• AWS SDK for .NET

• AWS SDK for C++

• AWS SDK for Go v2

• AWS SDK for Java V2

• AWS SDK for JavaScript V3

• AWS SDK for PHP V3

• AWS SDK for Python

• AWS SDK for Ruby V3