Skip to content

Lists the latest analytics data for controls within a specific control domain across all active assessments

Description

Lists the latest analytics data for controls within a specific control domain across all active assessments.

Control insights are listed only if the control belongs to the control domain that was specified and the control collected evidence on the lastUpdated date of controlInsightsMetadata. If neither of these conditions are met, no data is listed for that control.

Usage

auditmanager_list_control_insights_by_control_domain(controlDomainId,
  nextToken, maxResults)

Arguments

  • controlDomainId

    [required] The unique identifier for the control domain.

    Audit Manager supports the control domains that are provided by Amazon Web Services Control Catalog. For information about how to find a list of available control domains, see ListDomains in the Amazon Web Services Control Catalog API Reference.

  • nextToken

    The pagination token that's used to fetch the next set of results.

  • maxResults

    Represents the maximum number of results on a page or for an API request call.

Value

A list with the following syntax:

list(
  controlInsightsMetadata = list(
    list(
      name = "string",
      id = "string",
      evidenceInsights = list(
        noncompliantEvidenceCount = 123,
        compliantEvidenceCount = 123,
        inconclusiveEvidenceCount = 123
      ),
      lastUpdated = as.POSIXct(
        "2015-01-01"
      )
    )
  ),
  nextToken = "string"
)

Request syntax

svc$list_control_insights_by_control_domain(
  controlDomainId = "string",
  nextToken = "string",
  maxResults = 123
)