Skip to content

generate_finding_recommendation

generate_finding_recommendation(
    analyzer_arn: AnalyzerArn,
    id: str,
    *,
    config_overrides: Optional[AccessAnalyzerClientConfig] = None,
) -> None

Creates a recommendation for an unused permissions finding.

Parameters:

Raises:

Examples:

Successfully started generating finding recommendation

>>> client.generate_finding_recommendation(analyzer_arn='arn:aws:access-analyzer:us-east-1:111122223333:analyzer/a', id='finding-id')
Failed field validation for id value
>>> client.generate_finding_recommendation(analyzer_arn='arn:aws:access-analyzer:us-east-1:111122223333:analyzer/a', id='!')
Source code in docs_src/capo_accessanalyzer/_services/access_analyzer.py
def generate_finding_recommendation(
    self,
    analyzer_arn: "capo_accessanalyzer.types.analyzer_arn.AnalyzerArn",
    id: str,
    *,
    config_overrides: Optional[AccessAnalyzerClientConfig] = None,
) -> None:
    """<p>Creates a recommendation for an unused permissions finding.</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>

    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.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 started generating finding recommendation

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

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

    def _handler(
        req: "OperationRequest[capo_accessanalyzer.types.generate_finding_recommendation_request.GenerateFindingRecommendationRequest]",
    ) -> OperationResponse[None]:
        import capo_accessanalyzer._operations.access_analyzer.generate_finding_recommendation

        output, http_response = (
            capo_accessanalyzer._operations.access_analyzer.generate_finding_recommendation.generate_finding_recommendation(
                req.options, req.input
            )
        )
        return OperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("GenerateFindingRecommendation")
    )
    input_: capo_accessanalyzer.types.generate_finding_recommendation_request.GenerateFindingRecommendationRequest = {
        "analyzer_arn": analyzer_arn,
        "id": id,
    }

    response = execute_pipeline(
        OperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    response.response.close()
    return response.output