New resource aws_auditmanager_assessment

[jar-b]

This resource will allow practitioners to manage custom AuditManager assessments with Terraform.

SDK Reference

• CreateAssessment
• GetAssessment
• UpdateAssessment
• DeleteAssessment
• ListAssessments (filterable by status “Active”/”Inactive”)

Potential Terraform Configuration

resource "aws_auditmanager_assessment" "test" {
  name = "example"

  assessment_reports_destination {
    destination      = "s3://example-bucket"
    destination_type = "S3"
  }

  framework_id = aws_auditmanager_framework.test.id

  roles {
    role_arn  = "arn:aws:iam:012345678901::role/example-role"
    role_type = "PROCESS_OWNER"
  }

  scope {
    # NOTE: if only account ID is required, these may be good candidates
    # to simplify into lists of strings. Eg.
    #
    # aws_accounts = ["012345678901", "012345678900"]
    # aws_services = ["s3", "cloudtrail"]
    aws_accounts {
      id = "012345678900"
    }
    aws_services {
      service_name = "S3"
    }
  }
}

Arguments

• assessment_reports_destination - (Required) Assessment report storage destination configuration.
  • destination - (Required) Destination of the assessment report.
  • destination_type - (Required) Destination type. Currently, S3 is the only valid value.
• framework_id - (Required) Unique identifier of the framework the assessment will be created from.
• name - (Required) Name of the assessment.
• roles - (Required) List of roles for the assessment.
  • role_arn - (Required) Amazon Resource Name (ARN) of the IAM role.
  • role_type - (Required) Type of customer persona. For assessment creation, type must always be PROCESS_OWNER.
• scope - (Required) Amazon Web Services accounts and services that are in scope for the assessment.
  • aws_accounts - Amazon Web Services accounts that are in scope for the assessment.
    • email_address - Email address associated with the Amazon Web Services account.
    • id - Identifier for the Amazon Web Services account.
    • name - Name of the Amazon Web Services account.
  • aws_services - Amazon Web Services services that are included in the scope of the assessment.
    • service_name - Name of the Amazon Web Service.
• description - (Optional) Description of the assessment.
• tags - (Optional)

Attributes

arn - Amazon Resource Name (ARN) of the assessment.
id - Unique identifier for the assessment.
status - Overall status of the assessment.

[github-actions]

Community Note

Voting for Prioritization

• Please vote on this issue by adding a 👍 reaction to the original post to help the community and maintainers prioritize this request.
• Please see our prioritization guide for information on how we prioritize.
• Please do not leave "+1" or other comments that do not add relevant new information or questions, they generate extra noise for issue followers and do not help prioritize the request.

Volunteering to Work on This Issue

• If you are interested in working on this issue, please leave a comment.
• If this would be your first contribution, please review the contribution guide.

[github-actions]

This functionality has been released in v4.49.0 of the Terraform AWS Provider. Please see the Terraform documentation on provider versioning or reach out if you need any assistance upgrading.

For further feature requests or bug reports with this functionality, please create a new GitHub issue following the template. Thank you!

[github-actions]

I'm going to lock this issue because it has been closed for 30 days ⏳. This helps our maintainers find and focus on the active issues.
If you have found a problem that seems similar to this, please open a new issue and complete the issue template so we can capture all the details necessary to investigate further.