AuditManager / Client / batch_import_evidence_to_assessment_control
batch_import_evidence_to_assessment_control#
- AuditManager.Client.batch_import_evidence_to_assessment_control(**kwargs)#
Adds one or more pieces of evidence to a control in an Audit Manager assessment.
You can import manual evidence from any S3 bucket by specifying the S3 URI of the object. You can also upload a file from your browser, or enter plain text in response to a risk assessment question.
The following restrictions apply to this action:
manualEvidence
can be only one of the following:evidenceFileName
,s3ResourcePath
, ortextResponse
Maximum size of an individual evidence file: 100 MB
Number of daily manual evidence uploads per control: 100
Supported file formats: See Supported file types for manual evidence in the Audit Manager User Guide
For more information about Audit Manager service restrictions, see Quotas and restrictions for Audit Manager.
See also: AWS API Documentation
Request Syntax
response = client.batch_import_evidence_to_assessment_control( assessmentId='string', controlSetId='string', controlId='string', manualEvidence=[ { 's3ResourcePath': 'string', 'textResponse': 'string', 'evidenceFileName': 'string' }, ] )
- Parameters:
assessmentId (string) –
[REQUIRED]
The identifier for the assessment.
controlSetId (string) –
[REQUIRED]
The identifier for the control set.
controlId (string) –
[REQUIRED]
The identifier for the control.
manualEvidence (list) –
[REQUIRED]
The list of manual evidence objects.
(dict) –
Evidence that’s manually added to a control in Audit Manager.
manualEvidence
can be one of the following:evidenceFileName
,s3ResourcePath
, ortextResponse
.s3ResourcePath (string) –
The S3 URL of the object that’s imported as manual evidence.
textResponse (string) –
The plain text response that’s entered and saved as manual evidence.
evidenceFileName (string) –
The name of the file that’s uploaded as manual evidence. This name is populated using the
evidenceFileName
value from the GetEvidenceFileUploadUrl API response.
- Return type:
dict
- Returns:
Response Syntax
{ 'errors': [ { 'manualEvidence': { 's3ResourcePath': 'string', 'textResponse': 'string', 'evidenceFileName': 'string' }, 'errorCode': 'string', 'errorMessage': 'string' }, ] }
Response Structure
(dict) –
errors (list) –
A list of errors that the
BatchImportEvidenceToAssessmentControl
API returned.(dict) –
An error entity for the
BatchImportEvidenceToAssessmentControl
API. This is used to provide more meaningful errors than a simple string message.manualEvidence (dict) –
Manual evidence that can’t be collected automatically by Audit Manager.
s3ResourcePath (string) –
The S3 URL of the object that’s imported as manual evidence.
textResponse (string) –
The plain text response that’s entered and saved as manual evidence.
evidenceFileName (string) –
The name of the file that’s uploaded as manual evidence. This name is populated using the
evidenceFileName
value from the GetEvidenceFileUploadUrl API response.
errorCode (string) –
The error code that the
BatchImportEvidenceToAssessmentControl
API returned.errorMessage (string) –
The error message that the
BatchImportEvidenceToAssessmentControl
API returned.
Exceptions
AuditManager.Client.exceptions.ResourceNotFoundException
AuditManager.Client.exceptions.AccessDeniedException
AuditManager.Client.exceptions.ValidationException
AuditManager.Client.exceptions.InternalServerException
AuditManager.Client.exceptions.ThrottlingException