Skip to content

List Control Insights by Control Domain

auditmanager_list_control_insights_by_control_domain R Documentation

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
)