[Enhancement]: Support for pre/post scripts in DLM policy

[jaygridley]

Description

AWS introduced support for running SSM Documents when taking volume snapshots with Data Lifecycle Manager, see https://aws.amazon.com/about-aws/whats-new/2023/11/amazon-data-lifecycle-manager-pre-post-script-automation-ebs-snapshots/.

The AWS API is ready for this, see https://docs.aws.amazon.com/dlm/latest/APIReference/API_Script.html.

Support for this in the aws_dlm_lifecycle_policy resource would be nice. Currently, only local-exec workarounds are possible. There is no DLM support in the Cloud Control API.

Affected Resource(s) and/or Data Source(s)

• aws_dlm_lifecycle_policy

Potential Terraform Configuration

resource "aws_dlm_lifecycle_policy" "this" {
  description        = "DLM policy to create snapshots of EC2 volumes using pre/post scripts"
  execution_role_arn = "<ARN>"
  state              = "ENABLED"

  policy_details {
    resource_types = ["INSTANCE"]

    schedule {
      name = "<NAME>"

      create_rule {
        cron_expression = "cron(00 00 ? * SUN *)"

        script {
          stages = ["PRE", "POST"]
          execution_handler = "<SSM_DOCUMENT_ARN>"
        }
      }

      retain_rule {
        count = 1
      }
    }

    target_tags = {
      "backup" = "enabled"
    }
  }
}

References

• https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/automate-app-consistent-backups.html
• https://docs.aws.amazon.com/dlm/latest/APIReference/API_Script.html

Would you like to implement a fix?

None

[github-actions[bot]]

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.

[patstrom]

I've tried to implement this on my branch but I don't understand how to properly write and run tests for this. Can anyone help me out with this?