Request Syntax Request Parameters Response Syntax Response Elements Errors See Also

DescribeReleaseLabel

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

Request Syntax


{
   "MaxResults": number,
   "NextToken": "string",
   "ReleaseLabel": "string"
}

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.

MaxResults

Reserved for future use. Currently set to null.

Type: Integer

Valid Range: Minimum value of 1. Maximum value of 100.

Required: No

NextToken

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

Type: String

Required: No

ReleaseLabel

The target release label to be described.

Type: String

Required: No

Response Syntax


{
   "Applications": [ 
      { 
         "Name": "string",
         "Version": "string"
      }
   ],
   "AvailableOSReleases": [ 
      { 
         "Label": "string"
      }
   ],
   "NextToken": "string",
   "ReleaseLabel": "string"
}

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

Applications

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.

Type: Array of SimplifiedApplication objects

AvailableOSReleases

The list of available Amazon Linux release versions for an Amazon EMR release. Contains a Label field that is formatted as shown in Amazon Linux 2 Release Notes. For example, 2.0.20220218.1.

Type: Array of OSRelease objects

NextToken

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

Type: String

ReleaseLabel

The target release label described in the response.

Type: String

Errors

For information about the errors that are common to all actions, see Common Errors.

InternalServerException

This exception occurs when there is an internal failure in the Amazon EMR service.

Message: The message associated with the exception.

HTTP Status Code: 500

InvalidRequestException

This exception occurs when there is something wrong with user input.

ErrorCode: The error code associated with the exception.
Message: The message associated with the exception.

HTTP Status Code: 400