aws-sdk-ec2 1.82.0 → 1.83.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -401,6 +401,7 @@ module Aws::EC2
401
401
  DescribeConversionTasksResult = Shapes::StructureShape.new(name: 'DescribeConversionTasksResult')
402
402
  DescribeCustomerGatewaysRequest = Shapes::StructureShape.new(name: 'DescribeCustomerGatewaysRequest')
403
403
  DescribeCustomerGatewaysResult = Shapes::StructureShape.new(name: 'DescribeCustomerGatewaysResult')
404
+ DescribeDhcpOptionsMaxResults = Shapes::IntegerShape.new(name: 'DescribeDhcpOptionsMaxResults')
404
405
  DescribeDhcpOptionsRequest = Shapes::StructureShape.new(name: 'DescribeDhcpOptionsRequest')
405
406
  DescribeDhcpOptionsResult = Shapes::StructureShape.new(name: 'DescribeDhcpOptionsResult')
406
407
  DescribeEgressOnlyInternetGatewaysRequest = Shapes::StructureShape.new(name: 'DescribeEgressOnlyInternetGatewaysRequest')
@@ -521,6 +522,7 @@ module Aws::EC2
521
522
  DescribeSpotPriceHistoryResult = Shapes::StructureShape.new(name: 'DescribeSpotPriceHistoryResult')
522
523
  DescribeStaleSecurityGroupsRequest = Shapes::StructureShape.new(name: 'DescribeStaleSecurityGroupsRequest')
523
524
  DescribeStaleSecurityGroupsResult = Shapes::StructureShape.new(name: 'DescribeStaleSecurityGroupsResult')
525
+ DescribeSubnetsMaxResults = Shapes::IntegerShape.new(name: 'DescribeSubnetsMaxResults')
524
526
  DescribeSubnetsRequest = Shapes::StructureShape.new(name: 'DescribeSubnetsRequest')
525
527
  DescribeSubnetsResult = Shapes::StructureShape.new(name: 'DescribeSubnetsResult')
526
528
  DescribeTagsRequest = Shapes::StructureShape.new(name: 'DescribeTagsRequest')
@@ -3051,9 +3053,12 @@ module Aws::EC2
3051
3053
  DescribeDhcpOptionsRequest.add_member(:dhcp_options_ids, Shapes::ShapeRef.new(shape: DhcpOptionsIdStringList, location_name: "DhcpOptionsId"))
3052
3054
  DescribeDhcpOptionsRequest.add_member(:filters, Shapes::ShapeRef.new(shape: FilterList, location_name: "Filter"))
3053
3055
  DescribeDhcpOptionsRequest.add_member(:dry_run, Shapes::ShapeRef.new(shape: Boolean, location_name: "dryRun"))
3056
+ DescribeDhcpOptionsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "NextToken"))
3057
+ DescribeDhcpOptionsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: DescribeDhcpOptionsMaxResults, location_name: "MaxResults"))
3054
3058
  DescribeDhcpOptionsRequest.struct_class = Types::DescribeDhcpOptionsRequest
3055
3059
 
3056
3060
  DescribeDhcpOptionsResult.add_member(:dhcp_options, Shapes::ShapeRef.new(shape: DhcpOptionsList, location_name: "dhcpOptionsSet"))
3061
+ DescribeDhcpOptionsResult.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "nextToken"))
3057
3062
  DescribeDhcpOptionsResult.struct_class = Types::DescribeDhcpOptionsResult
3058
3063
 
3059
3064
  DescribeEgressOnlyInternetGatewaysRequest.add_member(:dry_run, Shapes::ShapeRef.new(shape: Boolean, location_name: "DryRun"))
@@ -3666,9 +3671,12 @@ module Aws::EC2
3666
3671
  DescribeSubnetsRequest.add_member(:filters, Shapes::ShapeRef.new(shape: FilterList, location_name: "Filter"))
3667
3672
  DescribeSubnetsRequest.add_member(:subnet_ids, Shapes::ShapeRef.new(shape: SubnetIdStringList, location_name: "SubnetId"))
3668
3673
  DescribeSubnetsRequest.add_member(:dry_run, Shapes::ShapeRef.new(shape: Boolean, location_name: "dryRun"))
3674
+ DescribeSubnetsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "NextToken"))
3675
+ DescribeSubnetsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: DescribeSubnetsMaxResults, location_name: "MaxResults"))
3669
3676
  DescribeSubnetsRequest.struct_class = Types::DescribeSubnetsRequest
3670
3677
 
3671
3678
  DescribeSubnetsResult.add_member(:subnets, Shapes::ShapeRef.new(shape: SubnetList, location_name: "subnetSet"))
3679
+ DescribeSubnetsResult.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "nextToken"))
3672
3680
  DescribeSubnetsResult.struct_class = Types::DescribeSubnetsResult
3673
3681
 
3674
3682
  DescribeTagsRequest.add_member(:dry_run, Shapes::ShapeRef.new(shape: Boolean, location_name: "dryRun"))
@@ -8737,6 +8745,12 @@ module Aws::EC2
8737
8745
  o.http_request_uri = "/"
8738
8746
  o.input = Shapes::ShapeRef.new(shape: DescribeDhcpOptionsRequest)
8739
8747
  o.output = Shapes::ShapeRef.new(shape: DescribeDhcpOptionsResult)
8748
+ o[:pager] = Aws::Pager.new(
8749
+ limit_key: "max_results",
8750
+ tokens: {
8751
+ "next_token" => "next_token"
8752
+ }
8753
+ )
8740
8754
  end)
8741
8755
 
8742
8756
  api.add_operation(:describe_egress_only_internet_gateways, Seahorse::Model::Operation.new.tap do |o|
@@ -9402,6 +9416,12 @@ module Aws::EC2
9402
9416
  o.http_request_uri = "/"
9403
9417
  o.input = Shapes::ShapeRef.new(shape: DescribeSubnetsRequest)
9404
9418
  o.output = Shapes::ShapeRef.new(shape: DescribeSubnetsResult)
9419
+ o[:pager] = Aws::Pager.new(
9420
+ limit_key: "max_results",
9421
+ tokens: {
9422
+ "next_token" => "next_token"
9423
+ }
9424
+ )
9405
9425
  end)
9406
9426
 
