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.
Prefixspecifies the prefix of release labels to return.Applicationspecifies 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
NextTokenis 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. TheListReleaseLabelsrequest fails if the identity (AWS account ID) and all filtering parameters are different from the original request, or if theNextTokenis 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
ListReleaseLabelsrequest.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
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following:
