Skip to main content

versions

Creates, updates, deletes, gets or lists a versions resource.

Overview

Nameversions
TypeResource
Idaws.mediaconvert.versions

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
expiration_datestring (date-time)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.
versionstringUse 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.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
list_versionsselectregionmaxResults, nextTokenRetrieve a JSON array of all available Job engine versions and the date they expire.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
regionstringAWS region (default: us-east-1)
maxResultsintegerOptional. Number of valid Job engine versions, up to twenty, that will be returned at one time.
nextTokenstringOptional. Use this string, provided with the response to a previous request, to request the next batch of Job engine versions.

SELECT examples

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

SELECT
expiration_date,
version
FROM aws.mediaconvert.versions
WHERE region = '{{ region }}' -- required
AND maxResults = '{{ maxResults }}'
AND nextToken = '{{ nextToken }}'
;