New action: `aws_sns_publish` #44232

YakDriver · 2025-09-10T20:18:53Z

Rollback Plan

If a change needs to be reverted, we will publish an updated version of the library.

Changes to Security Controls

Are there any changes to security controls (access controls, encryption, logging) in this pull request? If so, explain.

Description

Since these actions may be merged in bulk, extra checklist to help:

Add `aws_sns_publish` Action

This PR adds a new Terraform action for publishing messages to Amazon SNS topics. The action enables imperative message publishing with support for message attributes, subjects, and different message structures.

Example Usage

action "aws_sns_publish" "notification" {
  config {
    topic_arn = aws_sns_topic.alerts.arn
    message   = "Deployment completed successfully"
    subject   = "Deployment Status"
    
    message_attributes {
      map_block_key = "priority"
      data_type     = "String"
      string_value  = "high"
    }
  }
}

resource "terraform_data" "deploy_trigger" {
  lifecycle {
    action_trigger {
      events  = [after_create]
      actions = [action.aws_sns_publish.notification]
    }
  }
}

Features

Publishes messages to SNS topics during Terraform operations
Supports message attributes for metadata
Optional subject for email protocols
JSON message structure support
Built using the Plugin Framework with AutoFlex for type conversion

Relations

References

Output from Acceptance Testing

% make t T=TestAccSNSPublishAction K=sns             
make: Verifying source code with gofmt...
==> Checking that code complies with gofmt requirements...
TF_ACC=1 go1.24.6 test ./internal/service/sns/... -v -count 1 -parallel 20 -run='TestAccSNSPublishAction'  -timeout 360m -vet=off
2025/09/10 17:06:16 Creating Terraform AWS Provider (SDKv2-style)...
2025/09/10 17:06:16 Initializing Terraform AWS Provider (SDKv2-style)...
=== RUN   TestAccSNSPublishAction_basic
=== PAUSE TestAccSNSPublishAction_basic
=== RUN   TestAccSNSPublishAction_withAttributes
=== PAUSE TestAccSNSPublishAction_withAttributes
=== CONT  TestAccSNSPublishAction_basic
=== CONT  TestAccSNSPublishAction_withAttributes
--- PASS: TestAccSNSPublishAction_basic (97.70s)
--- PASS: TestAccSNSPublishAction_withAttributes (97.79s)
PASS
ok  	github.com/hashicorp/terraform-provider-aws/internal/service/sns	103.052s

github-actions · 2025-09-10T20:19:08Z

Community Guidelines

This comment is added to every new Pull Request to provide quick reference to how the Terraform AWS Provider is maintained. Please review the information below, and thank you for contributing to the community that keeps the provider thriving! 🚀

Voting for Prioritization

Please vote on this Pull Request by adding a 👍 reaction to the original post to help the community and maintainers prioritize it.
Please see our prioritization guide for additional information on how the maintainers handle prioritization.
Please do not leave +1 or other comments that do not add relevant new information or questions; they generate extra noise for others following the Pull Request and do not help prioritize the request.

Pull Request Authors

Review the contribution guide relating to the type of change you are making to ensure all of the necessary steps have been taken.
Whether or not the branch has been rebased will not impact prioritization, but doing so is always a welcome surprise.

YakDriver · 2025-09-17T03:08:28Z

Latest:

% make t T=TestAccSNSPublishAction K=sns
make: Verifying source code with gofmt...
==> Checking that code complies with gofmt requirements...
make: Running acceptance tests on branch: 🌿 f-aws_sns_publish_message 🌿...
TF_ACC=1 go1.24.6 test ./internal/service/sns/... -v -count 1 -parallel 20 -run='TestAccSNSPublishAction'  -timeout 360m -vet=off
2025/09/16 22:42:07 Creating Terraform AWS Provider (SDKv2-style)...
2025/09/16 22:42:07 Initializing Terraform AWS Provider (SDKv2-style)...
=== RUN   TestAccSNSPublishAction_basic
=== PAUSE TestAccSNSPublishAction_basic
=== RUN   TestAccSNSPublishAction_withAttributes
=== PAUSE TestAccSNSPublishAction_withAttributes
=== CONT  TestAccSNSPublishAction_basic
=== CONT  TestAccSNSPublishAction_withAttributes
--- PASS: TestAccSNSPublishAction_withAttributes (98.50s)
--- PASS: TestAccSNSPublishAction_basic (98.51s)
PASS
ok  	github.com/hashicorp/terraform-provider-aws/internal/service/sns	103.802s

…sage

YakDriver · 2025-09-17T16:04:27Z

After rebasing:

% make t T=TestAccSNSPublishAction_ K=sns       
make: Verifying source code with gofmt...
==> Checking that code complies with gofmt requirements...
make: Running acceptance tests on branch: 🌿 f-aws_sns_publish_message 🌿...
TF_ACC=1 go1.24.6 test ./internal/service/sns/... -v -count 1 -parallel 20 -run='TestAccSNSPublishAction_'  -timeout 360m -vet=off
2025/09/17 12:02:14 Creating Terraform AWS Provider (SDKv2-style)...
2025/09/17 12:02:14 Initializing Terraform AWS Provider (SDKv2-style)...
=== RUN   TestAccSNSPublishAction_basic
=== PAUSE TestAccSNSPublishAction_basic
=== RUN   TestAccSNSPublishAction_withAttributes
=== PAUSE TestAccSNSPublishAction_withAttributes
=== CONT  TestAccSNSPublishAction_basic
=== CONT  TestAccSNSPublishAction_withAttributes
--- PASS: TestAccSNSPublishAction_basic (97.50s)
--- PASS: TestAccSNSPublishAction_withAttributes (97.59s)
PASS
ok  	github.com/hashicorp/terraform-provider-aws/internal/service/sns	103.131s

