VM::EC...ce::EBS(3pm)

💅 VM::EC2::BlockDevice::EBS — the whole vibe

okay so bestie, welcome to VM::EC2::BlockDevice::EBS, straight out of the User Contributed Perl Documentation collection. It's the little object that holds the receipts on how to spin up an Amazon EBS volume from an image. 🎀

---

✨ NAME ✨

VM::EC2::BlockDevice::EBS — an object describing how to initialize an Amazon EBS volume from an image. periodt. 💖

---

🌸 SYNOPSIS 🌸

here's the whole thing in action, no cap:

use VM::EC2;

$image      = $ec2->describe_images(-image_id=>'ami-123456');
my @devices = $image->blockDeviceMapping;
for my $d (@devices) {
  my $ebs = $d->ebs;
  my $snapshot_id    = $ebs->snapshotId;
  my $size           = $ebs->volumeSize;
  my $delete         = $ebs->deleteOnTermination;
}

---

🦋 DESCRIPTION 🦋

so this object is literally here to describe the parameters used to create an Amazon EBS volume when you're running an image. Generally you will not call this directly, because all of its methods get passed through by the VM::EC2::BlockDevice object that comes back from the blockDeviceMapping() call. it's giving "middle management but make it perl". 💀

if you want a simpler way to get the info you need, go peep VM::EC2::BlockDevice.

and bestie, listen — it is so easy to confuse this with VM::EC2::BlockDevice::Mapping::EBS, which describes the attachment of an existing EBS volume to an instance. that's a different girl entirely. 🫶 this class is instead the one storing the parameters that will be used to generate a brand new EBS volume when an image is launched. new volume energy only. ✨

---

👑 METHODS 👑

these are the object methods that are supported, and yes, we're listing every single one:

• snapshotId — the ID of the snapshot used to create this EBS when an instance is launched from this image. 📸
• volumeSize — the size of the EBS volume, in gigs.
• deleteOnTermination — whether this EBS will be deleted when the instance terminates. ⚠️ heads up: this returns perl 0/1 values rather than the strings "false"/"true".
• volumeType — the volume type, one of "standard" or "io1".
• iops — the number of I/O operations per second that the volume supports, an integer between 100 and 2000. only valid for volumes of type "io1", so don't try it elsewhere. 💅

---

💜 STRING OVERLOADING 💜

NONE.

that's it. that's the whole section. not me being dramatic about it. 🙈

---

🌈 SEE ALSO 🌈

go read these next, iykyk:

• VM::EC2
• VM::EC2::Generic
• VM::EC2::Snapshot
• VM::EC2::BlockDevice

---

💖 AUTHOR 💖

Lincoln Stein <lincoln.stein@gmail.com>.

Copyright (c) 2011 Ontario Institute for Cancer Research

This package and its accompanying libraries is free software; you can redistribute it and/or modify it under the terms of the GPL (either version 1, or at your option, any later version) or the Artistic License 2.0. Refer to LICENSE for the full license text. In addition, please see DISCLAIMER.txt for disclaimers of warranty.

---

okay and finally, the little sign-off corner: this whole page is served up by perl v5.38.2, dated 2024-08-10, and yes the footer says it's VM::EC...ce::EBS(3pm) because the terminal truncated the pretty name. iconic behavior honestly. slay, bye bestie 💅✨🦋