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

💖 VM::EC2::VPC::TunnelTelemetry 💖

okay bestie, sit down, hydrate, and let me tell you about this absolute little legend of a Perl module. it's called VM::EC2::VPC::TunnelTelemetry, and it ships as part of the User Contributed Perl Documentation crew. yes, the whole name is a mouthful, we still stan her 🫶

she's a VPN tunnel telemetry object, and she is lowkey iconic.

---

✨ NAME ✨

VM::EC2::VPC::TunnelTelemetry — Virtual Private Cloud VPN tunnel telemetry 💅

like. the whole point of her. tunnel. telemetry. she watches the vibes of your VPN tunnel and reports back.

---

🌸 SYNOPSIS 🌸

here's the group-chat recap of how you two meet:

use VM::EC2;

my $ec2       = VM::EC2->new(...);
my $vpn       = $ec2->describe_vpn_connections(-vpn_connection_id=>'vpn-12345678');
my $telemetry = $vpn->vpn_telemetry;
print $telemetry->status,"\n";

see that? you spin up a VM::EC2, you go get your VPN connection with describe_vpn_connections(-vpn_connection_id=>'vpn-12345678'), you grab the vpn_telemetry off of it, and then you just print the status. no cap, that's the whole plot. it's giving "short and sweet" and honestly? we love that for us. ✨

---

🦋 DESCRIPTION 🦋

so what is she, fr fr?

this object represents an Amazon EC2 VPC route, and she's returned by VM::EC2->describe_vpn_connections(). 💖

(yes bestie, that's what it says. we report, you decide. 🎀)

---

👑 METHODS 👑

these are the object methods she supports. every single one, no skips, no cuts:

• outsideIpAddress — the Internet-routable IP address of the virtual private gateway's outside interface. that's the face she shows the actual internet 🌈
• status — the status of the VPN tunnel. valid values are: UP | DOWN. that's it. that's the whole mood ring 🎀
• lastStatusChange — the date and time of the last change in status. receipts for when the vibe shifted 💅
• statusMessage — if an error occurs, a description of the error. she will tell you what went wrong, she's not mysterious about it 😭
• acceptedRouteCount — the number of accepted routes. the count. the number. the math 🔥

also, she supports the tags() method described in VM::EC2::Generic. so you can tag her up, bestie 🏷️✨

---

🧚 STRING OVERLOADING 🧚

when you use this object in a string context, she will interpolate the status.

so if you just casually drop her into a string, you get the status and nothing else. main character behavior tbh. she knows what you want. 💅

---

🌟 SEE ALSO 🌟

go say hi to her friends, they're all lovely:

• VM::EC2
• VM::EC2::Generic
• VM::EC2::Tag
• VM::EC2::VPC
• VM::EC2::VPC::VpnConnection

---

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

okay so legally speaking: she's free software, GPL (version 1, or at your option any later version) or the Artistic License 2.0, your pick. read LICENSE for the whole thing, and read DISCLAIMER.txt for the warranty disclaimers, because there are none and you should know that going in 🙈

---

and that's the whole page, bestie!! this one came from perl v5.38.2, dated 2024-08-10, and it's VM::EC2::VPC::TunnelTelemetry(3pm). slay, go read your tunnel telemetry, love you, bye 💖✨🦋