New action: `aws_ec2_stop_instance` #43700

YakDriver · 2025-08-04T16:59:49Z

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:

This PR introduces the very first Terraform Action in the AWS Provider: aws_ec2_stop_instance! 🎉

Terraform Actions are an exciting new feature in Terraform Core that allow users to model imperative, side-effecting operations—like stopping an EC2 instance—within the plan and apply lifecycle. Actions can be triggered directly via terraform invoke or automatically as part of resource lifecycle events using the new lifecycle.action_trigger block.

This first Action provides support for stopping an EC2 instance by ID. It’s especially useful for cost-saving workflows, controlled shutdowns during infrastructure updates, and testing Terraform Actions in a real-world scenario. Here's an example of how to use it:

resource "aws_instance" "test" {
  ami           = data.aws_ami.amzn2-ami-minimal-hvm-ebs-x86_64.id
  instance_type = data.aws_ec2_instance_type_offering.available.instance_type

  tags = {
    Name = "example-test"
  }
}

action "aws_ec2_stop_instance" "test" {
  config {
    instance_id = aws_instance.test.id
    force       = true
  }
}

resource "terraform_data" "trigger" {
  input = "trigger"
  lifecycle {
    action_trigger {
      events  = [before_create, before_update]
      actions = [action.aws_ec2_stop_instance.test]
    }
  }
}

This will automatically stop the instance before any create or update operation on the terraform_data.trigger resource, helping you integrate safe shutdown behavior into your infrastructure workflows.

Big thanks to the Terraform Core and Plugin Framework teams for enabling this new model—we’re just getting started!

Relations

References

Output from Acceptance Testing

% make t T=TestAccEC2StopInstanceAction_ K=ec2
make: Verifying source code with gofmt...
==> Checking that code complies with gofmt requirements...
TF_ACC=1 go1.24.5 test ./internal/service/ec2/... -v -count 1 -parallel 20 -run='TestAccEC2StopInstanceAction_'  -timeout 360m -vet=off
2025/08/06 10:53:42 Creating Terraform AWS Provider (SDKv2-style)...
2025/08/06 10:53:42 Initializing Terraform AWS Provider (SDKv2-style)...
=== RUN   TestAccEC2StopInstanceAction_basic
=== PAUSE TestAccEC2StopInstanceAction_basic
=== RUN   TestAccEC2StopInstanceAction_trigger
=== PAUSE TestAccEC2StopInstanceAction_trigger
=== CONT  TestAccEC2StopInstanceAction_basic
=== CONT  TestAccEC2StopInstanceAction_trigger
=== NAME  TestAccEC2StopInstanceAction_basic
    stop_instance_action_test.go:321: Progress: Starting stop operation for EC2 instance i-00a0743004675184d...
    stop_instance_action_test.go:321: Progress: Sending stop command to EC2 instance i-00a0743004675184d...
    stop_instance_action_test.go:321: Progress: Stop command sent to EC2 instance i-00a0743004675184d, waiting for instance to stop...
    stop_instance_action_test.go:321: Progress: EC2 instance i-00a0743004675184d is currently in state 'stopping', continuing to wait for 'stopped'...
    stop_instance_action_test.go:321: Progress: EC2 instance i-00a0743004675184d is currently in state 'stopped', continuing to wait for 'stopped'...
    stop_instance_action_test.go:321: Progress: EC2 instance i-00a0743004675184d has been successfully stopped
--- PASS: TestAccEC2StopInstanceAction_basic (114.93s)
--- PASS: TestAccEC2StopInstanceAction_trigger (329.06s)
PASS
ok  	github.com/hashicorp/terraform-provider-aws/internal/service/ec2	334.449s

github-actions · 2025-08-04T17:00:00Z

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:24:58Z

Recent:

% make t T=TestAccEC2StopInstanceAction_ K=ec2       
make: Verifying source code with gofmt...
==> Checking that code complies with gofmt requirements...
make: Running acceptance tests on branch: 🌿 f-ec2-instance-action-2 🌿...
TF_ACC=1 go1.24.6 test ./internal/service/ec2/... -v -count 1 -parallel 20 -run='TestAccEC2StopInstanceAction_'  -timeout 360m -vet=off
2025/09/16 23:21:45 Creating Terraform AWS Provider (SDKv2-style)...
2025/09/16 23:21:45 Initializing Terraform AWS Provider (SDKv2-style)...
=== RUN   TestAccEC2StopInstanceAction_basic
=== PAUSE TestAccEC2StopInstanceAction_basic
=== RUN   TestAccEC2StopInstanceAction_trigger
=== PAUSE TestAccEC2StopInstanceAction_trigger
=== CONT  TestAccEC2StopInstanceAction_basic
=== CONT  TestAccEC2StopInstanceAction_trigger
=== NAME  TestAccEC2StopInstanceAction_basic
    ec2_stop_instance_action_test.go:321: Progress: Starting stop operation for EC2 instance i-02805387ef8ba7f52...
    ec2_stop_instance_action_test.go:321: Progress: Sending stop command to EC2 instance i-02805387ef8ba7f52...
    ec2_stop_instance_action_test.go:321: Progress: Stop command sent to EC2 instance i-02805387ef8ba7f52, waiting for instance to stop...
    ec2_stop_instance_action_test.go:321: Progress: EC2 instance i-02805387ef8ba7f52 is currently in state 'stopping', continuing to wait for 'stopped'...
    ec2_stop_instance_action_test.go:321: Progress: EC2 instance i-02805387ef8ba7f52 is currently in state 'stopping', continuing to wait for 'stopped'...
    ec2_stop_instance_action_test.go:321: Progress: EC2 instance i-02805387ef8ba7f52 has been successfully stopped