9407
9427
  api.add_operation(:describe_tags, Seahorse::Model::Operation.new.tap do |o|
@@ -243,11 +243,16 @@ module Aws::EC2
243
243
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/UserProvidedkernels.html
244
244
  # @option options [String] :key_name
245
245
  # The name of the key pair. You can create a key pair using
246
- # CreateKeyPair or ImportKeyPair.
246
+ # [CreateKeyPair][1] or [ImportKeyPair][2].
247
247
  #
248
248
  # If you do not specify a key pair, you can't connect to the instance
249
249
  # unless you choose an AMI that is configured to allow users another way
250
250
  # to log in.
251
+ #
252
+ #
253
+ #
254
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateKeyPair.html
255
+ # [2]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ImportKeyPair.html
251
256
  # @option options [required, Integer] :max_count
252
257
  # The maximum number of instances to launch. If you specify more
253
258
  # instances than Amazon EC2 can launch in the target Availability Zone,
@@ -294,18 +299,20 @@ module Aws::EC2
294
299
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/UserProvidedkernels.html
295
300
  # @option options [Array<String>] :security_group_ids
296
301
  # The IDs of the security groups. You can create a security group using
297
- # CreateSecurityGroup.
302
+ # [CreateSecurityGroup][1].
298
303
  #
299
- # Default: Amazon EC2 uses the default security group.
304
+ # If you specify a network interface, you must specify any security
305
+ # groups as part of the network interface.
300
306
  #
301
- # You cannot specify this option and the network interfaces option in
302
- # the same request.
307
+ #
308
+ #
309
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateSecurityGroup.html
303
310
  # @option options [Array<String>] :security_groups
304
311
  # \[EC2-Classic, default VPC\] The names of the security groups. For a
305
312
  # nondefault VPC, you must use security group IDs instead.
306
313
  #
307
- # You cannot specify this option and the network interfaces option in
308
- # the same request.
314
+ # If you specify a network interface, you must specify any security
315
+ # groups as part of the network interface.
309
316
  #
310
317
  # Default: Amazon EC2 uses the default security group.
311
318
  # @option options [String] :subnet_id
@@ -341,11 +348,15 @@ module Aws::EC2
341
348
  # If you set this parameter to `true`, you can't terminate the instance
342
349
  # using the Amazon EC2 console, CLI, or API; otherwise, you can. To
343
350
  # change this attribute to `false` after launch, use
344
- # ModifyInstanceAttribute. Alternatively, if you set
351
+ # [ModifyInstanceAttribute][1]. Alternatively, if you set
345
352
  # `InstanceInitiatedShutdownBehavior` to `terminate`, you can terminate
346
353
  # the instance by running the shutdown command from the instance.
347
354
  #
348
355
  # Default: `false`
356
+ #
357
+ #
358
+ #
359
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ModifyInstanceAttribute.html
349
360
  # @option options [Boolean] :dry_run
350
361
  # Checks whether you have the required permissions for the action,
351
362
  # without actually making the request, and provides an error response.
@@ -369,7 +380,9 @@ module Aws::EC2
369
380
  #
370
381
  # Default: `stop`
371
382
  # @option options [Array<Types::InstanceNetworkInterfaceSpecification>] :network_interfaces
372
- # The network interfaces to associate with the instance.
383
+ # The network interfaces to associate with the instance. If you specify
384
+ # a network interface, you must specify any security groups as part of
385
+ # the network interface.
373
386
  # @option options [String] :private_ip_address
374
387
  # \[EC2-VPC\] The primary IPv4 address. You must specify a value from
375
388
  # the IPv4 address range of the subnet.
@@ -401,7 +414,11 @@ module Aws::EC2
401
414
  # The tags to apply to the resources during launch. You can only tag
402
415
  # instances and volumes on launch. The specified tags are applied to all
403
416
  # instances or volumes that are created during launch. To tag a resource
404
- # after it has been created, see CreateTags.
417
+ # after it has been created, see [CreateTags][1].
418
+ #
419
+ #
420
+ #
421
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateTags.html
405
422
  # @option options [Types::LaunchTemplateSpecification] :launch_template
406
423
  # The launch template to use to launch the instances. Any parameters
407
424
  # that you specify in RunInstances override the same parameters in the
@@ -416,15 +433,16 @@ module Aws::EC2
416
433
  # @option options [Types::CreditSpecificationRequest] :credit_specification
417
434
  # The credit option for CPU usage of the T2 or T3 instance. Valid values
418
435
  # are `standard` and `unlimited`. To change this attribute after launch,
419
- # use ModifyInstanceCreditSpecification. For more information, see
420
- # [Burstable Performance Instances][1] in the *Amazon Elastic Compute
436
+ # use [ ModifyInstanceCreditSpecification][1]. For more information, see
437
+ # [Burstable Performance Instances][2] in the *Amazon Elastic Compute
421
438
  # Cloud User Guide*.
422
439
  #
423
440
  # Default: `standard` (T2 instances) or `unlimited` (T3 instances)
424
441
  #
425
442
  #
426
443
  #
427
- # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances.html
444
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ModifyInstanceCreditSpecification.html
445
+ # [2]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances.html
428
446
  # @option options [Types::CpuOptionsRequest] :cpu_options
429
447
  # The CPU options for the instance. For more information, see
430
448
  # [Optimizing CPU Options][1] in the *Amazon Elastic Compute Cloud User
@@ -603,11 +621,14 @@ module Aws::EC2
603
621
  # @option options [String] :interface_type
604
622
  # Indicates whether the network interface is an Elastic Fabric Adapter
605
623
  # (EFA). Only specify this parameter to create an EFA. For more
606
- # information, see [Elastic Fabric
607
- # Adapter](AWSEC2/latest/UserGuide/efa.html) in the *Amazon Elastic
624
+ # information, see [Elastic Fabric Adapter][1] in the *Amazon Elastic
608
625
  # Compute Cloud User Guide*.
609
626
  #
610
627
  # If you are not creating an EFA ENI, omit this parameter.
628
+ #
629
+ #
630
+ #
631
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/efa.html
611
632
  # @option options [required, String] :subnet_id
612
633
  # The ID of the subnet to associate with the network interface.
613
634
  # @return [NetworkInterface]
@@ -902,17 +923,17 @@ module Aws::EC2
902
923
  # * Key ID
903
924
  #
904
925
  # * Key alias. The alias ARN contains the `arn:aws:kms` namespace,
905
- # followed by the region of the CMK, the AWS account ID of the CMK
926
+ # followed by the Region of the CMK, the AWS account ID of the CMK
906
927
  # owner, the `alias` namespace, and then the CMK alias. For example,
907
928
  # arn:aws:kms:*us-east-1*\:*012345678910*\:alias/*ExampleAlias*.
908
929
  #
909
930
  # * ARN using key ID. The ID ARN contains the `arn:aws:kms` namespace,
910
- # followed by the region of the CMK, the AWS account ID of the CMK
931
+ # followed by the Region of the CMK, the AWS account ID of the CMK
911
932
  # owner, the `key` namespace, and then the CMK ID. For example,
912
933
  # arn:aws:kms:*us-east-1*\:*012345678910*\:key/*abcd1234-a123-456a-a12b-a123b4cd56ef*.
913
934
  #
914
935
  # * ARN using key alias. The alias ARN contains the `arn:aws:kms`
915
- # namespace, followed by the region of the CMK, the AWS account ID of
936
+ # namespace, followed by the Region of the CMK, the AWS account ID of
916
937
  # the CMK owner, the `alias` namespace, and then the CMK alias. For
917
938
  # example,
918
939
  # arn:aws:kms:*us-east-1*\:*012345678910*\:alias/*ExampleAlias*.
@@ -1036,10 +1057,10 @@ module Aws::EC2
1036
1057
  # The ID of the requester VPC. You must specify this parameter in the
1037
1058
  # request.
1038
1059
  # @option options [String] :peer_region
1039
- # The region code for the accepter VPC, if the accepter VPC is located
1040
- # in a region other than the region in which you make the request.
1060
+ # The Region code for the accepter VPC, if the accepter VPC is located
1061
+ # in a Region other than the Region in which you make the request.
1041
1062
  #
1042
- # Default: The region in which you make the request.
1063
+ # Default: The Region in which you make the request.
1043
1064
  # @return [VpcPeeringConnection]
1044
1065
  def create_vpc_peering_connection(options = {})
1045
1066
  resp = @client.create_vpc_peering_connection(options)
@@ -1326,16 +1347,18 @@ module Aws::EC2
1326
1347
  # @return [DhcpOptions::Collection]
1327
1348
  def dhcp_options_sets(options = {})
1328
1349
  batches = Enumerator.new do |y|
1329
- batch = []
1330
1350
  resp = @client.describe_dhcp_options(options)
1331
- resp.data.dhcp_options.each do |d|
1332
- batch << DhcpOptions.new(
1333
- id: d.dhcp_options_id,
1334
- data: d,
1335
- client: @client
1336
- )
1351
+ resp.each_page do |page|
1352
+ batch = []
1353
+ page.data.dhcp_options.each do |d|
1354
+ batch << DhcpOptions.new(
1355
+ id: d.dhcp_options_id,
1356
+ data: d,
1357
+ client: @client
1358
+ )
1359
+ end
1360
+ y.yield(batch)
1337
1361
  end
1338
- y.yield(batch)
1339
1362
  end
1340
1363
  DhcpOptions::Collection.new(batches)
1341
1364
  end
@@ -2700,16 +2723,18 @@ module Aws::EC2
2700
2723
  # @return [Subnet::Collection]
2701
2724
  def subnets(options = {})
2702
2725
  batches = Enumerator.new do |y|
2703
- batch = []
2704
2726
  resp = @client.describe_subnets(options)
2705
- resp.data.subnets.each do |s|
2706
- batch << Subnet.new(
2707
- id: s.subnet_id,
2708
- data: s,
2709
- client: @client
2710
- )
2727
+ resp.each_page do |page|
2728
+ batch = []
2729
+ page.data.subnets.each do |s|
2730
+ batch << Subnet.new(
2731
+ id: s.subnet_id,
2732
+ data: s,
2733
+ client: @client
2734
+ )
2735
+ end
2736
+ y.yield(batch)
2711
2737
  end
2712
- y.yield(batch)
2713
2738
  end
2714
2739
  Subnet::Collection.new(batches)
2715
2740
  end
@@ -325,17 +325,17 @@ module Aws::EC2
325
325
  # * Key ID
326
326
  #
327
327
  # * Key alias. The alias ARN contains the `arn:aws:kms` namespace,
328
- # followed by the region of the CMK, the AWS account ID of the CMK
328
+ # followed by the Region of the CMK, the AWS account ID of the CMK
329
329
  # owner, the `alias` namespace, and then the CMK alias. For example,
330
330
  # arn:aws:kms:*us-east-1*\:*012345678910*\:alias/*ExampleAlias*.
331
331
  #
332
332
  # * ARN using key ID. The ID ARN contains the `arn:aws:kms` namespace,
333
- # followed by the region of the CMK, the AWS account ID of the CMK
333
+ # followed by the Region of the CMK, the AWS account ID of the CMK
334
334
  # owner, the `key` namespace, and then the CMK ID. For example,
335
335
  # arn:aws:kms:*us-east-1*\:*012345678910*\:key/*abcd1234-a123-456a-a12b-a123b4cd56ef*.
336
336
  #
337
337
  # * ARN using key alias. The alias ARN contains the `arn:aws:kms`
338
- # namespace, followed by the region of the CMK, the AWS account ID of
338
+ # namespace, followed by the Region of the CMK, the AWS account ID of
339
339
  # the CMK owner, the `alias` namespace, and then the CMK alias. For
340
340
  # example,
341
341
  # arn:aws:kms:*us-east-1*\:*012345678910*\:alias/*ExampleAlias*.
@@ -438,11 +438,16 @@ module Aws::EC2
438
438
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/UserProvidedkernels.html
439
439
  # @option options [String] :key_name
440
440
  # The name of the key pair. You can create a key pair using
441
- # CreateKeyPair or ImportKeyPair.
441
+ # [CreateKeyPair][1] or [ImportKeyPair][2].
442
442
  #
443
443
  # If you do not specify a key pair, you can't connect to the instance
444
444
  # unless you choose an AMI that is configured to allow users another way
445
445
  # to log in.
446
+ #
447
+ #
448
+ #
449
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateKeyPair.html
450
+ # [2]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ImportKeyPair.html
446
451
  # @option options [required, Integer] :max_count
447
452
  # The maximum number of instances to launch. If you specify more
448
453
  # instances than Amazon EC2 can launch in the target Availability Zone,
@@ -489,18 +494,20 @@ module Aws::EC2
489
494
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/UserProvidedkernels.html
490
495
  # @option options [Array<String>] :security_group_ids
491
496
  # The IDs of the security groups. You can create a security group using
492
- # CreateSecurityGroup.
497
+ # [CreateSecurityGroup][1].
493
498
  #
494
- # Default: Amazon EC2 uses the default security group.
499
+ # If you specify a network interface, you must specify any security
500
+ # groups as part of the network interface.
495
501
  #
496
- # You cannot specify this option and the network interfaces option in
497
- # the same request.
502
+ #
503
+ #
504
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateSecurityGroup.html
498
505
  # @option options [Array<String>] :security_groups
499
506
  # \[EC2-Classic, default VPC\] The names of the security groups. For a
500
507
  # nondefault VPC, you must use security group IDs instead.
501
508
  #
502
- # You cannot specify this option and the network interfaces option in
503
- # the same request.
509
+ # If you specify a network interface, you must specify any security
510
+ # groups as part of the network interface.
504
511
  #
505
512
  # Default: Amazon EC2 uses the default security group.
506
513
  # @option options [String] :user_data
@@ -531,11 +538,15 @@ module Aws::EC2
531
538
  # If you set this parameter to `true`, you can't terminate the instance
532
539
  # using the Amazon EC2 console, CLI, or API; otherwise, you can. To
533
540
  # change this attribute to `false` after launch, use
534
- # ModifyInstanceAttribute. Alternatively, if you set
541
+ # [ModifyInstanceAttribute][1]. Alternatively, if you set
535
542
  # `InstanceInitiatedShutdownBehavior` to `terminate`, you can terminate
536
543
  # the instance by running the shutdown command from the instance.
537
544
  #
538
545
  # Default: `false`
546
+ #
547
+ #
548
+ #
549
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ModifyInstanceAttribute.html
539
550
  # @option options [Boolean] :dry_run
540
551
  # Checks whether you have the required permissions for the action,
541
552
  # without actually making the request, and provides an error response.
@@ -559,7 +570,9 @@ module Aws::EC2
559
570
  #
560
571
  # Default: `stop`
561
572
  # @option options [Array<Types::InstanceNetworkInterfaceSpecification>] :network_interfaces
562
- # The network interfaces to associate with the instance.
573
+ # The network interfaces to associate with the instance. If you specify
574
+ # a network interface, you must specify any security groups as part of
575
+ # the network interface.
563
576
  # @option options [String] :private_ip_address
564
577
  # \[EC2-VPC\] The primary IPv4 address. You must specify a value from
565
578
  # the IPv4 address range of the subnet.
@@ -591,7 +604,11 @@ module Aws::EC2
591
604
  # The tags to apply to the resources during launch. You can only tag
592
605
  # instances and volumes on launch. The specified tags are applied to all
593
606
  # instances or volumes that are created during launch. To tag a resource
594
- # after it has been created, see CreateTags.
607
+ # after it has been created, see [CreateTags][1].
608
+ #
609
+ #
610
+ #
611
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateTags.html
595
612
  # @option options [Types::LaunchTemplateSpecification] :launch_template
596
613
  # The launch template to use to launch the instances. Any parameters
597
614
  # that you specify in RunInstances override the same parameters in the
@@ -606,15 +623,16 @@ module Aws::EC2
606
623
  # @option options [Types::CreditSpecificationRequest] :credit_specification
607
624
  # The credit option for CPU usage of the T2 or T3 instance. Valid values
608
625
  # are `standard` and `unlimited`. To change this attribute after launch,
609
- # use ModifyInstanceCreditSpecification. For more information, see
610
- # [Burstable Performance Instances][1] in the *Amazon Elastic Compute
626
+ # use [ ModifyInstanceCreditSpecification][1]. For more information, see
627
+ # [Burstable Performance Instances][2] in the *Amazon Elastic Compute
611
628
  # Cloud User Guide*.
612
629
  #
613
630
  # Default: `standard` (T2 instances) or `unlimited` (T3 instances)
614
631
  #
615
632
  #
616
633
  #
617
- # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances.html
634
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ModifyInstanceCreditSpecification.html
635
+ # [2]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances.html
618
636
  # @option options [Types::CpuOptionsRequest] :cpu_options
619
637
  # The CPU options for the instance. For more information, see
620
638
  # [Optimizing CPU Options][1] in the *Amazon Elastic Compute Cloud User
@@ -722,11 +740,14 @@ module Aws::EC2
722
740
  # @option options [String] :interface_type
723
741
  # Indicates whether the network interface is an Elastic Fabric Adapter
724
742
  # (EFA). Only specify this parameter to create an EFA. For more
725
- # information, see [Elastic Fabric
726
- # Adapter](AWSEC2/latest/UserGuide/efa.html) in the *Amazon Elastic
743
+ # information, see [Elastic Fabric Adapter][1] in the *Amazon Elastic
727
744
  # Compute Cloud User Guide*.
728
745
  #
729
746
  # If you are not creating an EFA ENI, omit this parameter.
747
+ #
748
+ #
749
+ #
750
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/efa.html
730
751
  # @return [NetworkInterface]
731
752
  def create_network_interface(options = {})
732
753
  options = options.merge(subnet_id: @id)
@@ -1761,7 +1761,7 @@ module Aws::EC2
1761
1761
  # @return [Array<Types::AvailabilityZoneMessage>]
1762
1762
  #
1763
1763
  # @!attribute [rw] region_name
1764
- # The name of the region.
1764
+ # The name of the Region.
1765
1765
  # @return [String]
1766
1766
  #
1767
1767
  # @!attribute [rw] zone_name
@@ -3564,7 +3564,7 @@ module Aws::EC2
3564
3564
  # @return [String]
3565
3565
  #
3566
3566
  # @!attribute [rw] source_region
3567
- # The region that contains the source AFI.
3567
+ # The Region that contains the source AFI.
3568
3568
  # @return [String]
3569
3569
  #
3570
3570
  # @!attribute [rw] client_token
@@ -3627,7 +3627,7 @@ module Aws::EC2
3627
3627
  # @return [String]
3628
3628
  #
3629
3629
  # @!attribute [rw] description
3630
- # A description for the new AMI in the destination region.
3630
+ # A description for the new AMI in the destination Region.
3631
3631
  # @return [String]
3632
3632
  #
3633
3633
  # @!attribute [rw] encrypted
@@ -3656,17 +3656,17 @@ module Aws::EC2
3656
3656
  # * Key ID
3657
3657
  #
3658
3658
  # * Key alias. The alias ARN contains the `arn:aws:kms` namespace,
3659
- # followed by the region of the CMK, the AWS account ID of the CMK
3659
+ # followed by the Region of the CMK, the AWS account ID of the CMK
3660
3660
  # owner, the `alias` namespace, and then the CMK alias. For example,
3661
3661
  # arn:aws:kms:*us-east-1*\:*012345678910*\:alias/*ExampleAlias*.
3662
3662
  #
3663
3663
  # * ARN using key ID. The ID ARN contains the `arn:aws:kms` namespace,
3664
- # followed by the region of the CMK, the AWS account ID of the CMK
3664
+ # followed by the Region of the CMK, the AWS account ID of the CMK
3665
3665
  # owner, the `key` namespace, and then the CMK ID. For example,
3666
3666
  # arn:aws:kms:*us-east-1*\:*012345678910*\:key/*abcd1234-a123-456a-a12b-a123b4cd56ef*.
3667
3667
  #
3668
3668
  # * ARN using key alias. The alias ARN contains the `arn:aws:kms`
3669
- # namespace, followed by the region of the CMK, the AWS account ID
3669
+ # namespace, followed by the Region of the CMK, the AWS account ID
3670
3670
  # of the CMK owner, the `alias` namespace, and then the CMK alias.
3671
3671
  # For example,
3672
3672
  # arn:aws:kms:*us-east-1*\:*012345678910*\:alias/*ExampleAlias*.
@@ -3675,12 +3675,12 @@ module Aws::EC2
3675
3675
  # call may appear to complete even though you provided an invalid
3676
3676
  # identifier. This action will eventually report failure.
3677
3677
  #
3678
- # The specified CMK must exist in the region that the snapshot is
3678
+ # The specified CMK must exist in the Region that the snapshot is
3679
3679
  # being copied to.
3680
3680
  # @return [String]
3681
3681
  #
3682
3682
  # @!attribute [rw] name
3683
- # The name of the new AMI in the destination region.
3683
+ # The name of the new AMI in the destination Region.
3684
3684
  # @return [String]
3685
3685
  #
3686
3686
  # @!attribute [rw] source_image_id
@@ -3688,7 +3688,7 @@ module Aws::EC2
3688
3688
  # @return [String]
3689
3689
  #
3690
3690
  # @!attribute [rw] source_region
3691
- # The name of the region that contains the AMI to copy.
3691
+ # The name of the Region that contains the AMI to copy.
3692
3692
  # @return [String]
3693
3693
  #
3694
3694
  # @!attribute [rw] dry_run
@@ -3783,17 +3783,17 @@ module Aws::EC2
3783
3783
  # * Key ID
3784
3784
  #
3785
3785
  # * Key alias. The alias ARN contains the `arn:aws:kms` namespace,
3786
- # followed by the region of the CMK, the AWS account ID of the CMK
3786
+ # followed by the Region of the CMK, the AWS account ID of the CMK
3787
3787
  # owner, the `alias` namespace, and then the CMK alias. For example,
3788
3788
  # arn:aws:kms:*us-east-1*\:*012345678910*\:alias/*ExampleAlias*.
3789
3789
  #
3790
3790
  # * ARN using key ID. The ID ARN contains the `arn:aws:kms` namespace,
3791
- # followed by the region of the CMK, the AWS account ID of the CMK
3791
+ # followed by the Region of the CMK, the AWS account ID of the CMK
3792
3792
  # owner, the `key` namespace, and then the CMK ID. For example,
3793
3793
  # arn:aws:kms:*us-east-1*\:*012345678910*\:key/*abcd1234-a123-456a-a12b-a123b4cd56ef*.
3794
3794
  #
3795
3795
  # * ARN using key alias. The alias ARN contains the `arn:aws:kms`
3796
- # namespace, followed by the region of the CMK, the AWS account ID
3796
+ # namespace, followed by the Region of the CMK, the AWS account ID
3797
3797
  # of the CMK owner, the `alias` namespace, and then the CMK alias.
3798
3798
  # For example,
3799
3799
  # arn:aws:kms:*us-east-1*\:*012345678910*\:alias/*ExampleAlias*.
@@ -5986,11 +5986,14 @@ module Aws::EC2
5986
5986
  # @!attribute [rw] interface_type
5987
5987
  # Indicates whether the network interface is an Elastic Fabric Adapter
5988
5988
  # (EFA). Only specify this parameter to create an EFA. For more
5989
- # information, see [Elastic Fabric
5990
- # Adapter](AWSEC2/latest/UserGuide/efa.html) in the *Amazon Elastic
5989
+ # information, see [Elastic Fabric Adapter][1] in the *Amazon Elastic
5991
5990
  # Compute Cloud User Guide*.
5992
5991
  #
5993
5992
  # If you are not creating an EFA ENI, omit this parameter.
5993
+ #
5994
+ #
5995
+ #
5996
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/efa.html
5994
5997
  # @return [String]
5995
5998
  #
5996
5999
  # @!attribute [rw] subnet_id
@@ -6639,7 +6642,7 @@ module Aws::EC2
6639
6642
  # @return [String]
6640
6643
  #
6641
6644
  # @!attribute [rw] blackhole
6642
- # Indicates whether to drop traffic if the target isn't available.
6645
+ # Indicates whether to drop traffic that matches this route.
6643
6646
  # @return [Boolean]
6644
6647
  #
6645
6648
  # @!attribute [rw] dry_run
@@ -6970,17 +6973,17 @@ module Aws::EC2
6970
6973
  # * Key ID
6971
6974
  #
6972
6975
  # * Key alias. The alias ARN contains the `arn:aws:kms` namespace,
6973
- # followed by the region of the CMK, the AWS account ID of the CMK
6976
+ # followed by the Region of the CMK, the AWS account ID of the CMK
6974
6977
  # owner, the `alias` namespace, and then the CMK alias. For example,
6975
6978
  # arn:aws:kms:*us-east-1*\:*012345678910*\:alias/*ExampleAlias*.
6976
6979
  #
6977
6980
  # * ARN using key ID. The ID ARN contains the `arn:aws:kms` namespace,
6978
- # followed by the region of the CMK, the AWS account ID of the CMK
6981
+ # followed by the Region of the CMK, the AWS account ID of the CMK
6979
6982
  # owner, the `key` namespace, and then the CMK ID. For example,
6980
6983
  # arn:aws:kms:*us-east-1*\:*012345678910*\:key/*abcd1234-a123-456a-a12b-a123b4cd56ef*.
6981
6984
  #
6982
6985
  # * ARN using key alias. The alias ARN contains the `arn:aws:kms`
6983
- # namespace, followed by the region of the CMK, the AWS account ID
6986
+ # namespace, followed by the Region of the CMK, the AWS account ID
6984
6987
  # of the CMK owner, the `alias` namespace, and then the CMK alias.
6985
6988
  # For example,
6986
6989
  # arn:aws:kms:*us-east-1*\:*012345678910*\:alias/*ExampleAlias*.
@@ -7203,7 +7206,7 @@ module Aws::EC2
7203
7206
  # (Interface endpoint) Indicate whether to associate a private hosted
7204
7207
  # zone with the specified VPC. The private hosted zone contains a
7205
7208
  # record set for the default public DNS name for the service for the
7206
- # region (for example, `kinesis.us-east-1.amazonaws.com`) which
7209
+ # Region (for example, `kinesis.us-east-1.amazonaws.com`) which
7207
7210
  # resolves to the private IP addresses of the endpoint network
7208
7211
  # interfaces in the VPC. This enables you to make requests to the
7209
7212
  # default public DNS name for the service instead of the public DNS
@@ -7351,10 +7354,10 @@ module Aws::EC2
7351
7354
  # @return [String]
7352
7355
  #
7353
7356
  # @!attribute [rw] peer_region
7354
- # The region code for the accepter VPC, if the accepter VPC is located
7355
- # in a region other than the region in which you make the request.
7357
+ # The Region code for the accepter VPC, if the accepter VPC is located
7358
+ # in a Region other than the Region in which you make the request.
7356
7359
  #
7357
- # Default: The region in which you make the request.
7360
+ # Default: The Region in which you make the request.
7358
7361
  # @return [String]
7359
7362
  #
7360
7363
  # @see http://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/CreateVpcPeeringConnectionRequest AWS API Documentation
@@ -9369,9 +9372,9 @@ module Aws::EC2
9369
9372
  end
9370
9373
 
9371
9374
  # @!attribute [rw] use_long_ids_aggregated
9372
- # Indicates whether all resource types in the region are configured to
9375
+ # Indicates whether all resource types in the Region are configured to
9373
9376
  # use longer IDs. This value is only `true` if all users are
9374
- # configured to use longer IDs for all resources types in the region.
9377
+ # configured to use longer IDs for all resources types in the Region.
9375
9378
  # @return [Boolean]
9376
9379
  #
9377
9380
  # @!attribute [rw] statuses
@@ -9406,7 +9409,7 @@ module Aws::EC2
9406
9409
  #
9407
9410
  # * `message` - Information about the Availability Zone.
9408
9411
  #
9409
- # * `region-name` - The name of the region for the Availability Zone
9412
+ # * `region-name` - The name of the Region for the Availability Zone
9410
9413
  # (for example, `us-east-1`).
9411
9414
  #
9412
9415
  # * `state` - The state of the Availability Zone (`available` \|
@@ -10227,6 +10230,8 @@ module Aws::EC2
10227
10230
  # },
10228
10231
  # ],
10229
10232
  # dry_run: false,
10233
+ # next_token: "String",
10234
+ # max_results: 1,
10230
10235
  # }
10231
10236
  #
10232
10237
  # @!attribute [rw] dhcp_options_ids
@@ -10266,12 +10271,24 @@ module Aws::EC2
10266
10271
  # `DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.
10267
10272
  # @return [Boolean]
10268
10273
  #
10274
+ # @!attribute [rw] next_token
10275
+ # The token for the next page of results.
10276
+ # @return [String]
10277
+ #
10278
+ # @!attribute [rw] max_results
10279
+ # The maximum number of results to return with a single call. To
10280
+ # retrieve the remaining results, make another call with the returned
10281
+ # `nextToken` value.
10282
+ # @return [Integer]
10283
+ #
10269
10284
  # @see http://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/DescribeDhcpOptionsRequest AWS API Documentation
10270
10285
  #
10271
10286
  class DescribeDhcpOptionsRequest < Struct.new(
10272
10287
  :dhcp_options_ids,
10273
10288
  :filters,
10274
- :dry_run)
10289
+ :dry_run,
10290
+ :next_token,
10291
+ :max_results)
10275
10292
  include Aws::Structure