jar-b

LGTM 🎉

% TF_ACC_TERRAFORM_PATH=/Users/jaredbaker/go/bin/terraform make t K=sns T=TestAccSNSPublishAction_
make: Verifying source code with gofmt...
==> Checking that code complies with gofmt requirements...
make: Running acceptance tests on branch: 🌿 f-aws_sns_publish_message 🌿...
TF_ACC=1 go1.24.6 test ./internal/service/sns/... -v -count 1 -parallel 20 -run='TestAccSNSPublishAction_'  -timeout 360m -vet=off
2025/09/17 15:39:51 Creating Terraform AWS Provider (SDKv2-style)...
2025/09/17 15:39:51 Initializing Terraform AWS Provider (SDKv2-style)...

--- PASS: TestAccSNSPublishAction_withAttributes (97.28s)
--- PASS: TestAccSNSPublishAction_basic (97.28s)
PASS
ok      github.com/hashicorp/terraform-provider-aws/internal/service/sns        103.937s

github-actions · 2025-09-17T19:44:41Z

Warning

This Issue has been closed, meaning that any additional comments are much easier for the maintainers to miss. Please assume that the maintainers will not see them.

Ongoing conversations amongst community members are welcome, however, the issue will be locked after 30 days. Moving conversations to another venue, such as the AWS Provider forum, is recommended. If you have additional concerns, please open a new issue, referencing this one where needed.

github-actions · 2025-09-18T22:10:29Z

This functionality has been released in v6.14.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!

Register new action

04d2572

YakDriver added 5 commits September 10, 2025 16:53

Add changelog

6c2c5ee

Rename action

31b7095

New action: publish

173cef8

Test new action

c4fa4bc

Add docs

98d811f

github-actions bot added the documentation Introduces or discusses updates to documentation. label Sep 10, 2025

YakDriver changed the title ~~New action: aws_sns_publish~~ New action: aws_sns_publish Sep 10, 2025

This was referenced Sep 10, 2025

New action: aws_lambda_invoke #43972

Merged

New action: aws_cloudfront_create_invalidation #43955

Merged

New action: aws_ses_send_email #44214

Merged

Add changelog

ac0f4dd

This was referenced Sep 10, 2025

New action: aws_ec2_stop_instance #43700

Merged

Actions plumbing #43669

Merged

YakDriver added 5 commits September 10, 2025 18:45

Update docs

96044bc

Update warning note

1e0cd11

Merge branch 'f-ec2-instance-action' into f-aws_sns_publish_message

8aff646

Update for simplified actions

35cc1c7

Fix docs

38749b6

github-actions bot added linter Pertains to changes to or issues with the various linters. repository Repository modifications; GitHub Actions, developer docs, issue templates, codeowners, changelog. labels Sep 17, 2025

Fix subcat

b916d34

YakDriver added 4 commits September 16, 2025 23:33

Use region pattern

c8ba830

Merge remote-tracking branch 'origin/main' into f-aws_sns_publish_mes…

2682dab

…sage

Upgrade terraform-plugin-testing

445d220

Add test guard by TF version

9eb01fe

YakDriver marked this pull request as ready for review September 17, 2025 16:05

YakDriver requested a review from a team as a code owner September 17, 2025 16:05

YakDriver added 2 commits September 17, 2025 14:07

Move note higher

d434258

Move note lil lower

ccb5a5f

jar-b approved these changes Sep 17, 2025

View reviewed changes

YakDriver merged commit 2e87167 into main Sep 17, 2025
72 checks passed

YakDriver deleted the f-aws_sns_publish_message branch September 17, 2025 19:44

github-actions bot added this to the v6.14.0 milestone Sep 17, 2025

This was referenced Sep 18, 2025

feat: support new-action entry types hashicorp/go-changelog#45

Merged

.ci/scripts: support for new-action entry types #44352

Merged

github-actions bot removed the prioritized Part of the maintainer teams immediate focus. To be addressed within the current quarter. label Sep 18, 2025

YakDriver mentioned this pull request Sep 25, 2025

New action: aws_codebuild_start_build #44444

Open

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

New action: `aws_sns_publish` #44232

New action: `aws_sns_publish` #44232

YakDriver commented Sep 10, 2025 •

edited

Loading

Uh oh!

github-actions bot commented Sep 10, 2025

Uh oh!

YakDriver commented Sep 17, 2025

Uh oh!

YakDriver commented Sep 17, 2025

Uh oh!

jar-b left a comment

Uh oh!

Uh oh!

github-actions bot commented Sep 17, 2025

Uh oh!

github-actions bot commented Sep 18, 2025

Uh oh!

Uh oh!

New action: aws_sns_publish #44232

New action: aws_sns_publish #44232

Conversation

YakDriver commented Sep 10, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Rollback Plan

Changes to Security Controls

Description

Add aws_sns_publish Action

Example Usage

Features

Relations

References

Output from Acceptance Testing

Uh oh!

github-actions bot commented Sep 10, 2025

Community Guidelines

Voting for Prioritization

Pull Request Authors

Uh oh!

YakDriver commented Sep 17, 2025

Uh oh!

YakDriver commented Sep 17, 2025

Uh oh!

jar-b left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

github-actions bot commented Sep 17, 2025

Uh oh!

github-actions bot commented Sep 18, 2025

Uh oh!

Uh oh!

New action: `aws_sns_publish` #44232

New action: `aws_sns_publish` #44232

YakDriver commented Sep 10, 2025 •

edited

Loading

Add `aws_sns_publish` Action