VM::EC...tusItem(3pm)

💖 VM::EC2::Instance::StatusItem 💖

okay bestie, so this is the VM::EC2::Instance::StatusItem(3pm) page — it lives in the User Contributed Perl Documentation corner of the man pages, and it's all about one little object: the thing that describes a instance status event. yes. a whole object. for one status event. we love a main character with a narrow niche. 🎀

---

✨ NAME ✨

VM::EC2::Instance::StatusItem — the object that describes a instance status event, fr fr 🦋

---

🌸 SYNOPSIS 🌸

here's the vibe in code, no cap:

@status_items = $ec2->describe_instance_status();
for my $i (@status_items) {
   print $i->instance_id,
          ': instance check=',$i->instance_status,
          ', system check=',$i->system_status,"\n";
   if (my $e = $i->events) {
      print $i->instance_id,' event = ',$e;
   }
}

like… you grab all the status items, loop through them, print the checks, and if there's an event bestie you print that too. iconic. 💅

---

💜 DESCRIPTION 💜

so this object represents an instance status that came back from $ec2->describe_instance_status(). that's it. that's the whole job. and it does it beautifully. 👑

---

🌈 METHODS 🌈

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

• instanceId — the ID of the affected instance. the who.
• instance — the VM::EC2::Instance object itself. the actual whole vibe.
• availabilityZone — the availability zone this instance is chillin' in.
• events — a list of VM::EC2::Instance::Status::Event objects, representing scheduled maintenance events on this instance (see the note below!!).
• instanceState — the state of this instance, like "running" for example.
• systemStatus — a VM::EC2::Instance::Status object showing the status of the system check.
• instanceStatus — a VM::EC2::Instance::Status object showing the status of the instance availability check.

NOTE: there's an inconsistency in the AWS docs for this data type, and it's giving chaos 😭. The events field is documented as being a list, but the examples they show return a single object. At release time, the author literally could not verify which one is correct, so the code was written so that it will always return a list — which may be single element in length. so, list. always. even if it's a list of one. periodt. 💀

---

🧚 String Context 🧚

when you shove this object into a string context, it interpolates like this:

"$instanceId: XX/2 tests passed"

where XX is the number of checks that passed. slay. ✅

and in the case of an instance that is not running, the interpolation is instead:

"$instanceId: $state"

where $state is the state of the instance — like "stopped", for example. so it just tells you the state. simple. clean. 🫶

---

🔥 SEE ALSO 🔥

go read these too bestie, they're all connected:

• VM::EC2
• VM::EC2::Generic
• VM::EC2::Instance
• VM::EC2::Tag

---

👑 AUTHOR 👑

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

Copyright (c) 2012 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.

---

and that's the whole page bestie, we ate and left zero crumbs 💖✨ this was perl v5.38.2, dated 2024-08-10, and the manual name is VM::EC...tusItem(3pm) in case you forgot where you were. mwah. 🎀🌸