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.

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 are in a YYYY-MM-DD format.

Exceptions

MediaConvert.Client.exceptions.BadRequestException
MediaConvert.Client.exceptions.InternalServerErrorException
MediaConvert.Client.exceptions.ForbiddenException
MediaConvert.Client.exceptions.NotFoundException
MediaConvert.Client.exceptions.TooManyRequestsException
MediaConvert.Client.exceptions.ConflictException