Changing the status of an assessment to inactive - AWS Audit Manager

Changing the status of an assessment to inactive

When you no longer need to collect evidence for an assessment, you can change the assessment status to Inactive. When the status of an assessment changes to inactive, the assessment stops collecting evidence. As a result, you no longer incur any charges for that assessment.

In addition to stopping evidence collection, Audit Manager makes the following changes to the controls that are within the inactive assessment:

  • All control sets change to Reviewed status.

  • All controls that are Under review change to Reviewed status.

  • Delegates for the inactive assessment can no longer view or edit its controls and control sets.

Warning

This action is irreversible. We recommend that you proceed with caution and make sure that you want to mark your assessment as inactive. When an assessment is inactive, you have read-only access to its contents. This means that you can still review previously collected evidence and generate assessment reports. However, you can’t edit the inactive assessment, add comments, or upload any manual evidence.

Audit Manager console
To change an assessment status to inactive (console)

  1. Open the AWS Audit Manager console at https://console.aws.amazon.com/auditmanager/home.

  2. In the navigation pane, choose Assessments.

  3. Choose the name of the assessment to open it.

  4. On the upper-right corner of the page, choose Update assessment status, and then choose Inactive.

  5. Choose Update status in the pop-up window to confirm that you want to change the status to inactive.

The changes to the assessment and its controls take effect after approximately one minute.

AWS CLI
To change an assessment status to inactive (AWS CLI)

  1. First, identify the assessment that you want to update. To do this, run the list-assessments command.

     aws auditmanager list-assessments

    The response returns a list of assessments. Find the assessment that you want to deactivate, and take note of the assessment ID.

  2. Next, run the update-assessment-status command and specify the following parameters:

    • --assessment-id – Use this parameter to specify the assessment that you want to deactivate.

    • --status – Set this value to INACTIVE.

    In the following example, replace the placeholder text with your own information.

    aws auditmanager update-assessment-status --assessment-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 --status INACTIVE

The changes to the assessment and its controls take effect after approximately one minute.

Audit Manager API
To change an assessment status to inactive (API)

  1. Use the ListAssessments operation to find the assessment that you want to deactivate, and take note of the assessment ID.

  2. Use the UpdateAssessmentStatus operation and specify the following parameters:

    • assessmentId – Use this parameter to specify the assessment that you want to deactivate.

    • status – Set this value to INACTIVE.

The changes to the assessment and its controls take effect after approximately one minute.

For more information about these API operations, choose any of the previous links to read more in the AWS Audit Manager API Reference. This includes information about how to use these operations and parameters in one of the language-specific AWS SDKs.