Skip to content

list_release_labels async

list_release_labels(
    *,
    config_overrides: Optional[AsyncEMRClientConfig] = None,
    filters: Optional[ReleaseLabelFilter] = None,
    next_token: Optional[String] = None,
    max_results: Optional[MaxResultsNumber] = None,
) -> ListReleaseLabelsOutput

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

Parameters:

  • filters (Optional[ReleaseLabelFilter], default: None ) –

    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.

  • next_token (Optional[String], default: None ) –

    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.

  • max_results (Optional[MaxResultsNumber], default: None ) –

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

Raises:

Source code in docs_src/capo_emr/_services/async_emr.py
async def list_release_labels(
    self,
    *,
    config_overrides: Optional[AsyncEMRClientConfig] = None,
    filters: Optional[
        "capo_emr.types.release_label_filter.ReleaseLabelFilter"
    ] = None,
    next_token: Optional["capo_emr.types.string.String"] = None,
    max_results: Optional[
        "capo_emr.types.max_results_number.MaxResultsNumber"
    ] = None,
) -> "capo_emr.types.list_release_labels_output.ListReleaseLabelsOutput":
    """<p>Retrieves release labels of Amazon EMR services in the Region where the API is called.</p>

    Args:
        filters: <p>Filters the results of the request. <code>Prefix</code> specifies the prefix of release labels to return. <code>Application</code> specifies the application (with/without version) of release labels to return.</p>
        next_token: <p>Specifies the next page of results. If <code>NextToken</code> 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 <code>ListReleaseLabels</code> request fails if the identity (Amazon Web Services account ID) and all filtering parameters are different from the original request, or if the <code>NextToken</code> is expired or tampered with.</p>
        max_results: <p>Defines the maximum number of release labels to return in a single response. The default is <code>100</code>.</p>

    Raises:
        capo_emr.errors.internal_server_exception.InternalServerException: <p>This exception occurs when there is an internal failure in the Amazon EMR service.</p>
        capo_emr.errors.invalid_request_exception.InvalidRequestException: <p>This exception occurs when there is something wrong with user input.</p>
        capo_emr.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    async def _handler(
        req: "AsyncOperationRequest[capo_emr.types.list_release_labels_input.ListReleaseLabelsInput]",
    ) -> AsyncOperationResponse[
        "capo_emr.types.list_release_labels_output.ListReleaseLabelsOutput"
    ]:
        import capo_emr._operations.elastic_map_reduce.list_release_labels

        (
            output,
            http_response,
        ) = await capo_emr._operations.elastic_map_reduce.list_release_labels.async_list_release_labels(
            req.options, req.input
        )
        return AsyncOperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("ListReleaseLabels")
    )
    input_: capo_emr.types.list_release_labels_input.ListReleaseLabelsInput = {}
    if filters is not None:
        input_["filters"] = filters
    if next_token is not None:
        input_["next_token"] = next_token
    if max_results is not None:
        input_["max_results"] = max_results

    response = await aexecute_pipeline(
        AsyncOperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    await response.response.aclose()
    return response.output