URI HTTP methods Schemas Properties See also

Versions

URI

/2017-08-29/versions

HTTP methods

GET

Operation ID: ListVersions

Retrieve a JSON array of all available Job engine versions and the date they expire.

Responses
Status code	Response model	Description
`200`	`ListVersionsResponse`	200 response
`400`	`ExceptionBody`	The service can't process your request because of a problem in the request. Please check your request form and syntax.
`403`	`ExceptionBody`	You don't have permissions for this action with the credentials you sent.
`404`	`ExceptionBody`	The resource you requested does not exist.
`409`	`ExceptionBody`	The service could not complete your request because there is a conflict with the current state of the resource.
`429`	`ExceptionBody`	Too many requests have been sent in too short of a time. The service limits the rate at which it will accept requests.
`500`	`ExceptionBody`	The service encountered an unexpected condition and cannot fulfill your request.

OPTIONS

Supports CORS preflight requests.

Responses
Status code	Response model	Description
`200`	None	The request completed successfully.

Schemas

Request bodies


{
  "nextToken": "string",
  "maxResults": integer
}

Response bodies


{
  "versions": [
    {
      "version": "string",
      "expirationDate": "string"
    }
  ],
  "nextToken": "string"
}


{
  "message": "string"
}

Properties

ExceptionBody

Property	Type	Required	Description
`message`	string	False

JobEngineVersion

Use Job engine versions to run jobs for your production workflow on one version, while you test and validate the latest version. Job engine versions are in a YYYY-MM-DD format.

Property Type Required Description

Property	Type	Required	Description
`expirationDate`	string Format: date-time	False	The date that this Job engine version expires. Requests to create jobs with an expired version result in a regular job, as if no specific Job engine version was requested.
`version`	string	False	Use Job engine versions to run jobs for your production workflow on one version, while you test and validate the latest version. Job engine versions represent periodically grouped MediaConvert releases with new features, updates, improvements, and fixes. Job engine versions are in a YYYY-MM-DD format. Note that the Job engine version feature is not publicly available at this time. To request access, contact AWS support.

expirationDate

string

Format: date-time

False

The date that this Job engine version expires. Requests to create jobs with an expired version result in a regular job, as if no specific Job engine version was requested.

version

string

False

Use Job engine versions to run jobs for your production workflow on one version, while you test and validate the latest version. Job engine versions represent periodically grouped MediaConvert releases with new features, updates, improvements, and fixes. Job engine versions are in a YYYY-MM-DD format. Note that the Job engine version feature is not publicly available at this time. To request access, contact AWS support.

ListVersionsRequest

Retrieve a JSON array of all available Job engine versions and the date they expire. Job engine versions are in YYYY-MM-DD format. Note that the Job engine version feature is not publicly available at this time. To request access, contact AWS support.

Property Type Required Description

Property	Type	Required	Description
`maxResults`	integer Format: int32 Minimum: 1 Maximum: 20	False	Optional. Number of valid Job engine versions, up to twenty, that will be returned at one time.
`nextToken`	string	False	Optional. Use this string, provided with the response to a previous request, to request the next batch of Job engine versions.

maxResults

integer

Format: int32

Minimum: 1

Maximum: 20

False

Optional. Number of valid Job engine versions, up to twenty, that will be returned at one time.

nextToken

string

False

Optional. Use this string, provided with the response to a previous request, to request the next batch of Job engine versions.

ListVersionsResponse

Successful list versions requests will return a JSON for available Job engine versions.

Property	Type	Required	Description
`nextToken`	string	False	Optional. Use this string, provided with the response to a previous request, to request the next batch of Job engine versions.
`versions`	Array of type JobEngineVersion	False	Retrieve a JSON array of all available Job engine versions and the date they expire.