line |
stmt |
bran |
cond |
sub |
pod |
time |
code |
1
|
|
|
|
|
|
|
package Paws::EC2::Instance; |
2
|
1
|
|
|
1
|
|
589
|
use Moose; |
|
1
|
|
|
1
|
|
4
|
|
|
1
|
|
|
|
|
13
|
|
|
1
|
|
|
|
|
427
|
|
|
1
|
|
|
|
|
2
|
|
|
1
|
|
|
|
|
6
|
|
3
|
|
|
|
|
|
|
has AmiLaunchIndex => (is => 'ro', isa => 'Int', request_name => 'amiLaunchIndex', traits => ['NameInRequest']); |
4
|
|
|
|
|
|
|
has Architecture => (is => 'ro', isa => 'Str', request_name => 'architecture', traits => ['NameInRequest']); |
5
|
|
|
|
|
|
|
has BlockDeviceMappings => (is => 'ro', isa => 'ArrayRef[Paws::EC2::InstanceBlockDeviceMapping]', request_name => 'blockDeviceMapping', traits => ['NameInRequest']); |
6
|
|
|
|
|
|
|
has ClientToken => (is => 'ro', isa => 'Str', request_name => 'clientToken', traits => ['NameInRequest']); |
7
|
|
|
|
|
|
|
has EbsOptimized => (is => 'ro', isa => 'Bool', request_name => 'ebsOptimized', traits => ['NameInRequest']); |
8
|
|
|
|
|
|
|
has ElasticGpuAssociations => (is => 'ro', isa => 'ArrayRef[Paws::EC2::ElasticGpuAssociation]', request_name => 'elasticGpuAssociationSet', traits => ['NameInRequest']); |
9
|
|
|
|
|
|
|
has EnaSupport => (is => 'ro', isa => 'Bool', request_name => 'enaSupport', traits => ['NameInRequest']); |
10
|
|
|
|
|
|
|
has Hypervisor => (is => 'ro', isa => 'Str', request_name => 'hypervisor', traits => ['NameInRequest']); |
11
|
|
|
|
|
|
|
has IamInstanceProfile => (is => 'ro', isa => 'Paws::EC2::IamInstanceProfile', request_name => 'iamInstanceProfile', traits => ['NameInRequest']); |
12
|
|
|
|
|
|
|
has ImageId => (is => 'ro', isa => 'Str', request_name => 'imageId', traits => ['NameInRequest']); |
13
|
|
|
|
|
|
|
has InstanceId => (is => 'ro', isa => 'Str', request_name => 'instanceId', traits => ['NameInRequest']); |
14
|
|
|
|
|
|
|
has InstanceLifecycle => (is => 'ro', isa => 'Str', request_name => 'instanceLifecycle', traits => ['NameInRequest']); |
15
|
|
|
|
|
|
|
has InstanceType => (is => 'ro', isa => 'Str', request_name => 'instanceType', traits => ['NameInRequest']); |
16
|
|
|
|
|
|
|
has KernelId => (is => 'ro', isa => 'Str', request_name => 'kernelId', traits => ['NameInRequest']); |
17
|
|
|
|
|
|
|
has KeyName => (is => 'ro', isa => 'Str', request_name => 'keyName', traits => ['NameInRequest']); |
18
|
|
|
|
|
|
|
has LaunchTime => (is => 'ro', isa => 'Str', request_name => 'launchTime', traits => ['NameInRequest']); |
19
|
|
|
|
|
|
|
has Monitoring => (is => 'ro', isa => 'Paws::EC2::Monitoring', request_name => 'monitoring', traits => ['NameInRequest']); |
20
|
|
|
|
|
|
|
has NetworkInterfaces => (is => 'ro', isa => 'ArrayRef[Paws::EC2::InstanceNetworkInterface]', request_name => 'networkInterfaceSet', traits => ['NameInRequest']); |
21
|
|
|
|
|
|
|
has Placement => (is => 'ro', isa => 'Paws::EC2::Placement', request_name => 'placement', traits => ['NameInRequest']); |
22
|
|
|
|
|
|
|
has Platform => (is => 'ro', isa => 'Str', request_name => 'platform', traits => ['NameInRequest']); |
23
|
|
|
|
|
|
|
has PrivateDnsName => (is => 'ro', isa => 'Str', request_name => 'privateDnsName', traits => ['NameInRequest']); |
24
|
|
|
|
|
|
|
has PrivateIpAddress => (is => 'ro', isa => 'Str', request_name => 'privateIpAddress', traits => ['NameInRequest']); |
25
|
|
|
|
|
|
|
has ProductCodes => (is => 'ro', isa => 'ArrayRef[Paws::EC2::ProductCode]', request_name => 'productCodes', traits => ['NameInRequest']); |
26
|
|
|
|
|
|
|
has PublicDnsName => (is => 'ro', isa => 'Str', request_name => 'dnsName', traits => ['NameInRequest']); |
27
|
|
|
|
|
|
|
has PublicIpAddress => (is => 'ro', isa => 'Str', request_name => 'ipAddress', traits => ['NameInRequest']); |
28
|
|
|
|
|
|
|
has RamdiskId => (is => 'ro', isa => 'Str', request_name => 'ramdiskId', traits => ['NameInRequest']); |
29
|
|
|
|
|
|
|
has RootDeviceName => (is => 'ro', isa => 'Str', request_name => 'rootDeviceName', traits => ['NameInRequest']); |
30
|
|
|
|
|
|
|
has RootDeviceType => (is => 'ro', isa => 'Str', request_name => 'rootDeviceType', traits => ['NameInRequest']); |
31
|
|
|
|
|
|
|
has SecurityGroups => (is => 'ro', isa => 'ArrayRef[Paws::EC2::GroupIdentifier]', request_name => 'groupSet', traits => ['NameInRequest']); |
32
|
|
|
|
|
|
|
has SourceDestCheck => (is => 'ro', isa => 'Bool', request_name => 'sourceDestCheck', traits => ['NameInRequest']); |
33
|
|
|
|
|
|
|
has SpotInstanceRequestId => (is => 'ro', isa => 'Str', request_name => 'spotInstanceRequestId', traits => ['NameInRequest']); |
34
|
|
|
|
|
|
|
has SriovNetSupport => (is => 'ro', isa => 'Str', request_name => 'sriovNetSupport', traits => ['NameInRequest']); |
35
|
|
|
|
|
|
|
has State => (is => 'ro', isa => 'Paws::EC2::InstanceState', request_name => 'instanceState', traits => ['NameInRequest']); |
36
|
|
|
|
|
|
|
has StateReason => (is => 'ro', isa => 'Paws::EC2::StateReason', request_name => 'stateReason', traits => ['NameInRequest']); |
37
|
|
|
|
|
|
|
has StateTransitionReason => (is => 'ro', isa => 'Str', request_name => 'reason', traits => ['NameInRequest']); |
38
|
|
|
|
|
|
|
has SubnetId => (is => 'ro', isa => 'Str', request_name => 'subnetId', traits => ['NameInRequest']); |
39
|
|
|
|
|
|
|
has Tags => (is => 'ro', isa => 'ArrayRef[Paws::EC2::Tag]', request_name => 'tagSet', traits => ['NameInRequest']); |
40
|
|
|
|
|
|
|
has VirtualizationType => (is => 'ro', isa => 'Str', request_name => 'virtualizationType', traits => ['NameInRequest']); |
41
|
|
|
|
|
|
|
has VpcId => (is => 'ro', isa => 'Str', request_name => 'vpcId', traits => ['NameInRequest']); |
42
|
|
|
|
|
|
|
1; |
43
|
|
|
|
|
|
|
|
44
|
|
|
|
|
|
|
### main pod documentation begin ### |
45
|
|
|
|
|
|
|
|
46
|
|
|
|
|
|
|
=head1 NAME |
47
|
|
|
|
|
|
|
|
48
|
|
|
|
|
|
|
Paws::EC2::Instance |
49
|
|
|
|
|
|
|
|
50
|
|
|
|
|
|
|
=head1 USAGE |
51
|
|
|
|
|
|
|
|
52
|
|
|
|
|
|
|
This class represents one of two things: |
53
|
|
|
|
|
|
|
|
54
|
|
|
|
|
|
|
=head3 Arguments in a call to a service |
55
|
|
|
|
|
|
|
|
56
|
|
|
|
|
|
|
Use the attributes of this class as arguments to methods. You shouldn't make instances of this class. |
57
|
|
|
|
|
|
|
Each attribute should be used as a named argument in the calls that expect this type of object. |
58
|
|
|
|
|
|
|
|
59
|
|
|
|
|
|
|
As an example, if Att1 is expected to be a Paws::EC2::Instance object: |
60
|
|
|
|
|
|
|
|
61
|
|
|
|
|
|
|
$service_obj->Method(Att1 => { AmiLaunchIndex => $value, ..., VpcId => $value }); |
62
|
|
|
|
|
|
|
|
63
|
|
|
|
|
|
|
=head3 Results returned from an API call |
64
|
|
|
|
|
|
|
|
65
|
|
|
|
|
|
|
Use accessors for each attribute. If Att1 is expected to be an Paws::EC2::Instance object: |
66
|
|
|
|
|
|
|
|
67
|
|
|
|
|
|
|
$result = $service_obj->Method(...); |
68
|
|
|
|
|
|
|
$result->Att1->AmiLaunchIndex |
69
|
|
|
|
|
|
|
|
70
|
|
|
|
|
|
|
=head1 DESCRIPTION |
71
|
|
|
|
|
|
|
|
72
|
|
|
|
|
|
|
This class has no description |
73
|
|
|
|
|
|
|
|
74
|
|
|
|
|
|
|
=head1 ATTRIBUTES |
75
|
|
|
|
|
|
|
|
76
|
|
|
|
|
|
|
|
77
|
|
|
|
|
|
|
=head2 AmiLaunchIndex => Int |
78
|
|
|
|
|
|
|
|
79
|
|
|
|
|
|
|
The AMI launch index, which can be used to find this instance in the |
80
|
|
|
|
|
|
|
launch group. |
81
|
|
|
|
|
|
|
|
82
|
|
|
|
|
|
|
|
83
|
|
|
|
|
|
|
=head2 Architecture => Str |
84
|
|
|
|
|
|
|
|
85
|
|
|
|
|
|
|
The architecture of the image. |
86
|
|
|
|
|
|
|
|
87
|
|
|
|
|
|
|
|
88
|
|
|
|
|
|
|
=head2 BlockDeviceMappings => ArrayRef[L<Paws::EC2::InstanceBlockDeviceMapping>] |
89
|
|
|
|
|
|
|
|
90
|
|
|
|
|
|
|
Any block device mapping entries for the instance. |
91
|
|
|
|
|
|
|
|
92
|
|
|
|
|
|
|
|
93
|
|
|
|
|
|
|
=head2 ClientToken => Str |
94
|
|
|
|
|
|
|
|
95
|
|
|
|
|
|
|
The idempotency token you provided when you launched the instance, if |
96
|
|
|
|
|
|
|
applicable. |
97
|
|
|
|
|
|
|
|
98
|
|
|
|
|
|
|
|
99
|
|
|
|
|
|
|
=head2 EbsOptimized => Bool |
100
|
|
|
|
|
|
|
|
101
|
|
|
|
|
|
|
Indicates whether the instance is optimized for Amazon EBS I/O. This |
102
|
|
|
|
|
|
|
optimization provides dedicated throughput to Amazon EBS and an |
103
|
|
|
|
|
|
|
optimized configuration stack to provide optimal I/O performance. This |
104
|
|
|
|
|
|
|
optimization isn't available with all instance types. Additional usage |
105
|
|
|
|
|
|
|
charges apply when using an EBS Optimized instance. |
106
|
|
|
|
|
|
|
|
107
|
|
|
|
|
|
|
|
108
|
|
|
|
|
|
|
=head2 ElasticGpuAssociations => ArrayRef[L<Paws::EC2::ElasticGpuAssociation>] |
109
|
|
|
|
|
|
|
|
110
|
|
|
|
|
|
|
The Elastic GPU associated with the instance. |
111
|
|
|
|
|
|
|
|
112
|
|
|
|
|
|
|
|
113
|
|
|
|
|
|
|
=head2 EnaSupport => Bool |
114
|
|
|
|
|
|
|
|
115
|
|
|
|
|
|
|
Specifies whether enhanced networking with ENA is enabled. |
116
|
|
|
|
|
|
|
|
117
|
|
|
|
|
|
|
|
118
|
|
|
|
|
|
|
=head2 Hypervisor => Str |
119
|
|
|
|
|
|
|
|
120
|
|
|
|
|
|
|
The hypervisor type of the instance. |
121
|
|
|
|
|
|
|
|
122
|
|
|
|
|
|
|
|
123
|
|
|
|
|
|
|
=head2 IamInstanceProfile => L<Paws::EC2::IamInstanceProfile> |
124
|
|
|
|
|
|
|
|
125
|
|
|
|
|
|
|
The IAM instance profile associated with the instance, if applicable. |
126
|
|
|
|
|
|
|
|
127
|
|
|
|
|
|
|
|
128
|
|
|
|
|
|
|
=head2 ImageId => Str |
129
|
|
|
|
|
|
|
|
130
|
|
|
|
|
|
|
The ID of the AMI used to launch the instance. |
131
|
|
|
|
|
|
|
|
132
|
|
|
|
|
|
|
|
133
|
|
|
|
|
|
|
=head2 InstanceId => Str |
134
|
|
|
|
|
|
|
|
135
|
|
|
|
|
|
|
The ID of the instance. |
136
|
|
|
|
|
|
|
|
137
|
|
|
|
|
|
|
|
138
|
|
|
|
|
|
|
=head2 InstanceLifecycle => Str |
139
|
|
|
|
|
|
|
|
140
|
|
|
|
|
|
|
Indicates whether this is a Spot Instance or a Scheduled Instance. |
141
|
|
|
|
|
|
|
|
142
|
|
|
|
|
|
|
|
143
|
|
|
|
|
|
|
=head2 InstanceType => Str |
144
|
|
|
|
|
|
|
|
145
|
|
|
|
|
|
|
The instance type. |
146
|
|
|
|
|
|
|
|
147
|
|
|
|
|
|
|
|
148
|
|
|
|
|
|
|
=head2 KernelId => Str |
149
|
|
|
|
|
|
|
|
150
|
|
|
|
|
|
|
The kernel associated with this instance, if applicable. |
151
|
|
|
|
|
|
|
|
152
|
|
|
|
|
|
|
|
153
|
|
|
|
|
|
|
=head2 KeyName => Str |
154
|
|
|
|
|
|
|
|
155
|
|
|
|
|
|
|
The name of the key pair, if this instance was launched with an |
156
|
|
|
|
|
|
|
associated key pair. |
157
|
|
|
|
|
|
|
|
158
|
|
|
|
|
|
|
|
159
|
|
|
|
|
|
|
=head2 LaunchTime => Str |
160
|
|
|
|
|
|
|
|
161
|
|
|
|
|
|
|
The time the instance was launched. |
162
|
|
|
|
|
|
|
|
163
|
|
|
|
|
|
|
|
164
|
|
|
|
|
|
|
=head2 Monitoring => L<Paws::EC2::Monitoring> |
165
|
|
|
|
|
|
|
|
166
|
|
|
|
|
|
|
The monitoring for the instance. |
167
|
|
|
|
|
|
|
|
168
|
|
|
|
|
|
|
|
169
|
|
|
|
|
|
|
=head2 NetworkInterfaces => ArrayRef[L<Paws::EC2::InstanceNetworkInterface>] |
170
|
|
|
|
|
|
|
|
171
|
|
|
|
|
|
|
[EC2-VPC] One or more network interfaces for the instance. |
172
|
|
|
|
|
|
|
|
173
|
|
|
|
|
|
|
|
174
|
|
|
|
|
|
|
=head2 Placement => L<Paws::EC2::Placement> |
175
|
|
|
|
|
|
|
|
176
|
|
|
|
|
|
|
The location where the instance launched, if applicable. |
177
|
|
|
|
|
|
|
|
178
|
|
|
|
|
|
|
|
179
|
|
|
|
|
|
|
=head2 Platform => Str |
180
|
|
|
|
|
|
|
|
181
|
|
|
|
|
|
|
The value is C<Windows> for Windows instances; otherwise blank. |
182
|
|
|
|
|
|
|
|
183
|
|
|
|
|
|
|
|
184
|
|
|
|
|
|
|
=head2 PrivateDnsName => Str |
185
|
|
|
|
|
|
|
|
186
|
|
|
|
|
|
|
(IPv4 only) The private DNS hostname name assigned to the instance. |
187
|
|
|
|
|
|
|
This DNS hostname can only be used inside the Amazon EC2 network. This |
188
|
|
|
|
|
|
|
name is not available until the instance enters the C<running> state. |
189
|
|
|
|
|
|
|
|
190
|
|
|
|
|
|
|
[EC2-VPC] The Amazon-provided DNS server resolves Amazon-provided |
191
|
|
|
|
|
|
|
private DNS hostnames if you've enabled DNS resolution and DNS |
192
|
|
|
|
|
|
|
hostnames in your VPC. If you are not using the Amazon-provided DNS |
193
|
|
|
|
|
|
|
server in your VPC, your custom domain name servers must resolve the |
194
|
|
|
|
|
|
|
hostname as appropriate. |
195
|
|
|
|
|
|
|
|
196
|
|
|
|
|
|
|
|
197
|
|
|
|
|
|
|
=head2 PrivateIpAddress => Str |
198
|
|
|
|
|
|
|
|
199
|
|
|
|
|
|
|
The private IPv4 address assigned to the instance. |
200
|
|
|
|
|
|
|
|
201
|
|
|
|
|
|
|
|
202
|
|
|
|
|
|
|
=head2 ProductCodes => ArrayRef[L<Paws::EC2::ProductCode>] |
203
|
|
|
|
|
|
|
|
204
|
|
|
|
|
|
|
The product codes attached to this instance, if applicable. |
205
|
|
|
|
|
|
|
|
206
|
|
|
|
|
|
|
|
207
|
|
|
|
|
|
|
=head2 PublicDnsName => Str |
208
|
|
|
|
|
|
|
|
209
|
|
|
|
|
|
|
(IPv4 only) The public DNS name assigned to the instance. This name is |
210
|
|
|
|
|
|
|
not available until the instance enters the C<running> state. For |
211
|
|
|
|
|
|
|
EC2-VPC, this name is only available if you've enabled DNS hostnames |
212
|
|
|
|
|
|
|
for your VPC. |
213
|
|
|
|
|
|
|
|
214
|
|
|
|
|
|
|
|
215
|
|
|
|
|
|
|
=head2 PublicIpAddress => Str |
216
|
|
|
|
|
|
|
|
217
|
|
|
|
|
|
|
The public IPv4 address assigned to the instance, if applicable. |
218
|
|
|
|
|
|
|
|
219
|
|
|
|
|
|
|
|
220
|
|
|
|
|
|
|
=head2 RamdiskId => Str |
221
|
|
|
|
|
|
|
|
222
|
|
|
|
|
|
|
The RAM disk associated with this instance, if applicable. |
223
|
|
|
|
|
|
|
|
224
|
|
|
|
|
|
|
|
225
|
|
|
|
|
|
|
=head2 RootDeviceName => Str |
226
|
|
|
|
|
|
|
|
227
|
|
|
|
|
|
|
The root device name (for example, C</dev/sda1> or C</dev/xvda>). |
228
|
|
|
|
|
|
|
|
229
|
|
|
|
|
|
|
|
230
|
|
|
|
|
|
|
=head2 RootDeviceType => Str |
231
|
|
|
|
|
|
|
|
232
|
|
|
|
|
|
|
The root device type used by the AMI. The AMI can use an EBS volume or |
233
|
|
|
|
|
|
|
an instance store volume. |
234
|
|
|
|
|
|
|
|
235
|
|
|
|
|
|
|
|
236
|
|
|
|
|
|
|
=head2 SecurityGroups => ArrayRef[L<Paws::EC2::GroupIdentifier>] |
237
|
|
|
|
|
|
|
|
238
|
|
|
|
|
|
|
One or more security groups for the instance. |
239
|
|
|
|
|
|
|
|
240
|
|
|
|
|
|
|
|
241
|
|
|
|
|
|
|
=head2 SourceDestCheck => Bool |
242
|
|
|
|
|
|
|
|
243
|
|
|
|
|
|
|
Specifies whether to enable an instance launched in a VPC to perform |
244
|
|
|
|
|
|
|
NAT. This controls whether source/destination checking is enabled on |
245
|
|
|
|
|
|
|
the instance. A value of C<true> means that checking is enabled, and |
246
|
|
|
|
|
|
|
C<false> means that checking is disabled. The value must be C<false> |
247
|
|
|
|
|
|
|
for the instance to perform NAT. For more information, see NAT |
248
|
|
|
|
|
|
|
Instances in the I<Amazon Virtual Private Cloud User Guide>. |
249
|
|
|
|
|
|
|
|
250
|
|
|
|
|
|
|
|
251
|
|
|
|
|
|
|
=head2 SpotInstanceRequestId => Str |
252
|
|
|
|
|
|
|
|
253
|
|
|
|
|
|
|
If the request is a Spot Instance request, the ID of the request. |
254
|
|
|
|
|
|
|
|
255
|
|
|
|
|
|
|
|
256
|
|
|
|
|
|
|
=head2 SriovNetSupport => Str |
257
|
|
|
|
|
|
|
|
258
|
|
|
|
|
|
|
Specifies whether enhanced networking with the Intel 82599 Virtual |
259
|
|
|
|
|
|
|
Function interface is enabled. |
260
|
|
|
|
|
|
|
|
261
|
|
|
|
|
|
|
|
262
|
|
|
|
|
|
|
=head2 State => L<Paws::EC2::InstanceState> |
263
|
|
|
|
|
|
|
|
264
|
|
|
|
|
|
|
The current state of the instance. |
265
|
|
|
|
|
|
|
|
266
|
|
|
|
|
|
|
|
267
|
|
|
|
|
|
|
=head2 StateReason => L<Paws::EC2::StateReason> |
268
|
|
|
|
|
|
|
|
269
|
|
|
|
|
|
|
The reason for the most recent state transition. |
270
|
|
|
|
|
|
|
|
271
|
|
|
|
|
|
|
|
272
|
|
|
|
|
|
|
=head2 StateTransitionReason => Str |
273
|
|
|
|
|
|
|
|
274
|
|
|
|
|
|
|
The reason for the most recent state transition. This might be an empty |
275
|
|
|
|
|
|
|
string. |
276
|
|
|
|
|
|
|
|
277
|
|
|
|
|
|
|
|
278
|
|
|
|
|
|
|
=head2 SubnetId => Str |
279
|
|
|
|
|
|
|
|
280
|
|
|
|
|
|
|
[EC2-VPC] The ID of the subnet in which the instance is running. |
281
|
|
|
|
|
|
|
|
282
|
|
|
|
|
|
|
|
283
|
|
|
|
|
|
|
=head2 Tags => ArrayRef[L<Paws::EC2::Tag>] |
284
|
|
|
|
|
|
|
|
285
|
|
|
|
|
|
|
Any tags assigned to the instance. |
286
|
|
|
|
|
|
|
|
287
|
|
|
|
|
|
|
|
288
|
|
|
|
|
|
|
=head2 VirtualizationType => Str |
289
|
|
|
|
|
|
|
|
290
|
|
|
|
|
|
|
The virtualization type of the instance. |
291
|
|
|
|
|
|
|
|
292
|
|
|
|
|
|
|
|
293
|
|
|
|
|
|
|
=head2 VpcId => Str |
294
|
|
|
|
|
|
|
|
295
|
|
|
|
|
|
|
[EC2-VPC] The ID of the VPC in which the instance is running. |
296
|
|
|
|
|
|
|
|
297
|
|
|
|
|
|
|
|
298
|
|
|
|
|
|
|
|
299
|
|
|
|
|
|
|
=head1 SEE ALSO |
300
|
|
|
|
|
|
|
|
301
|
|
|
|
|
|
|
This class forms part of L<Paws>, describing an object used in L<Paws::EC2> |
302
|
|
|
|
|
|
|
|
303
|
|
|
|
|
|
|
=head1 BUGS and CONTRIBUTIONS |
304
|
|
|
|
|
|
|
|
305
|
|
|
|
|
|
|
The source code is located here: https://github.com/pplu/aws-sdk-perl |
306
|
|
|
|
|
|
|
|
307
|
|
|
|
|
|
|
Please report bugs to: https://github.com/pplu/aws-sdk-perl/issues |
308
|
|
|
|
|
|
|
|
309
|
|
|
|
|
|
|
=cut |