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', '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. 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 object. 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. 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.
Lincoln Stein <email@example.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.