Reservations: describe reservation - AWS Elemental MediaLive API Reference

Reservations: describe reservation

URI

/prod/reservations/reservationId

HTTP methods

GET

Operation ID: DescribeReservation

Path parameters
NameTypeRequiredDescription
reservationIdStringTrue
Responses
Status codeResponse modelDescription
200Reservation

200 response

400InvalidRequest

400 response

403AccessDenied

403 response

404ResourceNotFound

404 response

429LimitExceeded

429 response

500InternalServiceError

500 response

502BadGatewayException

502 response

504GatewayTimeoutException

504 response

PUT

Operation ID: UpdateReservation

Path parameters
NameTypeRequiredDescription
reservationIdStringTrue
Responses
Status codeResponse modelDescription
200UpdateReservationResultModel

200 response

400InvalidRequest

400 response

403AccessDenied

403 response

404ResourceNotFound

404 response

409ResourceConflict

409 response

429LimitExceeded

429 response

500InternalServiceError

500 response

502BadGatewayException

502 response

504GatewayTimeoutException

504 response

DELETE

Operation ID: DeleteReservation

Path parameters
NameTypeRequiredDescription
reservationIdStringTrue
Responses
Status codeResponse modelDescription
200Reservation

200 response

400InvalidRequest

400 response

403AccessDenied

403 response

404ResourceNotFound

404 response

409ResourceConflict

409 response

429LimitExceeded

429 response

500InternalServiceError

500 response

502BadGatewayException

502 response

504GatewayTimeoutException

504 response

Schemas

Request bodies

{ "name": "string" }

Response bodies

{ "arn": "string", "reservationId": "string", "name": "string", "state": enum, "count": integer, "start": "string", "end": "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", "tags": { } }
{ "reservation": { "arn": "string", "reservationId": "string", "name": "string", "state": enum, "count": integer, "start": "string", "end": "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", "tags": { } } }
{ "message": "string" }
{ "message": "string" }
{ "message": "string" }
{ "message": "string" }
{ "message": "string" }
{ "message": "string" }
{ "message": "string" }
{ "message": "string" }

Properties

AccessDenied

PropertyTypeRequiredDescription
message

string

False

BadGatewayException

PropertyTypeRequiredDescription
message

string

False

ChannelClass

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

  • STANDARD

  • SINGLE_PIPELINE

GatewayTimeoutException

PropertyTypeRequiredDescription
message

string

False

InternalServiceError

PropertyTypeRequiredDescription
message

string

False

InvalidRequest

PropertyTypeRequiredDescription
message

string

False

LimitExceeded

PropertyTypeRequiredDescription
message

string

False

OfferingDurationUnits

Units for duration, e.g. 'MONTHS'

  • MONTHS

OfferingType

Offering type, e.g. 'NO_UPFRONT'

  • NO_UPFRONT

Reservation

Reserved resources available to use

PropertyTypeRequiredDescription
arn

string

False

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

count

integer

False

Number of reserved resources

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'

end

string

False

Reservation UTC end date and time in ISO-8601 format, e.g. '2019-03-01T00:00:00'

fixedPrice

number

False

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

name

string

False

User specified reservation name

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'

reservationId

string

False

Unique reservation ID, e.g. '1234567'

resourceSpecification

ReservationResourceSpecification

False

Resource configuration details

start

string

False

Reservation UTC start date and time in ISO-8601 format, e.g. '2018-03-01T00:00:00'

state

ReservationState

False

Current state of reservation, e.g. 'ACTIVE'

tags

Tags

False

A collection of key-value pairs

usagePrice

number

False

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

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, ...)

PropertyTypeRequiredDescription
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

ReservationState

Current reservation state

  • ACTIVE

  • EXPIRED

  • CANCELED

  • DELETED

ReservationVideoQuality

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

  • STANDARD

  • ENHANCED

  • PREMIUM

ResourceConflict

PropertyTypeRequiredDescription
message

string

False

ResourceNotFound

PropertyTypeRequiredDescription
message

string

False

Tags

PropertyTypeRequiredDescription

*

string

False

UpdateReservation

UpdateReservation request

PropertyTypeRequiredDescription
name

string

False

Name of the reservation

UpdateReservationResultModel

UpdateReservation response

PropertyTypeRequiredDescription
reservation

Reservation

False

See also

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

DescribeReservation

UpdateReservation

DeleteReservation