list_organization_insights ¶

def list_organization_insights(
    self,
    status_filter: "capo_devops_guru.types.list_insights_status_filter.ListInsightsStatusFilter",
    *,
    config_overrides: Optional[DevOpsGuruClientConfig] = None,
    max_results: Optional[
        "capo_devops_guru.types.list_insights_max_results.ListInsightsMaxResults"
    ] = None,
    account_ids: Optional[
        "capo_devops_guru.types.list_insights_account_id_list.ListInsightsAccountIdList"
    ] = None,
    organizational_unit_ids: Optional[
        "capo_devops_guru.types.list_insights_organizational_unit_id_list.ListInsightsOrganizationalUnitIdList"
    ] = None,
    next_token: Optional[
        "capo_devops_guru.types.uuid_next_token.UuidNextToken"
    ] = None,
) -> "capo_devops_guru.types.list_organization_insights_response.ListOrganizationInsightsResponse":
    """<p>Returns a list of insights associated with the account or OU Id.</p>

    Args:
        max_results: <p>The maximum number of results to return with a single call. To retrieve the remaining results, make another call with the returned <code>nextToken</code> value.</p>
        account_ids: <p>The ID of the Amazon Web Services account. </p>
        organizational_unit_ids: <p>The ID of the organizational unit.</p>
        next_token: <p>The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.</p>

    Raises:
        capo_devops_guru.errors.access_denied_exception.AccessDeniedException: <p> You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions. For more information, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html">Access Management</a> in the <i>IAM User Guide</i>. </p>
        capo_devops_guru.errors.internal_server_exception.InternalServerException: <p>An internal failure in an Amazon service occurred.</p>
        capo_devops_guru.errors.throttling_exception.ThrottlingException: <p>The request was denied due to a request throttling.</p>
        capo_devops_guru.errors.validation_exception.ValidationException: <p> Contains information about data passed in to a field during a request that is not valid. </p>
        capo_devops_guru.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    def _handler(
        req: "OperationRequest[capo_devops_guru.types.list_organization_insights_request.ListOrganizationInsightsRequest]",
    ) -> OperationResponse[
        "capo_devops_guru.types.list_organization_insights_response.ListOrganizationInsightsResponse"
    ]:
        import capo_devops_guru._operations.capstone_control_plane_service.list_organization_insights

        output, http_response = (
            capo_devops_guru._operations.capstone_control_plane_service.list_organization_insights.list_organization_insights(
                req.options, req.input
            )
        )
        return OperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("ListOrganizationInsights")
    )
    input_: capo_devops_guru.types.list_organization_insights_request.ListOrganizationInsightsRequest = {
        "status_filter": status_filter
    }
    if max_results is not None:
        input_["max_results"] = max_results
    if account_ids is not None:
        input_["account_ids"] = account_ids
    if organizational_unit_ids is not None:
        input_["organizational_unit_ids"] = organizational_unit_ids
    if next_token is not None:
        input_["next_token"] = next_token

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