Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



Man Pages
VM::EC2::Spot::InstanceRequest(3) User Contributed Perl Documentation VM::EC2::Spot::InstanceRequest(3)

VM::EC2::Spot::InstanceRequest - Object describing an Amazon EC2 spot instance request


This object represents an Amazon EC2 spot instance request, which is returned by VM::EC2-> request_spot_instances() and VM::EC2-> describe_spot_instance_requests().

These object methods are supported:
 spotInstanceRequestId       -- ID of this spot instance request
 spotPrice   -- The maximum hourly price for any spot
                instance launched under this request,
                in USD.
 type        -- The spot instance request type, 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, 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.
 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.
 launchSpecification -- Additional information for launching
                instances, represented as a VM::EC2::Spot::LaunchSpecificaton
 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
 productDescription -- The product description associated with this spot
                instance request.

This class supports the standard tagging interface. In addition it provides the following convenience method:

If an instance was launched as a result of this request, the instance() method will return the corresponding VM::EC2::Instance object.

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.

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

Refreshes the request information.

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

Lincoln Stein <>.
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.
2019-01-01 perl v5.28.1

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.