pulumi-aws-kotlin/com.pulumi.aws.ec2transitgateway.kotlin/InstanceStateArgs

InstanceStateArgs

data class InstanceStateArgs(val force: Output<Boolean>? = null, val instanceId: Output<String>? = null, val state: Output<String>? = null) : ConvertibleToJava<InstanceStateArgs>

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

NOTE on Instance State Management: AWS does not currently have an EC2 API operation to determine an instance has finished processing user data. As a result, this resource can interfere with user data processing. For example, this resource may stop an instance while the user data script is in mid run.

Example Usage

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.ec2.Ec2Functions;
import com.pulumi.aws.ec2.inputs.GetAmiArgs;
import com.pulumi.aws.ec2.Instance;
import com.pulumi.aws.ec2.InstanceArgs;
import com.pulumi.aws.ec2transitgateway.InstanceState;
import com.pulumi.aws.ec2transitgateway.InstanceStateArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        final var ubuntu = Ec2Functions.getAmi(GetAmiArgs.builder()
            .mostRecent(true)
            .filters(
                GetAmiFilterArgs.builder()
                    .name("name")
                    .values("ubuntu/images/hvm-ssd/ubuntu-focal-20.04-amd64-server-*")
                    .build(),
                GetAmiFilterArgs.builder()
                    .name("virtualization-type")
                    .values("hvm")
                    .build())
            .owners("099720109477")
            .build());
        var testInstance = new Instance("testInstance", InstanceArgs.builder()
            .ami(ubuntu.applyValue(getAmiResult -> getAmiResult.id()))
            .instanceType("t3.micro")
            .tags(Map.of("Name", "HelloWorld"))
            .build());
        var testInstanceState = new InstanceState("testInstanceState", InstanceStateArgs.builder()
            .instanceId(testInstance.id())
            .state("stopped")
            .build());
    }
}

Import

aws_ec2_instance_state can be imported by using the instance_id attribute, e.g.,

$ pulumi import aws:ec2transitgateway/instanceState:InstanceState test i-02cae6557dfcf2f96

Constructors

InstanceStateArgs

constructor(force: Output<Boolean>? = null, instanceId: Output<String>? = null, state: Output<String>? = null)

Properties

force

val force: Output<Boolean>? = null

Whether to request a forced stop when state is stopped. Otherwise (i.e., state is running), ignored. When an instance is forced to stop, it does not flush file system caches or file system metadata, and you must subsequently perform file system check and repair. Not recommended for Windows instances. Defaults to false.

instanceId

val instanceId: Output<String>? = null

ID of the instance.

state

val state: Output<String>? = null

State of the instance. Valid values are stopped, running. The following arguments are optional:

Functions

toJava

open override fun toJava(): InstanceStateArgs