10276
10293
  end
10277
10294
 
@@ -10279,10 +10296,16 @@ module Aws::EC2
10279
10296
  # Information about one or more DHCP options sets.
10280
10297
  # @return [Array<Types::DhcpOptions>]
10281
10298
  #
10299
+ # @!attribute [rw] next_token
10300
+ # The token to use to retrieve the next page of results. This value is
10301
+ # `null` when there are no more results to return.
10302
+ # @return [String]
10303
+ #
10282
10304
  # @see http://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/DescribeDhcpOptionsResult AWS API Documentation
10283
10305
  #
10284
10306
  class DescribeDhcpOptionsResult < Struct.new(
10285
- :dhcp_options)
10307
+ :dhcp_options,
10308
+ :next_token)
10286
10309
  include Aws::Structure
10287
10310
  end
10288
10311
 
@@ -13603,14 +13626,14 @@ module Aws::EC2
13603
13626
  # @!attribute [rw] filters
13604
13627
  # The filters.
13605
13628
  #
13606
- # * `endpoint` - The endpoint of the region (for example,
13629
+ # * `endpoint` - The endpoint of the Region (for example,
13607
13630
  # `ec2.us-east-1.amazonaws.com`).
13608
13631
  #
13609
- # * `region-name` - The name of the region (for example, `us-east-1`).
13632
+ # * `region-name` - The name of the Region (for example, `us-east-1`).
13610
13633
  # @return [Array<Types::Filter>]