--- PASS: TestAccEC2StopInstanceAction_basic (134.99s)
--- PASS: TestAccEC2StopInstanceAction_trigger (141.83s)
PASS
ok  	github.com/hashicorp/terraform-provider-aws/internal/service/ec2	147.577s

YakDriver · 2025-09-17T16:13:42Z

After rebase:

% make t T=TestAccEC2StopInstanceAction_ K=ec2
make: Verifying source code with gofmt...
==> Checking that code complies with gofmt requirements...
make: Running acceptance tests on branch: 🌿 f-ec2-instance-action-2 🌿...
TF_ACC=1 go1.24.6 test ./internal/service/ec2/... -v -count 1 -parallel 20 -run='TestAccEC2StopInstanceAction_'  -timeout 360m -vet=off
2025/09/17 12:11:08 Creating Terraform AWS Provider (SDKv2-style)...
2025/09/17 12:11:08 Initializing Terraform AWS Provider (SDKv2-style)...
=== RUN   TestAccEC2StopInstanceAction_basic
=== PAUSE TestAccEC2StopInstanceAction_basic
=== RUN   TestAccEC2StopInstanceAction_trigger
=== PAUSE TestAccEC2StopInstanceAction_trigger
=== CONT  TestAccEC2StopInstanceAction_basic
=== CONT  TestAccEC2StopInstanceAction_trigger
=== NAME  TestAccEC2StopInstanceAction_basic
    ec2_stop_instance_action_test.go:328: Progress: Starting stop operation for EC2 instance i-07707afd411368dc3...
    ec2_stop_instance_action_test.go:328: Progress: Sending stop command to EC2 instance i-07707afd411368dc3...
    ec2_stop_instance_action_test.go:328: Progress: Stop command sent to EC2 instance i-07707afd411368dc3, waiting for instance to stop...
    ec2_stop_instance_action_test.go:328: Progress: EC2 instance i-07707afd411368dc3 is currently in state 'stopping', continuing to wait for 'stopped'...
    ec2_stop_instance_action_test.go:328: Progress: EC2 instance i-07707afd411368dc3 is currently in state 'stopped', continuing to wait for 'stopped'...
    ec2_stop_instance_action_test.go:328: Progress: EC2 instance i-07707afd411368dc3 has been successfully stopped
--- PASS: TestAccEC2StopInstanceAction_trigger (91.04s)
--- PASS: TestAccEC2StopInstanceAction_basic (114.35s)
PASS
ok  	github.com/hashicorp/terraform-provider-aws/internal/service/ec2	120.180s

jar-b

LGTM 🎉

% TF_ACC_TERRAFORM_PATH=/Users/jaredbaker/go/bin/terraform make t K=ec2 T=TestAccEC2StopInstanceAction_
make: Verifying source code with gofmt...
==> Checking that code complies with gofmt requirements...
make: Running acceptance tests on branch: 🌿 f-ec2-instance-action-2 🌿...
TF_ACC=1 go1.24.6 test ./internal/service/ec2/... -v -count 1 -parallel 20 -run='TestAccEC2StopInstanceAction_'  -timeout 360m -vet=off
2025/09/17 15:46:15 Creating Terraform AWS Provider (SDKv2-style)...
2025/09/17 15:46:15 Initializing Terraform AWS Provider (SDKv2-style)...
=== RUN   TestAccEC2StopInstanceAction_basic
=== PAUSE TestAccEC2StopInstanceAction_basic
=== RUN   TestAccEC2StopInstanceAction_trigger
=== PAUSE TestAccEC2StopInstanceAction_trigger
=== CONT  TestAccEC2StopInstanceAction_basic
=== CONT  TestAccEC2StopInstanceAction_trigger
=== NAME  TestAccEC2StopInstanceAction_basic
    ec2_stop_instance_action_test.go:328: Progress: Starting stop operation for EC2 instance i-0c00d744db5856923...
    ec2_stop_instance_action_test.go:328: Progress: Sending stop command to EC2 instance i-0c00d744db5856923...
    ec2_stop_instance_action_test.go:328: Progress: Stop command sent to EC2 instance i-0c00d744db5856923, waiting for instance to stop...
    ec2_stop_instance_action_test.go:328: Progress: EC2 instance i-0c00d744db5856923 is currently in state 'stopping', continuing to wait for 'stopped'...
    ec2_stop_instance_action_test.go:328: Progress: EC2 instance i-0c00d744db5856923 is currently in state 'stopping', continuing to wait for 'stopped'...
    ec2_stop_instance_action_test.go:328: Progress: EC2 instance i-0c00d744db5856923 has been successfully stopped
