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

💖 VM::EC2::ELB::InstanceState — bestie, it's giving "load balancer gossip" 💖

okay so this page lives in the User Contributed Perl Documentation manual, and the whole thing is literally just one tiny little object that tells you what's up with an instance that's attached to a load balancer. no cap.

---

✨ NAME ✨

VM::EC2::ELB::InstanceState — the object that describes the state of an instance attached to a load balancer. 🫶

it's literally the result of a DescribeInstanceHealth API call. that's the whole vibe. that's the gig.

---

🌸 SYNOPSIS 🌸

use VM::EC2;

my $ec2          = VM::EC2->new(...);
my $lb           = $ec2->describe_load_balancers('my-lb');
my @instance_ids = map { $_->InstanceId } $lb->Instances();
my @states       = $lb->describe_instance_health(-instances => \@instance_ids);
my @down_ids     = map { $_->InstanceId } grep { $_->State eq 'OutOfService' } @states;

look at that. iconic. you make a $ec2, you grab your load balancer, you yoink the instance ids, you ask about their health, and then you filter out the ones that are 'OutOfService' because we are not letting the flops into the group chat. 💅

---

🦋 DESCRIPTION 🦋

this object describes the parameters that come back from a DescribeInstanceHealth API call. it's a little wrapper, a little vibe-holder, and it's doing its job flawlessly honestly.

---

🎀 METHODS 🎀

here's the main character list, bestie. the following object methods are supported:

• InstanceId — the Instance ID of the instance attached to the load balancer 🆔
• State — specifies the current status of the instance
• ReasonCode — gives you the tea on why an instance ended up OutOfService. specifically, it tells you whether the cause is Elastic Load Balancing itself or the instance sitting behind the load balancer 👀
• Description — a description of why the instance is in its current state

and the following convenience methods are supported too, because the devs said "let me make your life easier actually":

• instance — hands you back an L<VM::EC2::Instance> object. a whole object. for free. slay. 💖

---

🌈 STRING OVERLOADING 🌈

when you use this object in a string context, it will interpolate the instance state. so like, drop it in a string and it just speaks. periodt. ✨

---

👑 SEE ALSO 👑

• VM::EC2
• VM::EC2::Generic
• VM::EC2::ELB

go read those, iykyk. 📚

---

💜 AUTHOR 💜

Lance Kinley <lkinley@loyaltymethods.com>

Copyright (c) 2012 Loyalty Methods, Inc.

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.

⚠️ fr fr, go actually read LICENSE and DISCLAIMER.txt — they're right there, and they matter.

---

and that's the whole page, bestie!! 🥳 this little writeup came to you courtesy of perl v5.38.2, dated 2024-08-10, in the User Contributed Perl Documentation manual. mwah. 💋 ✨🎀🦋🌸🫶