13611
13634
  #
13612
13635
  # @!attribute [rw] region_names
13613
- # The names of the regions.
13636
+ # The names of the Regions.
13614
13637
  # @return [Array<String>]
13615
13638
  #
13616
13639
  # @!attribute [rw] dry_run
@@ -13630,7 +13653,7 @@ module Aws::EC2
13630
13653
  end
13631
13654
 
13632
13655
  # @!attribute [rw] regions
13633
- # Information about the regions.
13656
+ # Information about the Regions.
13634
13657
  # @return [Array<Types::Region>]
13635
13658
  #
13636
13659
  # @see http://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/DescribeRegionsResult AWS API Documentation
@@ -15518,6 +15541,8 @@ module Aws::EC2
15518
15541
  # ],
15519
15542
  # subnet_ids: ["String"],
15520
15543
  # dry_run: false,
15544
+ # next_token: "String",
15545
+ # max_results: 1,
15521
15546
  # }
15522
15547
  #
15523
15548
  # @!attribute [rw] filters
@@ -15584,12 +15609,24 @@ module Aws::EC2
15584
15609
  # `DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.
15585
15610
  # @return [Boolean]
15586
15611
  #
15612
+ # @!attribute [rw] next_token
15613
+ # The token for the next page of results.
15614
+ # @return [String]
15615
+ #
15616
+ # @!attribute [rw] max_results
15617
+ # The maximum number of results to return with a single call. To
15618
+ # retrieve the remaining results, make another call with the returned
15619
+ # `nextToken` value.
15620
+ # @return [Integer]
15621
+ #
15587
15622
  # @see http://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/DescribeSubnetsRequest AWS API Documentation
