Skip to main content

assessment_control_insights_by_control_domains

Creates, updates, deletes, gets or lists an assessment_control_insights_by_control_domains resource.

Overview

Nameassessment_control_insights_by_control_domains
TypeResource
Idaws.auditmanager.assessment_control_insights_by_control_domains

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
control_insights_by_assessmentarrayThe assessment control analytics data that the ListAssessmentControlInsightsByControlDomain API returned.
next_tokenstringThe pagination token that's used to fetch the next set of results. (pattern: <code>^[A-Za-z0-9+/=]*$</code>)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
list_assessment_control_insights_by_control_domainselectcontrolDomainId, assessmentId, regionnextToken, maxResultsLists the latest analytics data for controls within a specific control domain and a specific active assessment. Control insights are listed only if the control belongs to the control domain and assessment that was specified. Moreover, the control must have collected evidence on the lastUpdated date of controlInsightsByAssessment. If neither of these conditions are met, no data is listed for that control.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
assessmentIdstringThe unique identifier for the active assessment.
controlDomainIdstringThe 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.
regionstringAWS region (default: us-east-1)
maxResultsintegerRepresents the maximum number of results on a page or for an API request call.
nextTokenstringThe pagination token that's used to fetch the next set of results.

SELECT examples

Lists the latest analytics data for controls within a specific control domain and a specific active assessment. Control insights are listed only if the control belongs to the control domain and assessment that was specified. Moreover, the control must have collected evidence on the lastUpdated date of controlInsightsByAssessment. If neither of these conditions are met, no data is listed for that control.

SELECT
control_insights_by_assessment,
next_token
FROM aws.auditmanager.assessment_control_insights_by_control_domains
WHERE controlDomainId = '{{ controlDomainId }}' -- required
AND assessmentId = '{{ assessmentId }}' -- required
AND region = '{{ region }}' -- required
AND nextToken = '{{ nextToken }}'
AND maxResults = '{{ maxResults }}'
;