Amazon Elastic MapReduce

2021/07/21 - Amazon Elastic MapReduce - 2 new api methods

Changes  EMR now supports new DescribeReleaseLabel and ListReleaseLabel APIs. They can provide Amazon EMR release label details. You can programmatically list available releases and applications for a specific Amazon EMR release label.

DescribeReleaseLabel (new) Link ¶

Provides EMR release label details, such as releases available the region where the API request is run, and the available applications for a specific EMR release label. Can also list EMR release versions that support a specified version of Spark.

See also: AWS API Documentation

Request Syntax

client.describe_release_label(
    ReleaseLabel='string',
    NextToken='string',
    MaxResults=123
)
type ReleaseLabel

string

param ReleaseLabel

The target release label to be described.

type NextToken

string

param NextToken

The pagination token. Reserved for future use. Currently set to null.

type MaxResults

integer

param MaxResults

Reserved for future use. Currently set to null.

rtype

dict

returns

Response Syntax

{
    'ReleaseLabel': 'string',
    'Applications': [
        {
            'Name': 'string',
            'Version': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • ReleaseLabel (string) --

      The target release label described in the response.

    • Applications (list) --

      The list of applications available for the target release label. Name is the name of the application. Version is the concise version of the application.

      • (dict) --

        The returned release label application names or versions.

        • Name (string) --

          The returned release label application name. For example, hadoop .

        • Version (string) --

          The returned release label application version. For example, 3.2.1 .

    • NextToken (string) --

      The pagination token. Reserved for future use. Currently set to null.

ListReleaseLabels (new) Link ¶

Retrieves release labels of EMR services in the region where the API is called.

See also: AWS API Documentation

Request Syntax

client.list_release_labels(
    Filters={
        'Prefix': 'string',
        'Application': 'string'
    },
    NextToken='string',
    MaxResults=123
)
type Filters

dict

param Filters

Filters the results of the request. Prefix specifies the prefix of release labels to return. Application specifies the application (with/without version) of release labels to return.

  • Prefix (string) --

    Optional release label version prefix filter. For example, emr-5 .

  • Application (string) --

    Optional release label application filter. For example, spark@2.1.0 .

type NextToken

string

param NextToken

Specifies the next page of results. If NextToken is not specified, which is usually the case for the first request of ListReleaseLabels, the first page of results are determined by other filtering parameters or by the latest version. The ListReleaseLabels request fails if the identity (AWS AccountID) and all filtering parameters are different from the original request, or if the NextToken is expired or tampered with.

type MaxResults

integer

param MaxResults

Defines the maximum number of release labels to return in a single response. The default is 100 .

rtype

dict

returns

Response Syntax

{
    'ReleaseLabels': [
        'string',
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • ReleaseLabels (list) --

      The returned release labels.

      • (string) --

    • NextToken (string) --

      Used to paginate the next page of results if specified in the next ListReleaseLabels request.