Evidence
A record that contains the information needed to demonstrate compliance with the requirements specified by a control. Examples of evidence include change activity invoked by a user, or a system configuration snapshot.
Contents
- assessmentReportSelection
-
Specifies whether the evidence is included in the assessment report.
Type: String
Length Constraints: Minimum length of 0. Maximum length of 2048.
Pattern:
.*
Required: No
- attributes
-
The names and values that are used by the evidence event. This includes an attribute name (such as
allowUsersToChangePassword
) and value (such astrue
orfalse
).Type: String to string map
Key Length Constraints: Maximum length of 100.
Key Pattern:
^[\w\W\s\S]*$
Value Length Constraints: Maximum length of 200.
Value Pattern:
^[\w\W\s\S]*$
Required: No
- awsAccountId
-
The identifier for the AWS account.
Type: String
Length Constraints: Fixed length of 12.
Pattern:
^[0-9]{12}$
Required: No
- awsOrganization
-
The AWS account that the evidence is collected from, and its organization path.
Type: String
Length Constraints: Minimum length of 0. Maximum length of 2048.
Pattern:
.*
Required: No
- complianceCheck
-
The evaluation status for automated evidence that falls under the compliance check category.
-
Audit Manager classes evidence as non-compliant if Security Hub reports a Fail result, or if AWS Config reports a Non-compliant result.
-
Audit Manager classes evidence as compliant if Security Hub reports a Pass result, or if AWS Config reports a Compliant result.
-
If a compliance check isn't available or applicable, then no compliance evaluation can be made for that evidence. This is the case if the evidence uses AWS Config or Security Hub as the underlying data source type, but those services aren't enabled. This is also the case if the evidence uses an underlying data source type that doesn't support compliance checks (such as manual evidence, AWS API calls, or CloudTrail).
Type: String
Length Constraints: Minimum length of 0. Maximum length of 2048.
Pattern:
.*
Required: No
-
- dataSource
-
The data source where the evidence was collected from.
Type: String
Length Constraints: Minimum length of 0. Maximum length of 2048.
Pattern:
.*
Required: No
- eventName
-
The name of the evidence event.
Type: String
Length Constraints: Maximum length of 100.
Pattern:
^[\w\W\s\S]*$
Required: No
- eventSource
-
The AWS service that the evidence is collected from.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 40.
Pattern:
^[a-zA-Z0-9-\s().]+$
Required: No
- evidenceAwsAccountId
-
The identifier for the AWS account.
Type: String
Length Constraints: Fixed length of 12.
Pattern:
^[0-9]{12}$
Required: No
- evidenceByType
-
The type of automated evidence.
Type: String
Length Constraints: Minimum length of 0. Maximum length of 2048.
Pattern:
.*
Required: No
- evidenceFolderId
-
The identifier for the folder that the evidence is stored in.
Type: String
Length Constraints: Fixed length of 36.
Pattern:
^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$
Required: No
- iamId
-
The unique identifier for the user or role that's associated with the evidence.
Type: String
Length Constraints: Minimum length of 20. Maximum length of 2048.
Pattern:
^arn:.*:iam:.*
Required: No
- id
-
The identifier for the evidence.
Type: String
Length Constraints: Fixed length of 36.
Pattern:
^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$
Required: No
- resourcesIncluded
-
The list of resources that are assessed to generate the evidence.
Type: Array of Resource objects
Required: No
- time
-
The timestamp that represents when the evidence was collected.
Type: Timestamp
Required: No
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: