Package com.pulumi.aws.ec2.inputs

Class InstanceEbsBlockDeviceArgs

  • public final class InstanceEbsBlockDeviceArgs
extends com.pulumi.resources.ResourceArgs

    • Nested Class Summary

      Nested Classes 
      Modifier and Type Class Description
      static class  InstanceEbsBlockDeviceArgs.Builder  

      • Nested classes/interfaces inherited from class com.pulumi.resources.InputArgs

        com.pulumi.resources.InputArgs.InputArgsInternal

    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      static InstanceEbsBlockDeviceArgs.Builder builder()  
      static InstanceEbsBlockDeviceArgs.Builder builder​(InstanceEbsBlockDeviceArgs defaults)  
      java.util.Optional<com.pulumi.core.Output<java.lang.Boolean>> deleteOnTermination()  
      com.pulumi.core.Output<java.lang.String> deviceName()  
      java.util.Optional<com.pulumi.core.Output<java.lang.Boolean>> encrypted()  
      java.util.Optional<com.pulumi.core.Output<java.lang.Integer>> iops()  
      java.util.Optional<com.pulumi.core.Output<java.lang.String>> kmsKeyId()  
      java.util.Optional<com.pulumi.core.Output<java.lang.String>> snapshotId()  
      java.util.Optional<com.pulumi.core.Output<java.util.Map<java.lang.String,​java.lang.String>>> tags()  
      java.util.Optional<com.pulumi.core.Output<java.util.Map<java.lang.String,​java.lang.String>>> tagsAll()  
      java.util.Optional<com.pulumi.core.Output<java.lang.Integer>> throughput()  
      java.util.Optional<com.pulumi.core.Output<java.lang.String>> volumeId()  
      java.util.Optional<com.pulumi.core.Output<java.lang.Integer>> volumeSize()  
      java.util.Optional<com.pulumi.core.Output<java.lang.String>> volumeType()  

      • Methods inherited from class com.pulumi.resources.ResourceArgs

        validateMember

      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    • Method Detail

      • deleteOnTermination

        public java.util.Optional<com.pulumi.core.Output<java.lang.Boolean>> deleteOnTermination()
        Returns:
        Whether the volume should be destroyed on instance termination. Defaults to `true`.

      • deviceName

        public com.pulumi.core.Output<java.lang.String> deviceName()
        Returns:
        Name of the device to mount.

      • encrypted

        public java.util.Optional<com.pulumi.core.Output<java.lang.Boolean>> encrypted()
        Returns:
        Enables [EBS encryption](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSEncryption.html) on the volume. Defaults to `false`. Cannot be used with `snapshotId`. Must be configured to perform drift detection.

      • iops

        public java.util.Optional<com.pulumi.core.Output<java.lang.Integer>> iops()
        Returns:
        Amount of provisioned [IOPS](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-io-characteristics.html). Only valid for volumeType of `io1`, `io2` or `gp3`.

      • kmsKeyId

        public java.util.Optional<com.pulumi.core.Output<java.lang.String>> kmsKeyId()
        Returns:
        ARN of the KMS Key to use when encrypting the volume. Must be configured to perform drift detection.

      • snapshotId

        public java.util.Optional<com.pulumi.core.Output<java.lang.String>> snapshotId()
        Returns:
        Snapshot ID to mount.

      • tags

        public java.util.Optional<com.pulumi.core.Output<java.util.Map<java.lang.String,​java.lang.String>>> tags()
        Returns:
        Map of tags to assign to the device. **Note:** Tags specified here are applied after instance creation via a separate API call. This means they cannot be used with IAM policies that require tags during resource creation (e.g., ABAC policies with `ec2:CreateAction` conditions or SCPs requiring volume tags). For ABAC compliance, use `volumeTags` instead, which applies uniform tags to all volumes during instance creation.

      • tagsAll

        public java.util.Optional<com.pulumi.core.Output<java.util.Map<java.lang.String,​java.lang.String>>> tagsAll()
        Returns:
        Map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block.

      • throughput

        public java.util.Optional<com.pulumi.core.Output<java.lang.Integer>> throughput()
        Returns:
        Throughput to provision for a volume in mebibytes per second (MiB/s). This is only valid for `volumeType` of `gp3`.

      • volumeId

        public java.util.Optional<com.pulumi.core.Output<java.lang.String>> volumeId()
        Returns:
        ID of the volume. For example, the ID can be accessed like this, `aws_instance.web.root_block_device.0.volume_id`.

      • volumeSize

        public java.util.Optional<com.pulumi.core.Output<java.lang.Integer>> volumeSize()
        Returns:
        Size of the volume in gibibytes (GiB).

      • volumeType

        public java.util.Optional<com.pulumi.core.Output<java.lang.String>> volumeType()
        Returns:
        Type of volume. Valid values include `standard`, `gp2`, `gp3`, `io1`, `io2`, `sc1`, or `st1`. Defaults to `gp2`. > **NOTE:** Currently, changes to the `ebsBlockDevice` configuration of _existing_ resources cannot be automatically detected by this provider. To manage changes and attachments of an EBS block to an instance, use the `aws.ebs.Volume` and `aws.ec2.VolumeAttachment` resources instead. If you use `ebsBlockDevice` on an `aws.ec2.Instance`, this provider will assume management over the full set of non-root EBS block devices for the instance, treating additional block devices as drift. For this reason, `ebsBlockDevice` cannot be mixed with external `aws.ebs.Volume` and `aws.ec2.VolumeAttachment` resources for a given instance.