15588
15623
  #
15589
15624
  class DescribeSubnetsRequest < Struct.new(
15590
15625
  :filters,
15591
15626
  :subnet_ids,
15592
- :dry_run)
15627
+ :dry_run,
15628
+ :next_token,
15629
+ :max_results)
15593
15630
  include Aws::Structure
15594
15631
  end
15595
15632
 
@@ -15597,10 +15634,16 @@ module Aws::EC2
15597
15634
  # Information about one or more subnets.
15598
15635
  # @return [Array<Types::Subnet>]
15599
15636
  #
15637
+ # @!attribute [rw] next_token
15638
+ # The token to use to retrieve the next page of results. This value is
15639
+ # `null` when there are no more results to return.
15640
+ # @return [String]
15641
+ #
15600
15642
  # @see http://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/DescribeSubnetsResult AWS API Documentation
15601
15643
  #
15602
15644
  class DescribeSubnetsResult < Struct.new(
15603
- :subnets)
15645
+ :subnets,
15646
+ :next_token)
15604
15647
  include Aws::Structure
15605
15648
  end
15606
15649
 
@@ -21393,17 +21436,17 @@ module Aws::EC2
21393
21436
  # * Key ID
21394
21437
  #
21395
21438
  # * Key alias. The alias ARN contains the `arn:aws:kms` namespace,
21396
- # followed by the region of the CMK, the AWS account ID of the CMK
21439
+ # followed by the Region of the CMK, the AWS account ID of the CMK
21397
21440
  # owner, the `alias` namespace, and then the CMK alias. For example,
21398
21441
  # arn:aws:kms:*us-east-1*\:*012345678910*\:alias/*ExampleAlias*.
21399
21442
  #
21400
21443
  # * ARN using key ID. The ID ARN contains the `arn:aws:kms` namespace,
21401
- # followed by the region of the CMK, the AWS account ID of the CMK
21444
+ # followed by the Region of the CMK, the AWS account ID of the CMK
21402
21445
  # owner, the `key` namespace, and then the CMK ID. For example,
21403
21446
  # arn:aws:kms:*us-east-1*\:*012345678910*\:key/*abcd1234-a123-456a-a12b-a123b4cd56ef*.
21404
21447
  #
21405
21448
  # * ARN using key alias. The alias ARN contains the `arn:aws:kms`
21406
- # namespace, followed by the region of the CMK, the AWS account ID
21449
+ # namespace, followed by the Region of the CMK, the AWS account ID
21407
21450
  # of the CMK owner, the `alias` namespace, and then the CMK alias.
21408
21451
  # For example,
21409
21452
  # arn:aws:kms:*us-east-1*\:*012345678910*\:alias/*ExampleAlias*.
@@ -21412,7 +21455,7 @@ module Aws::EC2
21412
21455
  # call may appear to complete even though you provided an invalid
21413
21456
  # identifier. This action will eventually report failure.
21414
21457
  #
21415
- # The specified CMK must exist in the region that the AMI is being
21458
+ # The specified CMK must exist in the Region that the AMI is being
21416
21459
  # copied to.
21417
21460
  # @return [String]
21418
21461
  #
@@ -22015,17 +22058,17 @@ module Aws::EC2
22015
22058
  # * Key ID
22016
22059
  #
22017
22060
  # * Key alias. The alias ARN contains the `arn:aws:kms` namespace,
