[ aws . auditmanager ]

get-evidence-by-evidence-folder

Description

Returns all evidence from a specified evidence folder in AWS 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 specified assessment.

--control-set-id (string)

The identifier for the control set.

--evidence-folder-id (string)

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

--next-token (string)

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

--max-results (integer)

Represents the maximum number of results per page, or per 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 returned by the GetEvidenceByEvidenceFolder API.

(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 from which the specified evidence was collected.

evidenceAwsAccountId -> (string)

The identifier for the specified AWS account.

time -> (timestamp)

The timestamp that represents when the evidence was collected.

eventSource -> (string)

The AWS service from which the evidence is collected.

eventName -> (string)

The name of the specified evidence event.

evidenceByType -> (string)

The type of automated evidence.

resourcesIncluded -> (list)

The list of resources assessed to generate the evidence.

(structure)

A system asset that is evaluated in an AWS Audit Manager assessment.

arn -> (string)

The Amazon Resource Name (ARN) for the specified resource.

value -> (string)

The value of the specified resource.

attributes -> (map)

The names and values used by the evidence event, including 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 associated with the evidence.

complianceCheck -> (string)

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

awsOrganization -> (string)

The AWS account from which the evidence is collected, and its AWS organization path.

awsAccountId -> (string)

The identifier for the specified AWS account.

evidenceFolderId -> (string)

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

id -> (string)

The identifier for the evidence.

assessmentReportSelection -> (string)

Specifies whether the evidence is inclded in the assessment report.

nextToken -> (string)

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