[ aws . auditmanager ]

get-evidence-by-evidence-folder

Description

Returns all evidence from a specified evidence folder in Audit Manager.

See also: AWS API Documentation

See ‘aws help’ for descriptions of global parameters.

Synopsis

  get-evidence-by-evidence-folder
--assessment-id <value>
--control-set-id <value>
--evidence-folder-id <value>
[--next-token <value>]
[--max-results <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]

Options

--assessment-id (string)

The identifier for the assessment.

--control-set-id (string)

The identifier for the control set.

--evidence-folder-id (string)

The unique identifier for the folder that the evidence is stored in.

--next-token (string)

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

--max-results (integer)

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

--cli-input-json | --cli-input-yaml (string) Reads arguments from the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, those values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally. This may not be specified along with --cli-input-yaml.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. Similarly, if provided yaml-input it will print a sample input YAML that can be used with --cli-input-yaml. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See ‘aws help’ for descriptions of global parameters.

Output

evidence -> (list)

The list of evidence that the GetEvidenceByEvidenceFolder API returned.

(structure)

A record that contains the information needed to demonstrate compliance with the requirements specified by a control. Examples of evidence include change activity triggered by a user, or a system configuration snapshot.

dataSource -> (string)

The data source where the evidence was collected from.

evidenceAwsAccountId -> (string)

The identifier for the Amazon Web Services account.

time -> (timestamp)

The timestamp that represents when the evidence was collected.

eventSource -> (string)

The Amazon Web Service that the evidence is collected from.

eventName -> (string)

The name of the evidence event.

evidenceByType -> (string)

The type of automated evidence.

resourcesIncluded -> (list)

The list of resources that are assessed to generate the evidence.

(structure)

A system asset that’s evaluated in an Audit Manager assessment.

arn -> (string)

The Amazon Resource Name (ARN) for the resource.

value -> (string)

The value of the resource.

attributes -> (map)

The names and values that are used by the evidence event. This includes an attribute name (such as allowUsersToChangePassword ) and value (such as true or false ).

key -> (string)

value -> (string)

iamId -> (string)

The unique identifier for the IAM user or role that’s associated with the evidence.

complianceCheck -> (string)

The evaluation status for evidence that falls under the compliance check category. For evidence collected from Security Hub, a Pass or Fail result is shown. For evidence collected from Config, a Compliant or Noncompliant result is shown.

awsOrganization -> (string)

The Amazon Web Services account that the evidence is collected from, and its organization path.

awsAccountId -> (string)

The identifier for the Amazon Web Services account.

evidenceFolderId -> (string)

The identifier for the folder that the evidence is stored in.

id -> (string)

The identifier for the evidence.

assessmentReportSelection -> (string)

Specifies whether the evidence is included in the assessment report.

nextToken -> (string)

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