Resource: aws_ec2_instance_state

Provides an EC2 instance state resource. This allows managing an instance power state.

Example Usage

data "aws_ami" "ubuntu" {
  most_recent = true

  filter {
    name   = "name"
    values = ["ubuntu/images/hvm-ssd/ubuntu-focal-20.04-amd64-server-*"]
  }

  filter {
    name   = "virtualization-type"
    values = ["hvm"]
  }

  owners = ["099720109477"] # Canonical
}

resource "aws_instance" "test" {
  ami           = data.aws_ami.ubuntu.id
  instance_type = "t3.micro"

  tags = {
    Name = "HelloWorld"
  }
}

resource "aws_ec2_instance_state" "test" {
  instance_id = aws_instance.test.id
  state       = "stopped"
}

Argument Reference

The following arguments are required:

The following arguments are optional:

Attribute Reference

This resource exports the following attributes in addition to the arguments above:

Timeouts

Configuration options:

Import

In Terraform v1.5.0 and later, use an import block to import aws_ec2_instance_state using the instance_id attribute. For example:

import {
  to = aws_ec2_instance_state.test
  id = "i-02cae6557dfcf2f96"
}

Using terraform import, import aws_ec2_instance_state using the instance_id attribute. For example:

% terraform import aws_ec2_instance_state.test i-02cae6557dfcf2f96