22018
- # followed by the region of the CMK, the AWS account ID of the CMK
22061
+ # followed by the Region of the CMK, the AWS account ID of the CMK
22019
22062
  # owner, the `alias` namespace, and then the CMK alias. For example,
22020
22063
  # arn:aws:kms:*us-east-1*\:*012345678910*\:alias/*ExampleAlias*.
22021
22064
  #
22022
22065
  # * ARN using key ID. The ID ARN contains the `arn:aws:kms` namespace,
22023
- # followed by the region of the CMK, the AWS account ID of the CMK
22066
+ # followed by the Region of the CMK, the AWS account ID of the CMK
22024
22067
  # owner, the `key` namespace, and then the CMK ID. For example,
22025
22068
  # arn:aws:kms:*us-east-1*\:*012345678910*\:key/*abcd1234-a123-456a-a12b-a123b4cd56ef*.
22026
22069
  #
22027
22070
  # * ARN using key alias. The alias ARN contains the `arn:aws:kms`
22028
- # namespace, followed by the region of the CMK, the AWS account ID
22071
+ # namespace, followed by the Region of the CMK, the AWS account ID
22029
22072
  # of the CMK owner, the `alias` namespace, and then the CMK alias.
22030
22073
  # For example,
22031
22074
  # arn:aws:kms:*us-east-1*\:*012345678910*\:alias/*ExampleAlias*.
@@ -22034,7 +22077,7 @@ module Aws::EC2
22034
22077
  # call may appear to complete even though you provided an invalid
22035
22078
  # identifier. This action will eventually report failure.
22036
22079
  #
22037
- # The specified CMK must exist in the region that the snapshot is
22080
+ # The specified CMK must exist in the Region that the snapshot is
22038
22081
  # being copied to.
22039
22082
  # @return [String]
22040
22083
  #
@@ -23019,9 +23062,11 @@ module Aws::EC2
23019
23062
  # @return [String]
23020
23063
  #
23021
23064
  # @!attribute [rw] device_index
23022
- # The index of the device on the instance for the network interface
23023
- # attachment. If you are specifying a network interface in a
23024
- # RunInstances request, you must provide the device index.
23065
+ # The position of the network interface in the attachment order. A
23066
+ # primary network interface has a device index of 0.
23067
+ #
23068
+ # If you specify a network interface when launching an instance, you
23069
+ # must specify the device index.
23025
23070
  # @return [Integer]
23026
23071
  #
23027
23072
  # @!attribute [rw] groups
@@ -23052,21 +23097,34 @@ module Aws::EC2
23052
23097
  # The private IPv4 address of the network interface. Applies only if
23053
23098
  # creating a network interface when launching an instance. You cannot
23054
23099
  # specify this option if you're launching more than one instance in a
23055
- # RunInstances request.
23100
+ # [RunInstances][1] request.
23101
+ #
23102
+ #
23103
+ #
23104
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RunInstances.html
23056
23105
  # @return [String]
23057
23106
  #
23058
23107
  # @!attribute [rw] private_ip_addresses
23059
23108
  # One or more private IPv4 addresses to assign to the network
23060
23109
  # interface. Only one private IPv4 address can be designated as
23061
23110
  # primary. You cannot specify this option if you're launching more
23062
- # than one instance in a RunInstances request.
23111
+ # than one instance in a [RunInstances][1] request.
23112
+ #
23113
+ #
23114
+ #
23115
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RunInstances.html
23063
23116
  # @return [Array<Types::PrivateIpAddressSpecification>]
23064
23117
  #
23065
23118
  # @!attribute [rw] secondary_private_ip_address_count
23066
23119
  # The number of secondary private IPv4 addresses. You can't specify
23067
23120
  # this option and specify more than one private IP address using the
23068
23121
  # private IP addresses option. You cannot specify this option if
23069
- # you're launching more than one instance in a RunInstances request.
23122
+ # you're launching more than one instance in a [RunInstances][1]
23123
+ # request.
23124
+ #
23125
+ #
23126
+ #
23127
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RunInstances.html
23070
23128
  # @return [Integer]
23071
23129
  #
23072
23130
  # @!attribute [rw] subnet_id
@@ -24874,7 +24932,11 @@ module Aws::EC2
24874
24932
  # @!attribute [rw] resource_type
24875
24933
  # The type of resource to tag. Currently, the resource types that
24876
24934
  # support tagging on creation are `instance` and `volume`. To tag a
24877
- # resource after it has been created, see CreateTags.
24935
+ # resource after it has been created, see [CreateTags][1].
24936
+ #
24937
+ #
24938
+ #
24939
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateTags.html
24878
24940
  # @return [String]
24879
24941
  #
24880
24942
  # @!attribute [rw] tags
@@ -27090,15 +27152,23 @@ module Aws::EC2
27090
27152
  # }
27091
27153
  #
27092
27154
  # @!attribute [rw] vpn_connection_id
27155
+ # The ID of the VPN connection.
27093
27156
  # @return [String]
27094
27157
  #
27095
27158
  # @!attribute [rw] transit_gateway_id
27159
+ # The ID of the transit gateway.
27096
27160
  # @return [String]
27097
27161
  #
27098
27162
  # @!attribute [rw] vpn_gateway_id
27163
+ # The ID of the virtual private gateway at the AWS side of the VPN
27164
+ # connection.
27099
27165
  # @return [String]
27100
27166
  #
27101
27167
  # @!attribute [rw] dry_run
27168
+ # Checks whether you have the required permissions for the action,
27169
+ # without actually making the request, and provides an error response.
27170
+ # If you have the required permissions, the error response is
27171
+ # `DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.
27102
27172
  # @return [Boolean]
27103
27173
  #
27104
27174
  # @see http://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/ModifyVpnConnectionRequest AWS API Documentation
@@ -28031,7 +28101,7 @@ module Aws::EC2
28031
28101
  # The Availability Zone of the instance.
28032
28102
  #
28033
28103
  # If not specified, an Availability Zone will be automatically chosen
28034
- # for you based on the load balancing criteria for the region.
28104
+ # for you based on the load balancing criteria for the Region.
28035
28105
  # @return [String]
28036
28106
  #
28037
28107
  # @!attribute [rw] affinity
@@ -28056,8 +28126,12 @@ module Aws::EC2
28056
28126
  # @!attribute [rw] tenancy
28057
28127
  # The tenancy of the instance (if the instance is running in a VPC).
28058
28128
  # An instance with a tenancy of `dedicated` runs on single-tenant
28059
- # hardware. The `host` tenancy is not supported for the ImportInstance
28060
- # command.
28129
+ # hardware. The `host` tenancy is not supported for the
28130
+ # [ImportInstance][1] command.
28131
+ #
28132
+ #
28133
+ #
28134
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ImportInstance.html
28061
28135
  # @return [String]
28062
28136
  #
28063
28137
  # @!attribute [rw] spread_domain
@@ -28385,7 +28459,7 @@ module Aws::EC2
28385
28459
  # The public IPv4 address range, in CIDR notation. The most specific
28386
28460
  # prefix that you can specify is /24. The address range cannot overlap
28387
28461
  # with another address range that you've brought to this or another
28388
- # region.
28462
+ # Region.
28389
28463
  # @return [String]
28390
28464
  #
28391
28465
  # @!attribute [rw] cidr_authorization_context
@@ -28893,14 +28967,14 @@ module Aws::EC2
28893
28967
  include Aws::Structure
28894
28968
  end
28895
28969
 
28896
- # Describes a region.
28970
+ # Describes a Region.
28897
28971
  #
28898
28972
  # @!attribute [rw] endpoint
28899
- # The region service endpoint.
28973
+ # The Region service endpoint.
28900
28974
  # @return [String]
28901
28975
  #
28902
28976
  # @!attribute [rw] region_name
28903
- # The name of the region.
28977
+ # The name of the Region.
28904
28978
  # @return [String]
28905
28979
  #
28906
28980
  # @see http://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/Region AWS API Documentation
@@ -29859,7 +29933,9 @@ module Aws::EC2
29859
29933
  # @return [Array<Types::LaunchTemplateBlockDeviceMappingRequest>]
29860
29934
  #
29861
29935
  # @!attribute [rw] network_interfaces
29862
- # One or more network interfaces.
29936
+ # One or more network interfaces. If you specify a network interface,
29937
+ # you must specify any security groups as part of the network
29938
+ # interface.
29863
29939
  # @return [Array<Types::LaunchTemplateInstanceNetworkInterfaceSpecificationRequest>]
29864
29940
  #
29865
29941
  # @!attribute [rw] image_id
