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

💖 VM::EC2::Spot::InstanceRequest — the manual, but make it cute ✨

okay so bestie, you're reading the perl docs for VM::EC2::Spot::InstanceRequest, part of the User Contributed Perl Documentation. it's a whole object that describes an Amazon EC2 spot instance request. iconic behavior honestly. 💅

---

🌸 NAME 🌸

VM::EC2::Spot::InstanceRequest — it's an object, and that object's whole personality is describing an Amazon EC2 spot instance request. that's it. that's the job. 🎀

---

✨ SYNOPSIS ✨

lowkey just go look at "SPOT INSTANCES" in VM::EC2. that's where the action is, bestie. 🦋

---

💜 DESCRIPTION 💜

so this object is an Amazon EC2 spot instance request, fr fr. it's what gets handed back to you by VM::EC2->request_spot_instances() and VM::EC2->describe_spot_instance_requests(). no cap, that's literally where it comes from. 👑

---

🫶 METHODS 🫶

these object methods are supported, and yes, we're going through every single one because we don't skip:

• spotInstanceRequestId — the ID of this spot instance request. its little name tag. 🏷️
• spotPrice — the maximum hourly price for any spot instance launched under this request, in USD. the budget cap, basically. 💸
• type — the spot instance request type, and it's one of 'one-time' or 'persistent'.
• state — the state of this request, one of 'open', 'closed', 'fulfilled', 'cancelled' or 'failed'.
• fault — fault code for the request, if any. it's an instance of VM::EC2::Error. 😭
• status — the status code and status message describing the Spot Instance request.
• validFrom — start date and time of the request.
• validUntil — date and time that the request expires.
• launchGroup — launch group of the instances run under this request. instances in the same launch group are launched and terminated together — they're a package deal, ride or die. 🫂
• launchedAvailabilityZone — availability zone of launched instance.
• availabilityZoneGroup — availability zone group of the instances run under this request. instances in the same availability zone group will always be launched into the same availability zone. they stay together, periodt. 📍
• launchSpecification — additional information for launching instances, represented as a VM::EC2::Spot::LaunchSpecificaton object. (yes, exactly like that — keep the spelling, bestie, we don't touch the code names 🙈)
• instanceId — the instance ID, if an instance has been launched as a result of this request.
• createTime — the time and date when the spot instance request was created. birthday energy. 🎂
• productDescription — the product description associated with this spot instance request.

---

🎀 Convenience Methods 🎀

this class supports the standard tagging interface. (slay.) and on top of that it provides the following convenience method — yes, singular, that's how it's written:

$instance = $request->instance

if an instance was launched as a result of this request, the instance() method will return the corresponding VM::EC2::Instance object. it's giving found your baby. 👶

$state = $request->current_status

refreshes the request information and returns its status as a VM::EC2::Spot::Status. this will string interpolate as the status code, such as "fulfilled". you may also call its object methods to get the time of the last update and full message. multitasking icon. ✨

$state = $request->current_state

refreshes the request information and returns its state, such as "open".

$request->refresh

refreshes the request information. that's it. glow-up on demand. 💅

---

👀 SEE ALSO 👀

VM::EC2 VM::EC2::Generic VM::EC2::Spot::LaunchSpecification VM::EC2::Error

go read those too, bestie, iykyk. 📚

---

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

okay so legal stuff is legal stuff but fr fr — read LICENSE and DISCLAIMER.txt, they said what they said. 🌈

---

and that's the whole page, bestie. 💖 this was perl v5.38.2, dated 2024-08-10, straight outta the VM::EC2::Spot::InstanceRequest(3pm) manpage. go launch something cute. 🦋⭐🎀