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, or textResponse

  • 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, or textResponse.

      • 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