@@ -29946,7 +30022,11 @@ module Aws::EC2
29946
30022
  # The tags to apply to the resources during launch. You can only tag
29947
30023
  # instances and volumes on launch. The specified tags are applied to
29948
30024
  # all instances or volumes that are created during launch. To tag a
29949
- # resource after it has been created, see CreateTags.
30025
+ # resource after it has been created, see [CreateTags][1].
30026
+ #
30027
+ #
30028
+ #
30029
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateTags.html
29950
30030
  # @return [Array<Types::LaunchTemplateTagSpecificationRequest>]
29951
30031
  #
29952
30032
  # @!attribute [rw] elastic_gpu_specifications
@@ -29959,8 +30039,12 @@ module Aws::EC2
29959
30039
  #
29960
30040
  # @!attribute [rw] security_group_ids
29961
30041
  # One or more security group IDs. You can create a security group
29962
- # using CreateSecurityGroup. You cannot specify both a security group
29963
- # ID and security name in the same request.
30042
+ # using [CreateSecurityGroup][1]. You cannot specify both a security
30043
+ # group ID and security name in the same request.
30044
+ #
30045
+ #
30046
+ #
30047
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateSecurityGroup.html
29964
30048
  # @return [Array<String>]
29965
30049
  #
29966
30050
  # @!attribute [rw] security_groups
@@ -30870,7 +30954,7 @@ module Aws::EC2
30870
30954
  # @return [String]
30871
30955
  #
30872
30956
  # @!attribute [rw] scope
30873
- # Whether the Reserved Instance is applied to instances in a region or
30957
+ # Whether the Reserved Instance is applied to instances in a Region or
30874
30958
  # instances in a specific Availability Zone.
30875
30959
  # @return [String]
30876
30960
  #
@@ -31111,7 +31195,7 @@ module Aws::EC2
31111
31195
  # @return [Array<Types::RecurringCharge>]
31112
31196
  #
31113
31197
  # @!attribute [rw] scope
31114
- # Whether the Reserved Instance is applied to instances in a region or
31198
+ # Whether the Reserved Instance is applied to instances in a Region or
31115
31199
  # an Availability Zone.
31116
31200
  # @return [String]
31117
31201
  #
@@ -32221,11 +32305,16 @@ module Aws::EC2
32221
32305
  #
32222
32306
  # @!attribute [rw] key_name
32223
32307
  # The name of the key pair. You can create a key pair using
32224
- # CreateKeyPair or ImportKeyPair.
32308
+ # [CreateKeyPair][1] or [ImportKeyPair][2].
32225
32309
  #
32226
32310
  # If you do not specify a key pair, you can't connect to the instance
32227
32311
  # unless you choose an AMI that is configured to allow users another
32228
32312
  # way to log in.
32313
+ #
32314
+ #
32315
+ #
32316
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateKeyPair.html
32317
+ # [2]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ImportKeyPair.html
32229
32318
  # @return [String]
32230
32319
  #
32231
32320
  # @!attribute [rw] max_count
@@ -32285,20 +32374,22 @@ module Aws::EC2
32285
32374
  #
32286
32375
  # @!attribute [rw] security_group_ids
32287
32376
  # The IDs of the security groups. You can create a security group
32288
- # using CreateSecurityGroup.
32377
+ # using [CreateSecurityGroup][1].
32289
32378
  #
32290
- # Default: Amazon EC2 uses the default security group.
32379
+ # If you specify a network interface, you must specify any security
32380
+ # groups as part of the network interface.
32291
32381
  #
32292
- # You cannot specify this option and the network interfaces option in
32293
- # the same request.
32382
+ #
32383
+ #
32384
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateSecurityGroup.html
32294
32385
  # @return [Array<String>]
32295
32386
  #
32296
32387
  # @!attribute [rw] security_groups
32297
32388
  # \[EC2-Classic, default VPC\] The names of the security groups. For a
32298
32389
  # nondefault VPC, you must use security group IDs instead.
32299
32390
  #
32300
- # You cannot specify this option and the network interfaces option in
32301
- # the same request.
32391
+ # If you specify a network interface, you must specify any security
32392
+ # groups as part of the network interface.
32302
32393
  #
32303
32394
  # Default: Amazon EC2 uses the default security group.
32304
32395
  # @return [Array<String>]
@@ -32344,12 +32435,16 @@ module Aws::EC2
32344
32435
  # If you set this parameter to `true`, you can't terminate the
32345
32436
  # instance using the Amazon EC2 console, CLI, or API; otherwise, you
32346
32437
  # can. To change this attribute to `false` after launch, use
32347
- # ModifyInstanceAttribute. Alternatively, if you set
32438
+ # [ModifyInstanceAttribute][1]. Alternatively, if you set
32348
32439
  # `InstanceInitiatedShutdownBehavior` to `terminate`, you can
32349
32440
  # terminate the instance by running the shutdown command from the
32350
32441
  # instance.
32351
32442
  #
32352
32443
  # Default: `false`
32444
+ #
32445
+ #
32446
+ #
32447
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ModifyInstanceAttribute.html
32353
32448
  # @return [Boolean]
32354
32449
  #
32355
32450
  # @!attribute [rw] dry_run
@@ -32383,7 +32478,9 @@ module Aws::EC2
32383
32478
  # @return [String]
32384
32479
  #
32385
32480
  # @!attribute [rw] network_interfaces
32386
- # The network interfaces to associate with the instance.
32481
+ # The network interfaces to associate with the instance. If you
32482
+ # specify a network interface, you must specify any security groups as
32483
+ # part of the network interface.
32387
32484
  # @return [Array<Types::InstanceNetworkInterfaceSpecification>]
32388
32485
  #
32389
32486
  # @!attribute [rw] private_ip_address
@@ -32423,7 +32520,11 @@ module Aws::EC2
32423
32520
  # The tags to apply to the resources during launch. You can only tag
32424
32521
  # instances and volumes on launch. The specified tags are applied to
32425
32522
  # all instances or volumes that are created during launch. To tag a
32426
- # resource after it has been created, see CreateTags.
32523
+ # resource after it has been created, see [CreateTags][1].
32524
+ #
32525
+ #
32526
+ #
32527
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateTags.html
32427
32528
  # @return [Array<Types::TagSpecification>]
32428
32529
  #
32429
32530
  # @!attribute [rw] launch_template
@@ -32444,15 +32545,16 @@ module Aws::EC2
32444
32545
  # @!attribute [rw] credit_specification
32445
32546
  # The credit option for CPU usage of the T2 or T3 instance. Valid
32446
32547
  # values are `standard` and `unlimited`. To change this attribute
32447
- # after launch, use ModifyInstanceCreditSpecification. For more
32448
- # information, see [Burstable Performance Instances][1] in the *Amazon
32548
+ # after launch, use [ ModifyInstanceCreditSpecification][1]. For more
32549
+ # information, see [Burstable Performance Instances][2] in the *Amazon
32449
32550
  # Elastic Compute Cloud User Guide*.
32450
32551
  #
32451
32552
  # Default: `standard` (T2 instances) or `unlimited` (T3 instances)
32452
32553
  #
32453
32554
  #
32454
32555
  #
32455
- # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances.html
32556
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ModifyInstanceCreditSpecification.html
32557
+ # [2]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances.html
32456
32558
  # @return [Types::CreditSpecificationRequest]
32457
32559
  #
32458
32560
  # @!attribute [rw] cpu_options
@@ -34140,7 +34242,14 @@ module Aws::EC2
34140
34242
  include Aws::Structure
34141
34243
  end
34142
34244
 
34143
- # Describes the launch specification for one or more Spot Instances.
34245
+ # Describes the launch specification for one or more Spot Instances. If
34246
+ # you include On-Demand capacity in your fleet request, you can't use
34247
+ # `SpotFleetLaunchSpecification`; you must use
34248
+ # [LaunchTemplateConfig][1].
34249
+ #
34250
+ #
34251
+ #
34252
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_LaunchTemplateConfig.html
34144
34253
  #
34145
34254
  # @note When making an API call, you may pass SpotFleetLaunchSpecification
34146
34255
  # data as a hash:
@@ -34242,11 +34351,11 @@ module Aws::EC2
34242
34351
  # @return [String]
34243
34352
  #
34244
34353
  # @!attribute [rw] block_device_mappings
