Offerings - AWS Elemental MediaLive API Reference

Offerings

URI

/prod/offerings

HTTP methods

GET

Operation ID: ListOfferings

Query parameters
Name Type Required Description
resourceType String False
nextToken String False
channelConfiguration String False
duration String False
codec String False
videoQuality String False
resolution String False
maximumFramerate String False
channelClass String False
maxResults String False
maximumBitrate String False
specialFeature String False
Responses
Status code Response model Description
200 ListOfferingsResultModel

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

{ "offerings": [ { "arn": "string", "offeringId": "string", "offeringDescription": "string", "resourceSpecification": { "resourceType": enum, "codec": enum, "resolution": enum, "maximumBitrate": enum, "maximumFramerate": enum, "videoQuality": enum, "specialFeature": enum, "channelClass": enum }, "region": "string", "offeringType": enum, "duration": integer, "durationUnits": enum, "usagePrice": number, "fixedPrice": number, "currencyCode": "string" } ], "nextToken": "string" }
{ "message": "string" }
{ "message": "string" }
{ "message": "string" }
{ "message": "string" }
{ "message": "string" }
{ "message": "string" }

Properties

AccessDenied

Property Type Required Description
message

string

False

BadGatewayException

Property Type Required Description
message

string

False

ChannelClass

A standard channel has two encoding pipelines and a single pipeline channel only has one.

  • STANDARD

  • SINGLE_PIPELINE

GatewayTimeoutException

Property Type Required Description
message

string

False

InternalServiceError

Property Type Required Description
message

string

False

InvalidRequest

Property Type Required Description
message

string

False

LimitExceeded

Property Type Required Description
message

string

False

ListOfferingsResultModel

ListOfferings response

Property Type Required Description
nextToken

string

False

Token to retrieve the next page of results

offerings

Array of type Offering

False

List of offerings

Offering

Reserved resources available for purchase

Property Type Required Description
arn

string

False

Unique offering ARN, e.g. 'arn:aws:medialive:us-west-2:123456789012:offering:87654321'

currencyCode

string

False

Currency code for usagePrice and fixedPrice in ISO-4217 format, e.g. 'USD'

duration

integer

False

Lease duration, e.g. '12'

durationUnits

OfferingDurationUnits

False

Units for duration, e.g. 'MONTHS'

fixedPrice

number

False

One-time charge for each reserved resource, e.g. '0.0' for a NO_UPFRONT offering

offeringDescription

string

False

Offering description, e.g. 'HD AVC output at 10-20 Mbps, 30 fps, and standard VQ in US West (Oregon)'

offeringId

string

False

Unique offering ID, e.g. '87654321'

offeringType

OfferingType

False

Offering type, e.g. 'NO_UPFRONT'

region

string

False

AWS Region, e.g. 'us-west-2'

resourceSpecification

ReservationResourceSpecification

False

Resource configuration details

usagePrice

number

False

Recurring usage charge for each reserved resource, e.g. '157.0'

OfferingDurationUnits

Units for duration, e.g. 'MONTHS'

  • MONTHS

OfferingType

Offering type, e.g. 'NO_UPFRONT'

  • NO_UPFRONT

ReservationCodec

Codec, 'MPEG2', 'AVC', 'HEVC', or 'AUDIO'

  • MPEG2

  • AVC

  • HEVC

  • AUDIO

  • LINK

ReservationMaximumBitrate

Maximum bitrate in megabits per second

  • MAX_10_MBPS

  • MAX_20_MBPS

  • MAX_50_MBPS

ReservationMaximumFramerate

Maximum framerate in frames per second (Outputs only)

  • MAX_30_FPS

  • MAX_60_FPS

ReservationResolution

Resolution based on lines of vertical resolution; SD is less than 720 lines, HD is 720 to 1080 lines, FHD is 1080 lines, UHD is greater than 1080 lines

  • SD

  • HD

  • FHD

  • UHD

ReservationResourceSpecification

Resource configuration (codec, resolution, bitrate, ...)

Property Type Required Description
channelClass

ChannelClass

False

Channel class, e.g. 'STANDARD'

codec

ReservationCodec

False

Codec, e.g. 'AVC'

maximumBitrate

ReservationMaximumBitrate

False

Maximum bitrate, e.g. 'MAX_20_MBPS'

maximumFramerate

ReservationMaximumFramerate

False

Maximum framerate, e.g. 'MAX_30_FPS' (Outputs only)

resolution

ReservationResolution

False

Resolution, e.g. 'HD'

resourceType

ReservationResourceType

False

Resource type, 'INPUT', 'OUTPUT', 'MULTIPLEX', or 'CHANNEL'

specialFeature

ReservationSpecialFeature

False

Special feature, e.g. 'AUDIO_NORMALIZATION' (Channels only)

videoQuality

ReservationVideoQuality

False

Video quality, e.g. 'STANDARD' (Outputs only)

ReservationResourceType

Resource type, 'INPUT', 'OUTPUT', 'MULTIPLEX', or 'CHANNEL'

  • INPUT

  • OUTPUT

  • MULTIPLEX

  • CHANNEL

ReservationSpecialFeature

Special features, 'ADVANCED_AUDIO' 'AUDIO_NORMALIZATION' 'MGHD' or 'MGUHD'

  • ADVANCED_AUDIO

  • AUDIO_NORMALIZATION

  • MGHD

  • MGUHD

ReservationVideoQuality

Video quality, e.g. 'STANDARD' (Outputs only)

  • STANDARD

  • ENHANCED

  • PREMIUM

See also

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

ListOfferings