--- PASS: TestAccEC2StopInstanceAction_basic (125.10s)
--- PASS: TestAccEC2StopInstanceAction_trigger (131.65s)
PASS
ok      github.com/hashicorp/terraform-provider-aws/internal/service/ec2        138.603s

github-actions · 2025-09-17T20:00:50Z

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:11:05Z

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!

github-actions · 2025-10-19T02:26:47Z

I'm going to lock this pull request 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 related to this change, please open a new issue and complete the issue template so we can capture all the details necessary to investigate further.

YakDriver force-pushed the f-ec2-instance-action-2 branch from d7b5734 to 636f7cb Compare August 5, 2025 19:26

YakDriver changed the title ~~First action~~ First action: aws_ec2_stop_instance Aug 6, 2025

YakDriver changed the title ~~First action: aws_ec2_stop_instance~~ First action: aws_ec2_stop_instance Aug 6, 2025

YakDriver force-pushed the f-ec2-instance-action-2 branch from 9e884a9 to 2020d3a Compare August 6, 2025 18:26

YakDriver mentioned this pull request Aug 6, 2025

Actions plumbing #43669

Merged

7 tasks

YakDriver force-pushed the f-ec2-instance-action-2 branch from 2020d3a to bbf1826 Compare August 18, 2025 21:26

github-actions bot added the service/ec2 Issues and PRs that pertain to the ec2 service. label Aug 18, 2025

YakDriver added 4 commits August 18, 2025 18:30

Add stop instance action

2122a46

Add tests for instance action

14ab4e4

Service package gen

a03acf4

Add changelog

a689ba9

YakDriver force-pushed the f-ec2-instance-action-2 branch from bbf1826 to a689ba9 Compare August 18, 2025 22:34

YakDriver mentioned this pull request Aug 19, 2025

New action: aws_cloudfront_create_invalidation #43955

Merged

15 tasks

YakDriver changed the title ~~First action: aws_ec2_stop_instance~~ New action: aws_ec2_stop_instance Aug 20, 2025

YakDriver mentioned this pull request Aug 20, 2025

New action: aws_lambda_invoke #43972

Merged

14 tasks

This was referenced Sep 10, 2025

New action: aws_ses_send_email #44214

Merged

New action: aws_sns_publish #44232

Merged

Add documentation

00d29f4

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

YakDriver added 4 commits September 10, 2025 18:39

Update docs

f25b007

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

9a3ee62

Simplify actions

33eab1b

Fix website docs

e318128

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

Use region pattern

f0aef91

YakDriver added 3 commits September 17, 2025 12:06

Merge remote-tracking branch 'origin/main' into f-ec2-instance-action-2

376d016

Upgrade terraform-plugin-testing

4100103

Add test guard by TF version

5802852

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

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

YakDriver added 2 commits September 17, 2025 14:08

Move note higher

c374209

Move note lil lower

da1e3f5

jar-b approved these changes Sep 17, 2025

View reviewed changes

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

YakDriver deleted the f-ec2-instance-action-2 branch September 17, 2025 20:00

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

github-actions bot locked as resolved and limited conversation to collaborators Oct 19, 2025

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

New action: `aws_ec2_stop_instance` #43700

New action: `aws_ec2_stop_instance` #43700

Uh oh!

YakDriver commented Aug 4, 2025 •

edited

Loading

Uh oh!

github-actions bot commented Aug 4, 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!

github-actions bot commented Oct 19, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

New action: aws_ec2_stop_instance #43700

New action: aws_ec2_stop_instance #43700

Uh oh!

Conversation

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

Uh oh!

Rollback Plan

Changes to Security Controls

Description

Relations

References

Output from Acceptance Testing

Uh oh!

github-actions bot commented Aug 4, 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!

github-actions bot commented Oct 19, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

New action: `aws_ec2_stop_instance` #43700

New action: `aws_ec2_stop_instance` #43700

YakDriver commented Aug 4, 2025 •

edited

Loading