34245
- # One or more block device mapping entries. You can't specify both a
34246
- # snapshot ID and an encryption value. This is because only blank
34247
- # volumes can be encrypted on creation. If a snapshot is the basis for
34248
- # a volume, it is not blank and its encryption status is used for the
34249
- # volume encryption status.
34354
+ # One or more block devices that are mapped to the Spot instances. You
34355
+ # can't specify both a snapshot ID and an encryption value. This is
34356
+ # because only blank volumes can be encrypted on creation. If a
34357
+ # snapshot is the basis for a volume, it is not blank and its
34358
+ # encryption status is used for the volume encryption status.
34250
34359
  # @return [Array<Types::BlockDeviceMapping>]
34251
34360
  #
34252
34361
  # @!attribute [rw] ebs_optimized
@@ -34295,7 +34404,10 @@ module Aws::EC2
34295
34404
  # @return [Types::SpotPlacement]
34296
34405
  #
34297
34406
  # @!attribute [rw] ramdisk_id
34298
- # The ID of the RAM disk.
34407
+ # The ID of the RAM disk. Some kernels require additional drivers at
34408
+ # launch. Check the kernel requirements for information about whether
34409
+ # you need to specify a RAM disk. To find kernel requirements, refer
34410
+ # to the AWS Resource Center and search for the kernel ID.
34299
34411
  # @return [String]
34300
34412
  #
34301
34413
  # @!attribute [rw] spot_price
@@ -34312,18 +34424,18 @@ module Aws::EC2
34312
34424
  # @return [String]
34313
34425
  #
34314
34426
  # @!attribute [rw] user_data
34315
- # The Base64-encoded user data to make available to the instances.
34427
+ # The Base64-encoded user data that instances use when starting up.
34316
34428
  # @return [String]
34317
34429
  #
34318
34430
  # @!attribute [rw] weighted_capacity
34319
34431
  # The number of units provided by the specified instance type. These
34320
34432
  # are the same units that you chose to set the target capacity in
34321
- # terms (instances or a performance characteristic such as vCPUs,
34322
- # memory, or I/O).
34433
+ # terms of instances, or a performance characteristic such as vCPUs,
34434
+ # memory, or I/O.
34323
34435
  #
34324
34436
  # If the target capacity divided by this value is not a whole number,
34325
- # we round the number of instances to the next whole number. If this
34326
- # value is not specified, the default is 1.
34437
+ # Amazon EC2 rounds the number of instances to the next whole number.
34438
+ # If this value is not specified, the default is 1.
34327
34439
  # @return [Float]
34328
34440
  #
34329
34441
  # @!attribute [rw] tag_specifications
@@ -34586,8 +34698,8 @@ module Aws::EC2
34586
34698
  # @return [String]
34587
34699
  #
34588
34700
  # @!attribute [rw] excess_capacity_termination_policy
34589
- # Indicates whether running Spot Instances should be terminated if the
34590
- # target capacity of the Spot Fleet request is decreased below the
34701
+ # Indicates whether running Spot Instances should be terminated if you
34702
+ # decrease the target capacity of the Spot Fleet request below the
34591
34703
  # current size of the Spot Fleet.
34592
34704
  # @return [String]
34593
34705
  #
@@ -34602,20 +34714,32 @@ module Aws::EC2
34602
34714
  # @return [Float]
34603
34715
  #
34604
34716
  # @!attribute [rw] iam_fleet_role
34605
- # Grants the Spot Fleet permission to terminate Spot Instances on your
34606
- # behalf when you cancel its Spot Fleet request using
34607
- # CancelSpotFleetRequests or when the Spot Fleet request expires, if
34608
- # you set `terminateInstancesWithExpiration`.
34717
+ # The Amazon Resource Name (ARN) of an AWS Identity and Access
34718
+ # Management (IAM) role that grants the Spot Fleet the permission to
34719
+ # request, launch, terminate, and tag instances on your behalf. For
34720
+ # more information, see [Spot Fleet Prerequisites][1] in the *Amazon
34721
+ # EC2 User Guide for Linux Instances*. Spot Fleet can terminate Spot
34722
+ # Instances on your behalf when you cancel its Spot Fleet request
34723
+ # using CancelSpotFleetRequests or when the Spot Fleet request
34724
+ # expires, if you set `TerminateInstancesWithExpiration`.
34725
+ #
34726
+ #
34727
+ #
34728
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-fleet-requests.html#spot-fleet-prerequisites
34609
34729
  # @return [String]
34610
34730
  #
34611
34731
  # @!attribute [rw] launch_specifications
34612
34732
  # The launch specifications for the Spot Fleet request. If you specify
34613
34733
  # `LaunchSpecifications`, you can't specify `LaunchTemplateConfigs`.
34734
+ # If you include On-Demand capacity in your request, you must use
34735
+ # `LaunchTemplateConfigs`.
34614
34736
  # @return [Array<Types::SpotFleetLaunchSpecification>]
34615
34737
  #
34616
34738
  # @!attribute [rw] launch_template_configs
34617
34739
  # The launch template and overrides. If you specify
34618
34740
  # `LaunchTemplateConfigs`, you can't specify `LaunchSpecifications`.
34741
+ # If you include On-Demand capacity in your request, you must use
34742
+ # `LaunchTemplateConfigs`.
34619
34743
  # @return [Array<Types::LaunchTemplateConfig>]
34620
34744
  #
34621
34745
  # @!attribute [rw] spot_price
@@ -34624,11 +34748,11 @@ module Aws::EC2
34624
34748
  # @return [String]
34625
34749
  #
34626
34750
  # @!attribute [rw] target_capacity
34627
- # The number of units to request. You can choose to set the target
34628
- # capacity in terms of instances or a performance characteristic that
34629
- # is important to your application workload, such as vCPUs, memory, or
34630
- # I/O. If the request type is `maintain`, you can specify a target
34631
- # capacity of 0 and add capacity later.
34751
+ # The number of units to request for the Spot Fleet. You can choose to
34752
+ # set the target capacity in terms of instances or a performance
34753
+ # characteristic that is important to your application workload, such
34754
+ # as vCPUs, memory, or I/O. If the request type is `maintain`, you can
34755
+ # specify a target capacity of 0 and add capacity later.
34632
34756
  # @return [Integer]
34633
34757
  #
34634
34758
  # @!attribute [rw] on_demand_target_capacity
@@ -34640,8 +34764,8 @@ module Aws::EC2
34640
34764
  # @return [Integer]
34641
34765
  #
34642
34766
  # @!attribute [rw] terminate_instances_with_expiration
34643
- # Indicates whether running Spot Instances should be terminated when
34644
- # the Spot Fleet request expires.
34767
+ # Indicates whether running Spot Instances are terminated when the
34768
+ # Spot Fleet request expires.
34645
34769
  # @return [Boolean]
34646
34770
  #
34647
34771
  # @!attribute [rw] type
@@ -34658,17 +34782,17 @@ module Aws::EC2
34658
34782
  # @return [String]
34659
34783
  #
34660
34784
  # @!attribute [rw] valid_from
34661
- # The start date and time of the request, in UTC format (for example,
34662
- # *YYYY*-*MM*-*DD*T*HH*\:*MM*\:*SS*Z). The default is to start
34785
+ # The start date and time of the request, in UTC format
34786
+ # (*YYYY*-*MM*-*DD*T*HH*\:*MM*\:*SS*Z). By default, Amazon EC2 starts
34663
34787
  # fulfilling the request immediately.
34664
34788
  # @return [Time]
34665
34789
  #
34666
34790
  # @!attribute [rw] valid_until
34667
- # The end date and time of the request, in UTC format (for example,
34668
- # *YYYY*-*MM*-*DD*T*HH*\:*MM*\:*SS*Z). At this point, no new Spot
34669
- # Instance requests are placed or able to fulfill the request. If no
34670
- # value is specified, the Spot Fleet request remains until you cancel
34671
- # it.
34791
+ # The end date and time of the request, in UTC format
34792
+ # (*YYYY*-*MM*-*DD*T*HH*\:*MM*\:*SS*Z). After the end date and time,
34793
+ # no new Spot Instance requests are placed or able to fulfill the
34794
+ # request. If no value is specified, the Spot Fleet request remains
34795
+ # until you cancel it.
34672
34796
  # @return [Time]
34673
34797
  #
34674
34798
  # @!attribute [rw] replace_unhealthy_instances
@@ -37884,7 +38008,7 @@ module Aws::EC2
37884
38008
  # @return [String]
37885
38009
  #
37886
38010
  # @!attribute [rw] region
37887
- # The region in which the VPC is located.
38011
+ # The Region in which the VPC is located.
37888
38012
  # @return [String]
37889
38013
  #
37890
38014
  # @see http://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/VpcPeeringConnectionVpcInfo AWS API Documentation