Request Syntax Request Parameters Response Syntax Response Elements Errors See Also

ListReleaseLabels

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

Request Syntax


{
   "Filters": { 
      "Application": "string",
      "Prefix": "string"
   },
   "MaxResults": number,
   "NextToken": "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.

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.

Type: ReleaseLabelFilter object

Required: No

MaxResults

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

Type: Integer

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

Required: No

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 (Amazon Web Services account ID) and all filtering parameters are different from the original request, or if the NextToken is expired or tampered with.

Type: String

Required: No

Response Syntax


{
   "NextToken": "string",
   "ReleaseLabels": [ "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.

NextToken

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

Type: String

ReleaseLabels

The returned release labels.

Type: Array of strings

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.

HTTP Status Code: 500

InvalidRequestException

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

HTTP Status Code: 400