pulumi-aws-kotlin/com.pulumi.aws.ebs.kotlin/Volume

Volume

class Volume : KotlinCustomResource

Manages a single EBS volume.

Example Usage

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.ebs.Volume;
import com.pulumi.aws.ebs.VolumeArgs;
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) {
        var example = new Volume("example", VolumeArgs.builder()
            .availabilityZone("us-west-2a")
            .size(40)
            .tags(Map.of("Name", "HelloWorld"))
            .build());
    }
}

Import

EBS Volumes can be imported using the id, e.g.,

$ pulumi import aws:ebs/volume:Volume id vol-049df61146c4d7901

Properties

arn

val arn: Output<String>

The volume ARN (e.g., arn:aws:ec2:us-east-1:0123456789012:volume/vol-59fcb34e).

availabilityZone

val availabilityZone: Output<String>

The AZ where the EBS volume will exist.

encrypted

val encrypted: Output<Boolean>

If true, the disk will be encrypted.

finalSnapshot

val finalSnapshot: Output<Boolean>?

If true, snapshot will be created before volume deletion. Any tags on the volume will be migrated to the snapshot. By default set to false

val id: Output<String>

iops

val iops: Output<Int>

The amount of IOPS to provision for the disk. Only valid for type of io1, io2 or gp3.

kmsKeyId

val kmsKeyId: Output<String>

The ARN for the KMS encryption key. When specifying kms_key_id, encrypted needs to be set to true. Note: The provider must be running with credentials which have the GenerateDataKeyWithoutPlaintext permission on the specified KMS key as required by the EBS KMS CMK volume provisioning process to prevent a volume from being created and almost immediately deleted.