Skip to content

get_finding_recommendation async 

get_finding_recommendation(
    analyzer_arn: AnalyzerArn,
    id: str,
    *,
    config_overrides: Optional[AsyncAccessAnalyzerClientConfig] = None,
    max_results: Optional[int] = None,
    next_token: Optional[Token] = None,
) -> GetFindingRecommendationResponse

Retrieves information about a finding recommendation for the specified analyzer.

Parameters:

  • analyzer_arn (AnalyzerArn) –

    The ARN of the analyzer used to generate the finding recommendation.

  • id (str) –

    The unique ID for the finding recommendation.

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

    The maximum number of results to return in the response.

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

    A token used for pagination of results returned.

Raises:

Examples:

Successfully fetched finding recommendation

>>> await client.get_finding_recommendation(analyzer_arn='arn:aws:access-analyzer:us-east-1:111122223333:analyzer/a', id='finding-id', max_results=3, next_token='token')
In progress finding recommendation

>>> await client.get_finding_recommendation(analyzer_arn='arn:aws:access-analyzer:us-east-1:111122223333:analyzer/a', id='finding-id', max_results=3)
Failed finding recommendation

>>> await client.get_finding_recommendation(analyzer_arn='arn:aws:access-analyzer:us-east-1:111122223333:analyzer/a', id='finding-id', max_results=3)
Failed field validation for id value

>>> await client.get_finding_recommendation(analyzer_arn='arn:aws:access-analyzer:us-east-1:111122223333:analyzer/a', id='!')
Source code in docs_src/capo_accessanalyzer/_services/async_access_analyzer.py 
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
async def get_finding_recommendation(
    self,
    analyzer_arn: "capo_accessanalyzer.types.analyzer_arn.AnalyzerArn",
    id: str,
    *,
    config_overrides: Optional[AsyncAccessAnalyzerClientConfig] = None,
    max_results: Optional[int] = None,
    next_token: Optional["capo_accessanalyzer.types.token.Token"] = None,
) -> "capo_accessanalyzer.types.get_finding_recommendation_response.GetFindingRecommendationResponse":
    """<p>Retrieves information about a finding recommendation for the specified analyzer.</p>

    Args:
        analyzer_arn: <p>The <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-getting-started.html#permission-resources">ARN of the analyzer</a> used to generate the finding recommendation.</p>
        id: <p>The unique ID for the finding recommendation.</p>
        max_results: <p>The maximum number of results to return in the response.</p>
        next_token: <p>A token used for pagination of results returned.</p>

    Raises:
        capo_accessanalyzer.errors.access_denied_exception.AccessDeniedException: <p>You do not have sufficient access to perform this action.</p>
        capo_accessanalyzer.errors.internal_server_exception.InternalServerException: <p>Internal server error.</p>
        capo_accessanalyzer.errors.resource_not_found_exception.ResourceNotFoundException: <p>The specified resource could not be found.</p>
        capo_accessanalyzer.errors.throttling_exception.ThrottlingException: <p>Throttling limit exceeded error.</p>
        capo_accessanalyzer.errors.validation_exception.ValidationException: <p>Validation exception error.</p>
        capo_accessanalyzer.errors.UnknownServiceError: The service returned an error code this client does not model.

    Examples:
        Successfully fetched finding recommendation

        >>> await client.get_finding_recommendation(analyzer_arn='arn:aws:access-analyzer:us-east-1:111122223333:analyzer/a', id='finding-id', max_results=3, next_token='token')
        In progress finding recommendation

        >>> await client.get_finding_recommendation(analyzer_arn='arn:aws:access-analyzer:us-east-1:111122223333:analyzer/a', id='finding-id', max_results=3)
        Failed finding recommendation

        >>> await client.get_finding_recommendation(analyzer_arn='arn:aws:access-analyzer:us-east-1:111122223333:analyzer/a', id='finding-id', max_results=3)
        Failed field validation for id value

        >>> await client.get_finding_recommendation(analyzer_arn='arn:aws:access-analyzer:us-east-1:111122223333:analyzer/a', id='!')
    """

    async def _handler(
        req: "AsyncOperationRequest[capo_accessanalyzer.types.get_finding_recommendation_request.GetFindingRecommendationRequest]",
    ) -> AsyncOperationResponse[
        "capo_accessanalyzer.types.get_finding_recommendation_response.GetFindingRecommendationResponse"
    ]:
        import capo_accessanalyzer._operations.access_analyzer.get_finding_recommendation

        (
            output,
            http_response,
        ) = await capo_accessanalyzer._operations.access_analyzer.get_finding_recommendation.async_get_finding_recommendation(
            req.options, req.input
        )
        return AsyncOperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("GetFindingRecommendation")
    )
    input_: capo_accessanalyzer.types.get_finding_recommendation_request.GetFindingRecommendationRequest = {
        "analyzer_arn": analyzer_arn,
        "id": id,
    }
    if max_results is not None:
        input_["max_results"] = max_results
    if next_token is not None:
        input_["next_token"] = next_token

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