Net::Am...stances(3)

💖 Net::Amazon::EC2::RunningInstances 💖

okay bestie, so this page is from the User Contributed Perl Documentation collection — it's the manual for Net::Amazon::EC2::RunningInstances, and no cap, it's a whole mood. it's short, it's sweet, it's literally just vibes and attribute lists. let's get into it ✨

---

✨ NAME ✨

Net::Amazon::EC2::RunningInstances — the class that represents a running instance. that's it. that's the whole job. she's a data holder and she's slaying at it 💅

---

🌸 DESCRIPTION 🌸

A class representing a running instance. periodt. 🫶

like, when you're out here talking to Amazon EC2 and it hands you back an instance that's up and running, this is the little object wrapper you get to poke at. it's giving "structured data, but make it a Perl object." iconic behavior, honestly. 👑

---

🎀 ATTRIBUTES 🎀

here's the full roster, bestie. every single one, in order, no skipping, no summarizing, we do not do that here. some are required and some are optional — pay attention to which is which because the required ones are, like, non-negotiable. ⭐

• ami_launch_index (optional) — the AMI launch index. use it to find this specific instance inside the launch group. she's your little finder-hint 🦋
• dns_name (optional) — the public DNS name assigned to the instance. this one is contactable from outside the Amazon EC2 network. heads up tho: this element stays empty until the instance enters a running state. so don't come for her while she's still waking up 😭
• image_id (required) — the image id of the AMI that's currently running in this instance. mandatory, bestie.
• kernel_id (required) — the kernel id of the AKI currently running in this instance. also mandatory.
• ramdisk_id (required) — the ramdisk id of the ARI loaded in this instance. yep, required too.
• instance_id (required) — the instance id of the launched instance. the whole point, fr fr.
• instance_state (required) — an Net::Amazon::EC2::InstanceState object. 👑
• instance_type (required) — the type of instance that got launched.
• key_name (optional) — the key pair name the instance was launched with. 🔑
• launch_time (required) — the time the instance was started.
• placement (required) — a Net::Amazon::EC2::PlacementResponse object.
• private_dns_name (optional) — the private DNS name assigned to the instance. this one can only be used inside the Amazon EC2 network. and same deal as her public sister: this element stays empty until the instance enters a running state. 🙈
• product_codes (optional) — an array ref of Net::Amazon::EC2::ProductCode objects.
• reason (optional) — the reason for the most recent state transition.
• platform (optional) — the operating system for this instance.
• monitoring (optional) — the state of monitoring on this instance. 👀
• subnet_id (optional) — specifies the subnet ID in which the instance is running (Amazon Virtual Private Cloud).
• vpc_id (optional) — specifies the VPC in which the instance is running (Amazon Virtual Private Cloud).
• private_ip_address (optional) — specifies the private IP address that is assigned to the instance (Amazon VPC).
• ip_address (optional) — specifies the IP address of the instance.
• state_reason (optional) — the reason for the state change.

a Net::Amazon::EC2::StateReason object. 🧚

• architecture (optional) — the architecture of the image.
• root_device_name (optional) — the root device name (e.g., /dev/sda1).
• root_device_type (optional) — the root device type used by the AMI. the AMI can use an Amazon EBS or instance store root device.
• block_device_mapping (optional) — an array ref of Net::Amazon::EC2::BlockDeviceMapping objects.
• tag_set (optional) — an array ref of Net::Amazon::EC2::TagSet objects.
• name (optional) — the instance name from tags. 🍓

---

💜 AUTHOR 💜

Jeff Kim <cpan@chosec.com> — shoutout to the author, absolute legend, we love to see it. 🌈

---

⭐ COPYRIGHT ⭐

Copyright (c) 2006-2010 Jeff Kim. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

---

lowkey important: the required/optional labels above are exactly as the page says them, so if you're out here building one of these by hand, don't skip the required ones or it's gonna be a bad time 💀

and that's the whole page, bestie! this one came bundled with perl v5.42.0 and the doc is dated 2025-07-25 — so yeah, she's recent, she's fresh, she's still cute. go forth and parse your instances 🎀💖✨