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

💖 VM::EC2::State 💖

okay bestie, so this is a page from the User Contributed Perl Documentation set — it's the manual for VM::EC2::State, and honestly? it's a tiny little icon and I'm obsessed. it's all about knowing what's going on with your EC2 instance's ~vibe~. let's get into it. ✨

---

🌸 NAME 🌸

VM::EC2::State — the object that describes the state of an EC2 instance. literally its whole job. 🫶

---

✨ SYNOPSIS ✨

here's how you'd actually use it, no cap:

use VM::EC2;

$ec2      = VM::EC2->new(...);
$instance = $ec2->describe_instances(-instance_id=>'i-12345');
$state    = $instance->state;
$code     = $state->code;
$name     = $state->name;

---

💅 DESCRIPTION 💅

so this object represents the state of an Amazon EC2 instance. you don't just spawn it out of nowhere — you get it back when you call the state() method on a VM::EC2::Instance. and that's not all!! it also comes back to you from VM::EC2->start_instances(), VM::EC2->stop_instances() and VM::EC2->terminate_instances(). so like, whenever your instance is going through something, this little object is there to tell you what it is. main character energy fr. 💫

---

🎀 METHODS 🎀

these object methods are supported:

• code — the state code 👀
• name — the state name 💖

and here's the ✨ matching chart ✨ so you know which code is which vibe:

• 0 — pending
• 16 — running
• 32 — shutting-down
• 48 — terminated
• 64 — stopping
• 80 — stopped
• 272 — <none>

bestie listen. code 272 is said to correspond to a problem with the instance host. so if you see that one... yeah. 😭 not a cute look. the original says "is said to" and I'm keeping it that way — that's the tea, we're not overclaiming.

---

🦋 STRING OVERLOADING 🦋

when you use this object in a string context, it will interpolate the name. so it just slots right in and reads like a normal word. slay. 💅

---

🌈 SEE ALSO 🌈

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

• VM::EC2
• VM::EC2::Generic
• VM::EC2::State
• VM::EC2::Instance

---

👑 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.

⚠️ real talk: those two files, LICENSE and DISCLAIMER.txt, are where the actual legal words live. go read them if you need the full text or the warranty disclaimers — don't just take my word for it. 💀

---

and that's the whole page!! this one came from perl v5.38.2, dated 2024-08-10, and it was served up as part of the VM::EC2::State(3pm) manual. tysm for reading, bestie — go forth and check your instance states responsibly. periodt. 💜✨🎀