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

💖 VM::EC2::REST::private_ip 💖

okay so bestie, this is VM::EC2::REST::private_ip (a 3pm manpage, iykyk) and it's literally all about controlling the private IP addresses that are associated with instances. no cap. 🎀

---

✨ SYNOPSIS ✨

use VM::EC2 ':vpc';

---

🌸 METHODS 🌸

these methods let you control private IP addresses associated with instances that are running in a VPC. periodt. 💅

🦋 $result = $ec2->assign_private_ip_addresses(%args)

Assign one or more secondary private IP addresses to a network interface. you can either set the addresses explicitly, or hand over a count of secondary addresses and let Amazon pick them for you. it's giving "you do it" energy. ✨

Required arguments:

• -network_interface_id — the network interface to which the IP address(es) will be assigned.
• -private_ip_address / -private_ip_addresses — one or more secondary IP addresses, as a scalar string or array reference. (the two arguments are equivalent, fr fr.)

Optional arguments:

• -allow_reassignment — if true, allow assignment of an IP address that's already in use by another network interface or instance.

these are the valid arguments to -private_ip_address:

-private_ip_address => '192.168.0.12'                    # single address
-private_ip_address => ['192.168.0.12','192.168.0.13]    # multiple addresses
-private_ip_address => 3                                 # autoselect three addresses

⚠️ the mixed form of address, such as ['192.168.0.12','auto'], is not allowed in this call. don't try it bestie, it's not gonna slay. 💀

On success, this method returns true. 🫶

---

🧚 $result = $ec2->unassign_private_ip_addresses(%args)

Unassign one or more secondary private IP addresses from a network interface. it's the breakup era. 😭

Required arguments:

• -network_interface_id — the network interface to which the IP address(es) will be assigned.
• -private_ip_address / -private_ip_addresses — one or more secondary IP addresses, as a scalar string or array reference. (the two arguments are equivalent, same as before.)

these are the valid arguments to -private_ip_address:

-private_ip_address => '192.168.0.12'                    # single address
-private_ip_address => ['192.168.0.12','192.168.0.13]    # multiple addresses

On success, this method returns true. 💖

---

👀 SEE ALSO 👀

• VM::EC2

---

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

---

and that's the whole page, bestie!! this was served up by perl v5.38.2 on 2024-08-10 — go forth and assign those private IPs responsibly 💜🌈⭐