Reservations: describe reservation

URI

/prod/reservations/reservationId

HTTP methods

GET

Operation ID: DescribeReservation

Path parameters
Name	Type	Required	Description
reservationId	String	True

Responses
Status code	Response model	Description
200	Reservation	200 response
400	InvalidRequest	400 response
403	AccessDenied	403 response
404	ResourceNotFound	404 response
429	LimitExceeded	429 response
500	InternalServiceError	500 response
502	BadGatewayException	502 response
504	GatewayTimeoutException	504 response

PUT

Operation ID: UpdateReservation

Path parameters
Name	Type	Required	Description
reservationId	String	True

Responses
Status code	Response model	Description
200	UpdateReservationResultModel	200 response
400	InvalidRequest	400 response
403	AccessDenied	403 response
404	ResourceNotFound	404 response
409	ResourceConflict	409 response
429	LimitExceeded	429 response
500	InternalServiceError	500 response
502	BadGatewayException	502 response
504	GatewayTimeoutException	504 response

DELETE

Operation ID: DeleteReservation

Path parameters
Name	Type	Required	Description
reservationId	String	True

Responses
Status code	Response model	Description
200	Reservation	200 response
400	InvalidRequest	400 response
403	AccessDenied	403 response
404	ResourceNotFound	404 response
409	ResourceConflict	409 response
429	LimitExceeded	429 response
500	InternalServiceError	500 response
502	BadGatewayException	502 response
504	GatewayTimeoutException	504 response

Schemas

Request bodies

PUT schema

{
  "name": "string"
}

Response bodies

Reservation schema

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

UpdateReservationResultModel schema

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

InvalidRequest schema

{
  "message": "string"
}

AccessDenied schema

{
  "message": "string"
}

ResourceNotFound schema

{
  "message": "string"
}

ResourceConflict schema

{
  "message": "string"
}

LimitExceeded schema

{
  "message": "string"
}

InternalServiceError schema

{
  "message": "string"
}

BadGatewayException schema

{
  "message": "string"
}

GatewayTimeoutException schema

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

OfferingDurationUnits

Units for duration, e.g. 'MONTHS'

• MONTHS

OfferingType

Offering type, e.g. 'NO_UPFRONT'

• NO_UPFRONT

Reservation

Reserved resources available to use

Property	Type	Required	Description
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, ...)

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

ReservationState

Current reservation state

• ACTIVE

• EXPIRED

• CANCELED

• DELETED

ReservationVideoQuality

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

• STANDARD

• ENHANCED

• PREMIUM

ResourceConflict

Property	Type	Required	Description
message	string	False

ResourceNotFound

Property	Type	Required	Description
message	string	False

Tags

Property	Type	Required	Description
*	string	False

UpdateReservation

UpdateReservation request

Property	Type	Required	Description
name	string	False	Name of the reservation

UpdateReservationResultModel

UpdateReservation response

Property	Type	Required	Description
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

• AWS Command Line Interface

• AWS SDK for .NET

• AWS SDK for C++

• AWS SDK for Go

• AWS SDK for Java V2

• AWS SDK for JavaScript

• AWS SDK for PHP V3

• AWS SDK for Python

• AWS SDK for Ruby V3

UpdateReservation

• AWS Command Line Interface

• AWS SDK for .NET

• AWS SDK for C++

• AWS SDK for Go

• AWS SDK for Java V2

• AWS SDK for JavaScript

• AWS SDK for PHP V3

• AWS SDK for Python

• AWS SDK for Ruby V3

DeleteReservation

• AWS Command Line Interface

• AWS SDK for .NET

• AWS SDK for C++

• AWS SDK for Go

• AWS SDK for Java V2

• AWS SDK for JavaScript

• AWS SDK for PHP V3

• AWS SDK for Python

• AWS SDK for Ruby V3