MediaConvert / Client / list_versions

list_versions

MediaConvert.Client.list_versions(**kwargs)

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

See also: AWS API Documentation

Request Syntax

response = client.list_versions(
    MaxResults=123,
    NextToken='string'
)
Parameters:

  • MaxResults (integer) – Optional. Number of valid Job engine versions, up to twenty, that will be returned at one time.

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

Return type:

dict

Returns:

Response Syntax

{
    'NextToken': 'string',
    'Versions': [
        {
            'ExpirationDate': datetime(2015, 1, 1),
            'Version': 'string'
        },
    ]
}

Response Structure

  • (dict) –

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

    • Versions (list) – Retrieve a JSON array of all available Job engine versions and the date they expire.

      • (dict) – 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.

        • ExpirationDate (datetime) – 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) – 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.

Exceptions