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

πŸ“¦
version 1.28 Β· 7 versions
, in debian trixie, ubuntu resolute, ubuntu stonking

πŸ’– VM::EC2::VPC::PeeringConnection πŸ’–

okay bestie, so this is a page from the User Contributed Perl Documentation and it's literally all about VM::EC2::VPC::PeeringConnection β€” aka the little object that holds your Virtual Private Cloud Peering Connection. VPC peering?? connecting two VPCs so they can talk?? it's giving networking main character energy fr fr 🌈


✨ NAME ✨

VM::EC2::VPC::PeeringConnection β€” Virtual Private Cloud Peering Connection. no cap, that's the whole name. 🫢


🌸 SYNOPSIS 🌸

here's the vibe check, bestie β€” this is how you actually use it:

use VM::EC2;

my $ec2   = VM::EC2->new(...);
my $pcx = $ec2->describe_vpc_peering_connections(-vpc_peering_connection_id=>'pcx-12345678');
my $status = $pcx->status;

see how clean that is?? you make your $ec2, you go grab the peering connection by its id, and then you just ask for the status. obsessed. πŸ’…


πŸ¦‹ DESCRIPTION πŸ¦‹

so basically this object is an Amazon EC2 VPC peering connection. like, it represents one. and you don't even have to build it yourself β€” it gets handed to you by these three:

  • VM::EC2->describe_vpc_peering_connections()
  • create_vpc_peering_connection()
  • accept_vpc_peering_connection()

so if you're calling any of those, surprise, you already have one of these cuties. πŸŽ€


πŸ’œ METHODS πŸ’œ

these object methods are supported, and yes, every single one of them matters:

  • vpcPeeringConnectionId β€” the ID of the VPC peering connection πŸ‘‘
  • requesterVpcInfo β€” information about the requester VPC
  • accepterVpcInfo β€” information about the accepter VPC
  • status β€” the status of the VPC peering connection
  • expirationTime β€” the time that an unaccepted VPC peering connection will expire ⏰
  • tagSet β€” tags assigned to the resource.

🌟 the convenience methods 🌟

because we love a shortcut, these are also provided:

  • accept β€” accepts the peering connection request.
NOTE: must be in the 'pending-acceptance' state to be successful ⚠️
  • reject β€” rejects the peering connection request.
NOTE: must be in the 'pending-acceptance' state to be successful ⚠️
  • refresh β€” refreshes the object πŸ”„
  • current_status β€” refreshes the object and returns the status. super useful for checking status after calling reject() or accept() πŸ’–

also!! the object supports the tags() method described in VM::EC2::Generic. slay. ✨


🧚 STRING OVERLOADING 🧚

when you use this object in a string context, it will interpolate the vpcPeeringConnectionId. so like, it just knows how to be a string. iconic behavior honestly. πŸ’€


🌈 SEE ALSO 🌈

go read these too, they're the friend group:

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

πŸ‘‘ AUTHOR πŸ‘‘

Lance Kinley <lkinley@loyaltymethods.com>.

Copyright (c) 2014 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 that's the whole page bestie, every single fact preserved, nothing skipped, we ate and left no crumbs πŸ“

perl v5.38.2 Β· 2024-08-10 β€” mwah, that's a wrap, go peer some VPCs responsibly πŸ’–βœ¨πŸ¦‹

πŸ“¦ where this page comes from