1VM::EC2::Spot::InstanceURseeqrueCsotn(t3r)ibuted Perl DoVcMu:m:eEnCt2a:t:iSopnot::InstanceRequest(3)
2
3
4

NAME

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

SYNOPSIS

10       See "SPOT INSTANCES" in VM::EC2.
11

DESCRIPTION

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

METHODS

18       These object methods are supported:
19
20        spotInstanceRequestId       -- ID of this spot instance request
21
22        spotPrice   -- The maximum hourly price for any spot
23                       instance launched under this request,
24                       in USD.
25
26        type        -- The spot instance request type, one of
27                       'one-time' or 'persistent'.
28
29        state       -- The state of this request, one of 'open',
30                       'closed', 'fulfilled', 'cancelled' or 'failed'.
31
32        fault       -- Fault code for the request, if any, an
33                       instance of VM::EC2::Error.
34
35        status      -- The status code and status message describing the
36                       Spot Instance request.
37
38        validFrom   -- Start date and time of the request.
39
40        validUntil  -- Date and time that the request expires.
41
42        launchGroup -- Launch group of the instances run under this request.
43                       Instances in the same launch group are launched
44                       and terminated together.
45
46        launchedAvailabilityZone -- Availability zone of launched instance.
47
48        availabilityZoneGroup -- Availability zone group of the instances
49                       run under this request. Instances in the same
50                       availability zone group will always be launched
51                       into the same availability zone.
52
53        launchSpecification -- Additional information for launching
54                       instances, represented as a VM::EC2::Spot::LaunchSpecificaton
55                       object.
56
57        instanceId  -- The instance ID, if an instance has been launched as a
58                       result of this request.
59
60        createTime  -- The time and date when the spot instance request was
61                       created.
62
63        productDescription -- The product description associated with this spot
64                       instance request.
65

Convenience Methods

67       This class supports the standard tagging interface. In addition it
68       provides the following convenience method:
69
70   $instance = $request->instance
71       If an instance was launched as a result of this request, the instance()
72       method will return the corresponding VM::EC2::Instance object.
73
74   $state  = $request->current_status
75       Refreshes the request information and returns its status as a
76       VM::EC2::Spot::Status.  This will string interpolate as the status
77       code, such as "fulfilled". You may also call its object methods to get
78       the time of the last update and full message.
79
80   $state  = $request->current_state
81       Refreshes the request information and returns its state, such as
82       "open".
83
84   $request->refresh
85       Refreshes the request information.
86

SEE ALSO

88       VM::EC2 VM::EC2::Generic VM::EC2::Spot::LaunchSpecification
89       VM::EC2::Error
90

AUTHOR

92       Lincoln Stein <lincoln.stein@gmail.com>.
93
94       Copyright (c) 2011 Ontario Institute for Cancer Research
95
96       This package and its accompanying libraries is free software; you can
97       redistribute it and/or modify it under the terms of the GPL (either
98       version 1, or at your option, any later version) or the Artistic
99       License 2.0.  Refer to LICENSE for the full license text. In addition,
100       please see DISCLAIMER.txt for disclaimers of warranty.
101
102
103
104perl v5.36.0                      2023-01-20 VM::EC2::Spot::InstanceRequest(3)