blib/lib/Paws/EC2/RunInstances.pm

filter: Statementstmt 100% 47 / 47 Branchbran n/a Conditioncond n/a MC/DCmcdc n/a Subroutinesub 100% 2 / 2 Podpod n/a totaltotal 100% 49 / 49 CC 1 SCAR 0.0
CC
1
Cov
100%
BEGIN
1.0
BEGIN
1.0
CRAP 1.0
« blib/lib/Paws/EC2/RouteTableAssociationState.pm ↑ Summary blib/lib/Paws/EC2/RunInstancesMonitoringEnabled.pm »
1  
2 package Paws::EC2::RunInstances;
3 2 ▶ use Moose;
Subroutine BEGIN: called CC=1 SCAR=0.0
4 2 has AdditionalInfo => (is => 'ro', isa => 'Str', traits => ['NameInRequest'], request_name => 'additionalInfo' );
5 2 has BlockDeviceMappings => (is => 'ro', isa => 'ArrayRef[Paws::EC2::BlockDeviceMapping]', traits => ['NameInRequest'], request_name => 'BlockDeviceMapping' );
6 2 has CapacityReservationSpecification => (is => 'ro', isa => 'Paws::EC2::CapacityReservationSpecification');
7 2 has ClientToken => (is => 'ro', isa => 'Str', traits => ['NameInRequest'], request_name => 'clientToken' );
8 2 has CpuOptions => (is => 'ro', isa => 'Paws::EC2::CpuOptionsRequest');
9 2 has CreditSpecification => (is => 'ro', isa => 'Paws::EC2::CreditSpecificationRequest');
10 2 has DisableApiTermination => (is => 'ro', isa => 'Bool', traits => ['NameInRequest'], request_name => 'disableApiTermination' );
11 2 has DryRun => (is => 'ro', isa => 'Bool', traits => ['NameInRequest'], request_name => 'dryRun' );
12 2 has EbsOptimized => (is => 'ro', isa => 'Bool', traits => ['NameInRequest'], request_name => 'ebsOptimized' );
13 2 has ElasticGpuSpecification => (is => 'ro', isa => 'ArrayRef[Paws::EC2::ElasticGpuSpecification]');
14 2 has ElasticInferenceAccelerators => (is => 'ro', isa => 'ArrayRef[Paws::EC2::ElasticInferenceAccelerator]', traits => ['NameInRequest'], request_name => 'ElasticInferenceAccelerator' );
15 2 has EnclaveOptions => (is => 'ro', isa => 'Paws::EC2::EnclaveOptionsRequest');
16 2 has HibernationOptions => (is => 'ro', isa => 'Paws::EC2::HibernationOptionsRequest');
17 2 has IamInstanceProfile => (is => 'ro', isa => 'Paws::EC2::IamInstanceProfileSpecification', traits => ['NameInRequest'], request_name => 'iamInstanceProfile' );
18 2 has ImageId => (is => 'ro', isa => 'Str');
19 2 has InstanceInitiatedShutdownBehavior => (is => 'ro', isa => 'Str', traits => ['NameInRequest'], request_name => 'instanceInitiatedShutdownBehavior' );
20 2 has InstanceMarketOptions => (is => 'ro', isa => 'Paws::EC2::InstanceMarketOptionsRequest');
21 2 has InstanceType => (is => 'ro', isa => 'Str');
22 2 has Ipv6AddressCount => (is => 'ro', isa => 'Int');
23 2 has Ipv6Addresses => (is => 'ro', isa => 'ArrayRef[Paws::EC2::InstanceIpv6Address]', traits => ['NameInRequest'], request_name => 'Ipv6Address' );
24 2 has KernelId => (is => 'ro', isa => 'Str');
25 2 has KeyName => (is => 'ro', isa => 'Str');
26 2 has LaunchTemplate => (is => 'ro', isa => 'Paws::EC2::LaunchTemplateSpecification');
27 2 has LicenseSpecifications => (is => 'ro', isa => 'ArrayRef[Paws::EC2::LicenseConfigurationRequest]', traits => ['NameInRequest'], request_name => 'LicenseSpecification' );
28 2 has MaxCount => (is => 'ro', isa => 'Int', required => 1);
29 2 has MetadataOptions => (is => 'ro', isa => 'Paws::EC2::InstanceMetadataOptionsRequest');
30 2 has MinCount => (is => 'ro', isa => 'Int', required => 1);
31 2 has Monitoring => (is => 'ro', isa => 'Paws::EC2::RunInstancesMonitoringEnabled');
32 2 has NetworkInterfaces => (is => 'ro', isa => 'ArrayRef[Paws::EC2::InstanceNetworkInterfaceSpecification]', traits => ['NameInRequest'], request_name => 'networkInterface' );
33 2 has Placement => (is => 'ro', isa => 'Paws::EC2::Placement');
34 2 has PrivateIpAddress => (is => 'ro', isa => 'Str', traits => ['NameInRequest'], request_name => 'privateIpAddress' );
35 2 has RamdiskId => (is => 'ro', isa => 'Str');
36 2 has SecurityGroupIds => (is => 'ro', isa => 'ArrayRef[Str|Undef]', traits => ['NameInRequest'], request_name => 'SecurityGroupId' );
37 2 has SecurityGroups => (is => 'ro', isa => 'ArrayRef[Str|Undef]', traits => ['NameInRequest'], request_name => 'SecurityGroup' );
38 2 has SubnetId => (is => 'ro', isa => 'Str');
39 2 has TagSpecifications => (is => 'ro', isa => 'ArrayRef[Paws::EC2::TagSpecification]', traits => ['NameInRequest'], request_name => 'TagSpecification' );
40 2 has UserData => (is => 'ro', isa => 'Str');
41  
42 2 ▶ use MooseX::ClassAttribute;
Subroutine BEGIN: called CC=1 SCAR=0.0
43  
44 2 class_has _api_call => (isa => 'Str', is => 'ro', default => 'RunInstances');
45 2 class_has _returns => (isa => 'Str', is => 'ro', default => 'Paws::EC2::Reservation');
46 2 class_has _result_key => (isa => 'Str', is => 'ro');
47 2 1;
48  
49 ### main pod documentation begin ###
50  
51 =head1 NAME
52  
53 Paws::EC2::RunInstances - Arguments for method RunInstances on L<Paws::EC2>
54  
55 =head1 DESCRIPTION
56  
57 This class represents the parameters used for calling the method RunInstances on the
58 L<Amazon Elastic Compute Cloud|Paws::EC2> service. Use the attributes of this class
59 as arguments to method RunInstances.
60  
61 You shouldn't make instances of this class. Each attribute should be used as a named argument in the call to RunInstances.
62  
63 =head1 SYNOPSIS
64  
65 my $ec2 = Paws->service('EC2');
66 # To launch an instance
67 # This example launches an instance using the specified AMI, instance type,
68 # security group, subnet, block device mapping, and tags.
69 my $Reservation = $ec2->RunInstances(
70 'BlockDeviceMappings' => [
71  
72 {
73 'DeviceName' => '/dev/sdh',
74 'Ebs' => {
75 'VolumeSize' => 100
76 }
77 }
78 ],
79 'ImageId' => 'ami-abc12345',
80 'InstanceType' => 't2.micro',
81 'KeyName' => 'my-key-pair',
82 'MaxCount' => 1,
83 'MinCount' => 1,
84 'SecurityGroupIds' => ['sg-1a2b3c4d'],
85 'SubnetId' => 'subnet-6e7f829e',
86 'TagSpecifications' => [
87  
88 {
89 'ResourceType' => 'instance',
90 'Tags' => [
91  
92 {
93 'Key' => 'Purpose',
94 'Value' => 'test'
95 }
96 ]
97 }
98 ]
99 );
100  
101  
102 Values for attributes that are native types (Int, String, Float, etc) can passed as-is (scalar values). Values for complex Types (objects) can be passed as a HashRef. The keys and values of the hashref will be used to instance the underlying object.
103 For the AWS API documentation, see L<https://docs.aws.amazon.com/goto/WebAPI/ec2/RunInstances>
104  
105 =head1 ATTRIBUTES
106  
107  
108 =head2 AdditionalInfo => Str
109  
110 Reserved.
111  
112  
113  
114 =head2 BlockDeviceMappings => ArrayRef[L<Paws::EC2::BlockDeviceMapping>]
115  
116 The block device mapping entries.
117  
118  
119  
120 =head2 CapacityReservationSpecification => L<Paws::EC2::CapacityReservationSpecification>
121  
122 Information about the Capacity Reservation targeting option. If you do
123 not specify this parameter, the instance's Capacity Reservation
124 preference defaults to C<open>, which enables it to run in any open
125 Capacity Reservation that has matching attributes (instance type,
126 platform, Availability Zone).
127  
128  
129  
130 =head2 ClientToken => Str
131  
132 Unique, case-sensitive identifier you provide to ensure the idempotency
133 of the request. If you do not specify a client token, a randomly
134 generated token is used for the request to ensure idempotency.
135  
136 For more information, see Ensuring Idempotency
137 (https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html).
138  
139 Constraints: Maximum 64 ASCII characters
140  
141  
142  
143 =head2 CpuOptions => L<Paws::EC2::CpuOptionsRequest>
144  
145 The CPU options for the instance. For more information, see Optimizing
146 CPU options
147 (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-optimize-cpu.html)
148 in the I<Amazon EC2 User Guide>.
149  
150  
151  
152 =head2 CreditSpecification => L<Paws::EC2::CreditSpecificationRequest>
153  
154 The credit option for CPU usage of the burstable performance instance.
155 Valid values are C<standard> and C<unlimited>. To change this attribute
156 after launch, use ModifyInstanceCreditSpecification
157 (https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ModifyInstanceCreditSpecification.html).
158 For more information, see Burstable performance instances
159 (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances.html)
160 in the I<Amazon EC2 User Guide>.
161  
162 Default: C<standard> (T2 instances) or C<unlimited> (T3/T3a instances)
163  
164  
165  
166 =head2 DisableApiTermination => Bool
167  
168 If you set this parameter to C<true>, you can't terminate the instance
169 using the Amazon EC2 console, CLI, or API; otherwise, you can. To
170 change this attribute after launch, use ModifyInstanceAttribute
171 (https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ModifyInstanceAttribute.html).
172 Alternatively, if you set C<InstanceInitiatedShutdownBehavior> to
173 C<terminate>, you can terminate the instance by running the shutdown
174 command from the instance.
175  
176 Default: C<false>
177  
178  
179  
180 =head2 DryRun => Bool
181  
182 Checks whether you have the required permissions for the action,
183 without actually making the request, and provides an error response. If
184 you have the required permissions, the error response is
185 C<DryRunOperation>. Otherwise, it is C<UnauthorizedOperation>.
186  
187  
188  
189 =head2 EbsOptimized => Bool
190  
191 Indicates whether the instance is optimized for Amazon EBS I/O. This
192 optimization provides dedicated throughput to Amazon EBS and an
193 optimized configuration stack to provide optimal Amazon EBS I/O
194 performance. This optimization isn't available with all instance types.
195 Additional usage charges apply when using an EBS-optimized instance.
196  
197 Default: C<false>
198  
199  
200  
201 =head2 ElasticGpuSpecification => ArrayRef[L<Paws::EC2::ElasticGpuSpecification>]
202  
203 An elastic GPU to associate with the instance. An Elastic GPU is a GPU
204 resource that you can attach to your Windows instance to accelerate the
205 graphics performance of your applications. For more information, see
206 Amazon EC2 Elastic GPUs
207 (https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/elastic-graphics.html)
208 in the I<Amazon EC2 User Guide>.
209  
210  
211  
212 =head2 ElasticInferenceAccelerators => ArrayRef[L<Paws::EC2::ElasticInferenceAccelerator>]
213  
214 An elastic inference accelerator to associate with the instance.
215 Elastic inference accelerators are a resource you can attach to your
216 Amazon EC2 instances to accelerate your Deep Learning (DL) inference
217 workloads.
218  
219 You cannot specify accelerators from different generations in the same
220 request.
221  
222  
223  
224 =head2 EnclaveOptions => L<Paws::EC2::EnclaveOptionsRequest>
225  
226 Indicates whether the instance is enabled for Amazon Web Services Nitro
227 Enclaves. For more information, see What is Amazon Web Services Nitro
228 Enclaves?
229 (https://docs.aws.amazon.com/enclaves/latest/user/nitro-enclave.html)
230 in the I<Amazon Web Services Nitro Enclaves User Guide>.
231  
232 You can't enable Amazon Web Services Nitro Enclaves and hibernation on
233 the same instance.
234  
235  
236  
237 =head2 HibernationOptions => L<Paws::EC2::HibernationOptionsRequest>
238  
239 Indicates whether an instance is enabled for hibernation. For more
240 information, see Hibernate your instance
241 (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Hibernate.html) in
242 the I<Amazon EC2 User Guide>.
243  
244 You can't enable hibernation and Amazon Web Services Nitro Enclaves on
245 the same instance.
246  
247  
248  
249 =head2 IamInstanceProfile => L<Paws::EC2::IamInstanceProfileSpecification>
250  
251 The name or Amazon Resource Name (ARN) of an IAM instance profile.
252  
253  
254  
255 =head2 ImageId => Str
256  
257 The ID of the AMI. An AMI ID is required to launch an instance and must
258 be specified here or in a launch template.
259  
260  
261  
262 =head2 InstanceInitiatedShutdownBehavior => Str
263  
264 Indicates whether an instance stops or terminates when you initiate
265 shutdown from the instance (using the operating system command for
266 system shutdown).
267  
268 Default: C<stop>
269  
270 Valid values are: C<"stop">, C<"terminate">
271  
272 =head2 InstanceMarketOptions => L<Paws::EC2::InstanceMarketOptionsRequest>
273  
274 The market (purchasing) option for the instances.
275  
276 For RunInstances, persistent Spot Instance requests are only supported
277 when B<InstanceInterruptionBehavior> is set to either C<hibernate> or
278 C<stop>.
279  
280  
281  
282 =head2 InstanceType => Str
283  
284 The instance type. For more information, see Instance types
285 (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html)
286 in the I<Amazon EC2 User Guide>.
287  
288 Default: C<m1.small>
289  
290 Valid values are: C<"t1.micro">, C<"t2.nano">, C<"t2.micro">, C<"t2.small">, C<"t2.medium">, C<"t2.large">, C<"t2.xlarge">, C<"t2.2xlarge">, C<"t3.nano">, C<"t3.micro">, C<"t3.small">, C<"t3.medium">, C<"t3.large">, C<"t3.xlarge">, C<"t3.2xlarge">, C<"t3a.nano">, C<"t3a.micro">, C<"t3a.small">, C<"t3a.medium">, C<"t3a.large">, C<"t3a.xlarge">, C<"t3a.2xlarge">, C<"t4g.nano">, C<"t4g.micro">, C<"t4g.small">, C<"t4g.medium">, C<"t4g.large">, C<"t4g.xlarge">, C<"t4g.2xlarge">, C<"m1.small">, C<"m1.medium">, C<"m1.large">, C<"m1.xlarge">, C<"m3.medium">, C<"m3.large">, C<"m3.xlarge">, C<"m3.2xlarge">, C<"m4.large">, C<"m4.xlarge">, C<"m4.2xlarge">, C<"m4.4xlarge">, C<"m4.10xlarge">, C<"m4.16xlarge">, C<"m2.xlarge">, C<"m2.2xlarge">, C<"m2.4xlarge">, C<"cr1.8xlarge">, C<"r3.large">, C<"r3.xlarge">, C<"r3.2xlarge">, C<"r3.4xlarge">, C<"r3.8xlarge">, C<"r4.large">, C<"r4.xlarge">, C<"r4.2xlarge">, C<"r4.4xlarge">, C<"r4.8xlarge">, C<"r4.16xlarge">, C<"r5.large">, C<"r5.xlarge">, C<"r5.2xlarge">, C<"r5.4xlarge">, C<"r5.8xlarge">, C<"r5.12xlarge">, C<"r5.16xlarge">, C<"r5.24xlarge">, C<"r5.metal">, C<"r5a.large">, C<"r5a.xlarge">, C<"r5a.2xlarge">, C<"r5a.4xlarge">, C<"r5a.8xlarge">, C<"r5a.12xlarge">, C<"r5a.16xlarge">, C<"r5a.24xlarge">, C<"r5b.large">, C<"r5b.xlarge">, C<"r5b.2xlarge">, C<"r5b.4xlarge">, C<"r5b.8xlarge">, C<"r5b.12xlarge">, C<"r5b.16xlarge">, C<"r5b.24xlarge">, C<"r5b.metal">, C<"r5d.large">, C<"r5d.xlarge">, C<"r5d.2xlarge">, C<"r5d.4xlarge">, C<"r5d.8xlarge">, C<"r5d.12xlarge">, C<"r5d.16xlarge">, C<"r5d.24xlarge">, C<"r5d.metal">, C<"r5ad.large">, C<"r5ad.xlarge">, C<"r5ad.2xlarge">, C<"r5ad.4xlarge">, C<"r5ad.8xlarge">, C<"r5ad.12xlarge">, C<"r5ad.16xlarge">, C<"r5ad.24xlarge">, C<"r6g.metal">, C<"r6g.medium">, C<"r6g.large">, C<"r6g.xlarge">, C<"r6g.2xlarge">, C<"r6g.4xlarge">, C<"r6g.8xlarge">, C<"r6g.12xlarge">, C<"r6g.16xlarge">, C<"r6gd.metal">, C<"r6gd.medium">, C<"r6gd.large">, C<"r6gd.xlarge">, C<"r6gd.2xlarge">, C<"r6gd.4xlarge">, C<"r6gd.8xlarge">, C<"r6gd.12xlarge">, C<"r6gd.16xlarge">, C<"x1.16xlarge">, C<"x1.32xlarge">, C<"x1e.xlarge">, C<"x1e.2xlarge">, C<"x1e.4xlarge">, C<"x1e.8xlarge">, C<"x1e.16xlarge">, C<"x1e.32xlarge">, C<"i2.xlarge">, C<"i2.2xlarge">, C<"i2.4xlarge">, C<"i2.8xlarge">, C<"i3.large">, C<"i3.xlarge">, C<"i3.2xlarge">, C<"i3.4xlarge">, C<"i3.8xlarge">, C<"i3.16xlarge">, C<"i3.metal">, C<"i3en.large">, C<"i3en.xlarge">, C<"i3en.2xlarge">, C<"i3en.3xlarge">, C<"i3en.6xlarge">, C<"i3en.12xlarge">, C<"i3en.24xlarge">, C<"i3en.metal">, C<"hi1.4xlarge">, C<"hs1.8xlarge">, C<"c1.medium">, C<"c1.xlarge">, C<"c3.large">, C<"c3.xlarge">, C<"c3.2xlarge">, C<"c3.4xlarge">, C<"c3.8xlarge">, C<"c4.large">, C<"c4.xlarge">, C<"c4.2xlarge">, C<"c4.4xlarge">, C<"c4.8xlarge">, C<"c5.large">, C<"c5.xlarge">, C<"c5.2xlarge">, C<"c5.4xlarge">, C<"c5.9xlarge">, C<"c5.12xlarge">, C<"c5.18xlarge">, C<"c5.24xlarge">, C<"c5.metal">, C<"c5a.large">, C<"c5a.xlarge">, C<"c5a.2xlarge">, C<"c5a.4xlarge">, C<"c5a.8xlarge">, C<"c5a.12xlarge">, C<"c5a.16xlarge">, C<"c5a.24xlarge">, C<"c5ad.large">, C<"c5ad.xlarge">, C<"c5ad.2xlarge">, C<"c5ad.4xlarge">, C<"c5ad.8xlarge">, C<"c5ad.12xlarge">, C<"c5ad.16xlarge">, C<"c5ad.24xlarge">, C<"c5d.large">, C<"c5d.xlarge">, C<"c5d.2xlarge">, C<"c5d.4xlarge">, C<"c5d.9xlarge">, C<"c5d.12xlarge">, C<"c5d.18xlarge">, C<"c5d.24xlarge">, C<"c5d.metal">, C<"c5n.large">, C<"c5n.xlarge">, C<"c5n.2xlarge">, C<"c5n.4xlarge">, C<"c5n.9xlarge">, C<"c5n.18xlarge">, C<"c5n.metal">, C<"c6g.metal">, C<"c6g.medium">, C<"c6g.large">, C<"c6g.xlarge">, C<"c6g.2xlarge">, C<"c6g.4xlarge">, C<"c6g.8xlarge">, C<"c6g.12xlarge">, C<"c6g.16xlarge">, C<"c6gd.metal">, C<"c6gd.medium">, C<"c6gd.large">, C<"c6gd.xlarge">, C<"c6gd.2xlarge">, C<"c6gd.4xlarge">, C<"c6gd.8xlarge">, C<"c6gd.12xlarge">, C<"c6gd.16xlarge">, C<"c6gn.medium">, C<"c6gn.large">, C<"c6gn.xlarge">, C<"c6gn.2xlarge">, C<"c6gn.4xlarge">, C<"c6gn.8xlarge">, C<"c6gn.12xlarge">, C<"c6gn.16xlarge">, C<"cc1.4xlarge">, C<"cc2.8xlarge">, C<"g2.2xlarge">, C<"g2.8xlarge">, C<"g3.4xlarge">, C<"g3.8xlarge">, C<"g3.16xlarge">, C<"g3s.xlarge">, C<"g4ad.4xlarge">, C<"g4ad.8xlarge">, C<"g4ad.16xlarge">, C<"g4dn.xlarge">, C<"g4dn.2xlarge">, C<"g4dn.4xlarge">, C<"g4dn.8xlarge">, C<"g4dn.12xlarge">, C<"g4dn.16xlarge">, C<"g4dn.metal">, C<"cg1.4xlarge">, C<"p2.xlarge">, C<"p2.8xlarge">, C<"p2.16xlarge">, C<"p3.2xlarge">, C<"p3.8xlarge">, C<"p3.16xlarge">, C<"p3dn.24xlarge">, C<"p4d.24xlarge">, C<"d2.xlarge">, C<"d2.2xlarge">, C<"d2.4xlarge">, C<"d2.8xlarge">, C<"d3.xlarge">, C<"d3.2xlarge">, C<"d3.4xlarge">, C<"d3.8xlarge">, C<"d3en.xlarge">, C<"d3en.2xlarge">, C<"d3en.4xlarge">, C<"d3en.6xlarge">, C<"d3en.8xlarge">, C<"d3en.12xlarge">, C<"f1.2xlarge">, C<"f1.4xlarge">, C<"f1.16xlarge">, C<"m5.large">, C<"m5.xlarge">, C<"m5.2xlarge">, C<"m5.4xlarge">, C<"m5.8xlarge">, C<"m5.12xlarge">, C<"m5.16xlarge">, C<"m5.24xlarge">, C<"m5.metal">, C<"m5a.large">, C<"m5a.xlarge">, C<"m5a.2xlarge">, C<"m5a.4xlarge">, C<"m5a.8xlarge">, C<"m5a.12xlarge">, C<"m5a.16xlarge">, C<"m5a.24xlarge">, C<"m5d.large">, C<"m5d.xlarge">, C<"m5d.2xlarge">, C<"m5d.4xlarge">, C<"m5d.8xlarge">, C<"m5d.12xlarge">, C<"m5d.16xlarge">, C<"m5d.24xlarge">, C<"m5d.metal">, C<"m5ad.large">, C<"m5ad.xlarge">, C<"m5ad.2xlarge">, C<"m5ad.4xlarge">, C<"m5ad.8xlarge">, C<"m5ad.12xlarge">, C<"m5ad.16xlarge">, C<"m5ad.24xlarge">, C<"m5zn.large">, C<"m5zn.xlarge">, C<"m5zn.2xlarge">, C<"m5zn.3xlarge">, C<"m5zn.6xlarge">, C<"m5zn.12xlarge">, C<"m5zn.metal">, C<"h1.2xlarge">, C<"h1.4xlarge">, C<"h1.8xlarge">, C<"h1.16xlarge">, C<"z1d.large">, C<"z1d.xlarge">, C<"z1d.2xlarge">, C<"z1d.3xlarge">, C<"z1d.6xlarge">, C<"z1d.12xlarge">, C<"z1d.metal">, C<"u-6tb1.56xlarge">, C<"u-6tb1.112xlarge">, C<"u-9tb1.112xlarge">, C<"u-12tb1.112xlarge">, C<"u-6tb1.metal">, C<"u-9tb1.metal">, C<"u-12tb1.metal">, C<"u-18tb1.metal">, C<"u-24tb1.metal">, C<"a1.medium">, C<"a1.large">, C<"a1.xlarge">, C<"a1.2xlarge">, C<"a1.4xlarge">, C<"a1.metal">, C<"m5dn.large">, C<"m5dn.xlarge">, C<"m5dn.2xlarge">, C<"m5dn.4xlarge">, C<"m5dn.8xlarge">, C<"m5dn.12xlarge">, C<"m5dn.16xlarge">, C<"m5dn.24xlarge">, C<"m5dn.metal">, C<"m5n.large">, C<"m5n.xlarge">, C<"m5n.2xlarge">, C<"m5n.4xlarge">, C<"m5n.8xlarge">, C<"m5n.12xlarge">, C<"m5n.16xlarge">, C<"m5n.24xlarge">, C<"m5n.metal">, C<"r5dn.large">, C<"r5dn.xlarge">, C<"r5dn.2xlarge">, C<"r5dn.4xlarge">, C<"r5dn.8xlarge">, C<"r5dn.12xlarge">, C<"r5dn.16xlarge">, C<"r5dn.24xlarge">, C<"r5dn.metal">, C<"r5n.large">, C<"r5n.xlarge">, C<"r5n.2xlarge">, C<"r5n.4xlarge">, C<"r5n.8xlarge">, C<"r5n.12xlarge">, C<"r5n.16xlarge">, C<"r5n.24xlarge">, C<"r5n.metal">, C<"inf1.xlarge">, C<"inf1.2xlarge">, C<"inf1.6xlarge">, C<"inf1.24xlarge">, C<"m6g.metal">, C<"m6g.medium">, C<"m6g.large">, C<"m6g.xlarge">, C<"m6g.2xlarge">, C<"m6g.4xlarge">, C<"m6g.8xlarge">, C<"m6g.12xlarge">, C<"m6g.16xlarge">, C<"m6gd.metal">, C<"m6gd.medium">, C<"m6gd.large">, C<"m6gd.xlarge">, C<"m6gd.2xlarge">, C<"m6gd.4xlarge">, C<"m6gd.8xlarge">, C<"m6gd.12xlarge">, C<"m6gd.16xlarge">, C<"mac1.metal">, C<"x2gd.medium">, C<"x2gd.large">, C<"x2gd.xlarge">, C<"x2gd.2xlarge">, C<"x2gd.4xlarge">, C<"x2gd.8xlarge">, C<"x2gd.12xlarge">, C<"x2gd.16xlarge">, C<"x2gd.metal">
291  
292 =head2 Ipv6AddressCount => Int
293  
294 [EC2-VPC] The number of IPv6 addresses to associate with the primary
295 network interface. Amazon EC2 chooses the IPv6 addresses from the range
296 of your subnet. You cannot specify this option and the option to assign
297 specific IPv6 addresses in the same request. You can specify this
298 option if you've specified a minimum number of instances to launch.
299  
300 You cannot specify this option and the network interfaces option in the
301 same request.
302  
303  
304  
305 =head2 Ipv6Addresses => ArrayRef[L<Paws::EC2::InstanceIpv6Address>]
306  
307 [EC2-VPC] The IPv6 addresses from the range of the subnet to associate
308 with the primary network interface. You cannot specify this option and
309 the option to assign a number of IPv6 addresses in the same request.
310 You cannot specify this option if you've specified a minimum number of
311 instances to launch.
312  
313 You cannot specify this option and the network interfaces option in the
314 same request.
315  
316  
317  
318 =head2 KernelId => Str
319  
320 The ID of the kernel.
321  
322 We recommend that you use PV-GRUB instead of kernels and RAM disks. For
323 more information, see PV-GRUB
324 (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/UserProvidedkernels.html)
325 in the I<Amazon EC2 User Guide>.
326  
327  
328  
329 =head2 KeyName => Str
330  
331 The name of the key pair. You can create a key pair using CreateKeyPair
332 (https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateKeyPair.html)
333 or ImportKeyPair
334 (https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ImportKeyPair.html).
335  
336 If you do not specify a key pair, you can't connect to the instance
337 unless you choose an AMI that is configured to allow users another way
338 to log in.
339  
340  
341  
342 =head2 LaunchTemplate => L<Paws::EC2::LaunchTemplateSpecification>
343  
344 The launch template to use to launch the instances. Any parameters that
345 you specify in RunInstances override the same parameters in the launch
346 template. You can specify either the name or ID of a launch template,
347 but not both.
348  
349  
350  
351 =head2 LicenseSpecifications => ArrayRef[L<Paws::EC2::LicenseConfigurationRequest>]
352  
353 The license configurations.
354  
355  
356  
357 =head2 B<REQUIRED> MaxCount => Int
358  
359 The maximum number of instances to launch. If you specify more
360 instances than Amazon EC2 can launch in the target Availability Zone,
361 Amazon EC2 launches the largest possible number of instances above
362 C<MinCount>.
363  
364 Constraints: Between 1 and the maximum number you're allowed for the
365 specified instance type. For more information about the default limits,
366 and how to request an increase, see How many instances can I run in
367 Amazon EC2
368 (http://aws.amazon.com/ec2/faqs/#How_many_instances_can_I_run_in_Amazon_EC2)
369 in the Amazon EC2 FAQ.
370  
371  
372  
373 =head2 MetadataOptions => L<Paws::EC2::InstanceMetadataOptionsRequest>
374  
375 The metadata options for the instance. For more information, see
376 Instance metadata and user data
377 (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html).
378  
379  
380  
381 =head2 B<REQUIRED> MinCount => Int
382  
383 The minimum number of instances to launch. If you specify a minimum
384 that is more instances than Amazon EC2 can launch in the target
385 Availability Zone, Amazon EC2 launches no instances.
386  
387 Constraints: Between 1 and the maximum number you're allowed for the
388 specified instance type. For more information about the default limits,
389 and how to request an increase, see How many instances can I run in
390 Amazon EC2
391 (http://aws.amazon.com/ec2/faqs/#How_many_instances_can_I_run_in_Amazon_EC2)
392 in the Amazon EC2 General FAQ.
393  
394  
395  
396 =head2 Monitoring => L<Paws::EC2::RunInstancesMonitoringEnabled>
397  
398 Specifies whether detailed monitoring is enabled for the instance.
399  
400  
401  
402 =head2 NetworkInterfaces => ArrayRef[L<Paws::EC2::InstanceNetworkInterfaceSpecification>]
403  
404 The network interfaces to associate with the instance. If you specify a
405 network interface, you must specify any security groups and subnets as
406 part of the network interface.
407  
408  
409  
410 =head2 Placement => L<Paws::EC2::Placement>
411  
412 The placement for the instance.
413  
414  
415  
416 =head2 PrivateIpAddress => Str
417  
418 [EC2-VPC] The primary IPv4 address. You must specify a value from the
419 IPv4 address range of the subnet.
420  
421 Only one private IP address can be designated as primary. You can't
422 specify this option if you've specified the option to designate a
423 private IP address as the primary IP address in a network interface
424 specification. You cannot specify this option if you're launching more
425 than one instance in the request.
426  
427 You cannot specify this option and the network interfaces option in the
428 same request.
429  
430  
431  
432 =head2 RamdiskId => Str
433  
434 The ID of the RAM disk to select. Some kernels require additional
435 drivers at launch. Check the kernel requirements for information about
436 whether you need to specify a RAM disk. To find kernel requirements, go
437 to the Amazon Web Services Resource Center and search for the kernel
438 ID.
439  
440 We recommend that you use PV-GRUB instead of kernels and RAM disks. For
441 more information, see PV-GRUB
442 (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/UserProvidedkernels.html)
443 in the I<Amazon EC2 User Guide>.
444  
445  
446  
447 =head2 SecurityGroupIds => ArrayRef[Str|Undef]
448  
449 The IDs of the security groups. You can create a security group using
450 CreateSecurityGroup
451 (https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateSecurityGroup.html).
452  
453 If you specify a network interface, you must specify any security
454 groups as part of the network interface.
455  
456  
457  
458 =head2 SecurityGroups => ArrayRef[Str|Undef]
459  
460 [EC2-Classic, default VPC] The names of the security groups. For a
461 nondefault VPC, you must use security group IDs instead.
462  
463 If you specify a network interface, you must specify any security
464 groups as part of the network interface.
465  
466 Default: Amazon EC2 uses the default security group.
467  
468  
469  
470 =head2 SubnetId => Str
471  
472 [EC2-VPC] The ID of the subnet to launch the instance into.
473  
474 If you specify a network interface, you must specify any subnets as
475 part of the network interface.
476  
477  
478  
479 =head2 TagSpecifications => ArrayRef[L<Paws::EC2::TagSpecification>]
480  
481 The tags to apply to the resources during launch. You can only tag
482 instances and volumes on launch. The specified tags are applied to all
483 instances or volumes that are created during launch. To tag a resource
484 after it has been created, see CreateTags
485 (https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateTags.html).
486  
487  
488  
489 =head2 UserData => Str
490  
491 The user data to make available to the instance. For more information,
492 see Running commands on your Linux instance at launch
493 (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/user-data.html)
494 (Linux) and Adding User Data
495 (https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/ec2-instance-metadata.html#instancedata-add-user-data)
496 (Windows). If you are using a command line tool, base64-encoding is
497 performed for you, and you can load the text from a file. Otherwise,
498 you must provide base64-encoded text. User data is limited to 16 KB.
499  
500  
501  
502  
503 =head1 SEE ALSO
504  
505 This class forms part of L<Paws>, documenting arguments for method RunInstances in L<Paws::EC2>
506  
507 =head1 BUGS and CONTRIBUTIONS
508  
509 The source code is located here: L<https://github.com/pplu/aws-sdk-perl>
510  
511 Please report bugs to: L<https://github.com/pplu/aws-sdk-perl/issues>
512  
513 =cut
514  
« blib/lib/Paws/EC2/RouteTableAssociationState.pm ↑ Summary blib/lib/Paws/EC2/RunInstancesMonitoringEnabled.pm »