aws-sdk-ec2 1.536.0 → 1.542.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -4846,6 +4846,81 @@ module Aws::EC2
4846
4846
  include Aws::Structure
4847
4847
  end
4848
4848
 
4849
+ # Reserve powerful GPU instances on a future date to support your short
4850
+ # duration machine learning (ML) workloads. Instances that run inside a
4851
+ # Capacity Block are automatically placed close together inside [Amazon
4852
+ # EC2 UltraClusters][1], for low-latency, petabit-scale, non-blocking
4853
+ # networking.
4854
+ #
4855
+ # You can also reserve Amazon EC2 UltraServers. UltraServers connect
4856
+ # multiple EC2 instances using a low-latency, high-bandwidth accelerator
4857
+ # interconnect (NeuronLink). They are built to tackle very large-scale
4858
+ # AI/ML workloads that require significant processing power. For more
4859
+ # information, see Amazon EC2 UltraServers.
4860
+ #
4861
+ #
4862
+ #
4863
+ # [1]: http://aws.amazon.com/ec2/ultraclusters/
4864
+ #
4865
+ # @!attribute [rw] capacity_block_id
4866
+ # The ID of the Capacity Block.
4867
+ # @return [String]
4868
+ #
4869
+ # @!attribute [rw] ultraserver_type
4870
+ # The EC2 UltraServer type of the Capacity Block.
4871
+ # @return [String]
4872
+ #
4873
+ # @!attribute [rw] availability_zone
4874
+ # The Availability Zone of the Capacity Block.
4875
+ # @return [String]
4876
+ #
4877
+ # @!attribute [rw] availability_zone_id
4878
+ # The Availability Zone ID of the Capacity Block.
4879
+ # @return [String]
4880
+ #
4881
+ # @!attribute [rw] capacity_reservation_ids
4882
+ # The ID of the Capacity Reservation.
4883
+ # @return [Array<String>]
4884
+ #
4885
+ # @!attribute [rw] start_date
4886
+ # The date and time at which the Capacity Block was started.
4887
+ # @return [Time]
4888
+ #
4889
+ # @!attribute [rw] end_date
4890
+ # The date and time at which the Capacity Block expires. When a
4891
+ # Capacity Block expires, all instances in the Capacity Block are
4892
+ # terminated.
4893
+ # @return [Time]
4894
+ #
4895
+ # @!attribute [rw] create_date
4896
+ # The date and time at which the Capacity Block was created.
4897
+ # @return [Time]
4898
+ #
4899
+ # @!attribute [rw] state
4900
+ # The state of the Capacity Block.
4901
+ # @return [String]
4902
+ #
4903
+ # @!attribute [rw] tags
4904
+ # The tags assigned to the Capacity Block.
4905
+ # @return [Array<Types::Tag>]
4906
+ #
4907
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/CapacityBlock AWS API Documentation
4908
+ #
4909
+ class CapacityBlock < Struct.new(
4910
+ :capacity_block_id,
4911
+ :ultraserver_type,
4912
+ :availability_zone,
4913
+ :availability_zone_id,
4914
+ :capacity_reservation_ids,
4915
+ :start_date,
4916
+ :end_date,
4917
+ :create_date,
4918
+ :state,
4919
+ :tags)
4920
+ SENSITIVE = []
4921
+ include Aws::Structure
4922
+ end
4923
+
4849
4924
  # Describes a Capacity Block extension. With an extension, you can
4850
4925
  # extend the duration of time for an existing Capacity Block.
4851
4926
  #
@@ -5066,6 +5141,14 @@ module Aws::EC2
5066
5141
  # The tenancy of the Capacity Block.
5067
5142
  # @return [String]
5068
5143
  #
5144
+ # @!attribute [rw] ultraserver_type
5145
+ # The EC2 UltraServer type of the Capacity Block offering.
5146
+ # @return [String]
5147
+ #
5148
+ # @!attribute [rw] ultraserver_count
5149
+ # The number of EC2 UltraServers in the offering.
5150
+ # @return [Integer]
5151
+ #
5069
5152
  # @!attribute [rw] capacity_block_duration_minutes
5070
5153
  # The number of minutes (in addition to `capacityBlockDurationHours`)
5071
5154
  # for the duration of the Capacity Block reservation. For example, if
@@ -5086,11 +5169,63 @@ module Aws::EC2
5086
5169
  :upfront_fee,
5087
5170
  :currency_code,
5088
5171
  :tenancy,
5172
+ :ultraserver_type,
5173
+ :ultraserver_count,
5089
5174
  :capacity_block_duration_minutes)
5090
5175
  SENSITIVE = []
5091
5176
  include Aws::Structure
5092
5177
  end
5093
5178
 
5179
+ # Describes the availability of capacity for a Capacity Block.
5180
+ #
5181
+ # @!attribute [rw] capacity_block_id
5182
+ # The ID of the Capacity Block.
5183
+ # @return [String]
5184
+ #
5185
+ # @!attribute [rw] interconnect_status
5186
+ # The status of the high-bandwidth accelerator interconnect. Possible
5187
+ # states include:
5188
+ #
5189
+ # * `ok` the accelerator interconnect is healthy.
5190
+ #
5191
+ # * `impaired` - accelerator interconnect communication is impaired.
5192
+ #
5193
+ # * `insufficient-data` - insufficient data to determine accelerator
5194
+ # interconnect status.
5195
+ # @return [String]
5196
+ #
5197
+ # @!attribute [rw] total_capacity
5198
+ # The combined amount of `Available` and `Unavailable` capacity in the
5199
+ # Capacity Block.
5200
+ # @return [Integer]
5201
+ #
5202
+ # @!attribute [rw] total_available_capacity
5203
+ # The remaining capacity. Indicates the number of resources that can
5204
+ # be launched into the Capacity Block.
5205
+ # @return [Integer]
5206
+ #
5207
+ # @!attribute [rw] total_unavailable_capacity
5208
+ # The unavailable capacity. Indicates the instance capacity that is
5209
+ # unavailable for use due to a system status check failure.
5210
+ # @return [Integer]
5211
+ #
5212
+ # @!attribute [rw] capacity_reservation_statuses
5213
+ # The availability of capacity for the Capacity Block reservations.
5214
+ # @return [Array<Types::CapacityReservationStatus>]
5215
+ #
5216
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/CapacityBlockStatus AWS API Documentation
5217
+ #
5218
+ class CapacityBlockStatus < Struct.new(
5219
+ :capacity_block_id,
5220
+ :interconnect_status,
5221
+ :total_capacity,
5222
+ :total_available_capacity,
5223
+ :total_unavailable_capacity,
5224
+ :capacity_reservation_statuses)
5225
+ SENSITIVE = []
5226
+ include Aws::Structure
5227
+ end
5228
+
5094
5229
  # Describes a Capacity Reservation.
5095
5230
  #
5096
5231
  # @!attribute [rw] capacity_reservation_id
@@ -5301,6 +5436,10 @@ module Aws::EC2
5301
5436
  # have in your account at the requested date and time.
5302
5437
  # @return [String]
5303
5438
  #
5439
+ # @!attribute [rw] capacity_block_id
5440
+ # The ID of the Capacity Block.
5441
+ # @return [String]
5442
+ #
5304
5443
  # @see http://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/CapacityReservation AWS API Documentation
5305
5444
  #
5306
5445
  class CapacityReservation < Struct.new(
@@ -5330,7 +5469,8 @@ module Aws::EC2
5330
5469
  :reservation_type,
5331
5470
  :unused_reservation_billing_owner_id,
5332
5471
  :commitment_info,
5333
- :delivery_preference)
5472
+ :delivery_preference,
5473
+ :capacity_block_id)
5334
5474
  SENSITIVE = []
5335
5475
  include Aws::Structure
5336
5476
  end
@@ -5792,6 +5932,38 @@ module Aws::EC2
5792
5932
  include Aws::Structure
5793
5933
  end
5794
5934
 
5935
+ # Describes the availability of capacity for a Capacity Reservation.
5936
+ #
5937
+ # @!attribute [rw] capacity_reservation_id
5938
+ # The ID of the Capacity Reservation.
5939
+ # @return [String]
5940
+ #
5941
+ # @!attribute [rw] total_capacity
5942
+ # The combined amount of `Available` and `Unavailable` capacity in the
5943
+ # Capacity Reservation.
5944
+ # @return [Integer]
5945
+ #
5946
+ # @!attribute [rw] total_available_capacity
5947
+ # The remaining capacity. Indicates the amount of resources that can
5948
+ # be launched into the Capacity Reservation.
5949
+ # @return [Integer]
5950
+ #
5951
+ # @!attribute [rw] total_unavailable_capacity
5952
+ # The used capacity. Indicates that the capacity is in use by
5953
+ # resources that are running in the Capacity Reservation.
5954
+ # @return [Integer]
5955
+ #
5956
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/CapacityReservationStatus AWS API Documentation
5957
+ #
5958
+ class CapacityReservationStatus < Struct.new(
5959
+ :capacity_reservation_id,
5960
+ :total_capacity,
5961
+ :total_available_capacity,
5962
+ :total_unavailable_capacity)
5963
+ SENSITIVE = []
5964
+ include Aws::Structure
5965
+ end
5966
+
5795
5967
  # Describes a target Capacity Reservation or Capacity Reservation group.
5796
5968
  #
5797
5969
  # @!attribute [rw] capacity_reservation_id
@@ -7968,7 +8140,7 @@ module Aws::EC2
7968
8140
  # The instance type for which to reserve capacity.
7969
8141
  #
7970
8142
  # <note markdown="1"> You can request future-dated Capacity Reservations for instance
7971
- # types in the C, M, R, I, and T instance families only.
8143
+ # types in the C, M, R, I, T, and G instance families only.
7972
8144
  #
7973
8145
  # </note>
7974
8146
  #
@@ -8009,9 +8181,9 @@ module Aws::EC2
8009
8181
  # The number of instances for which to reserve capacity.
8010
8182
  #
8011
8183
  # <note markdown="1"> You can request future-dated Capacity Reservations for an instance
8012
- # count with a minimum of 100 vCPUs. For example, if you request a
8184
+ # count with a minimum of 64 vCPUs. For example, if you request a
8013
8185
  # future-dated Capacity Reservation for `m5.xlarge` instances, you
8014
- # must request at least 25 instances (*25 * m5.xlarge = 100 vCPUs*).
8186
+ # must request at least 25 instances (*16 * m5.xlarge = 64 vCPUs*).
8015
8187
  #
8016
8188
  # </note>
8017
8189
  #
@@ -9597,6 +9769,12 @@ module Aws::EC2
9597
9769
  #
9598
9770
  # * `false` - Use the network interface IP address as the source.
9599
9771
  #
9772
+ # <note markdown="1"> `PreserveClientIp` is only supported on IPv4 EC2 Instance Connect
9773
+ # Endpoints. To use `PreserveClientIp`, the value for `IpAddressType`
9774
+ # must be `ipv4`.
9775
+ #
9776
+ # </note>
9777
+ #
9600
9778
  # Default: `false`
9601
9779
  # @return [Boolean]
9602
9780
  #
@@ -9613,6 +9791,25 @@ module Aws::EC2
9613
9791
  # creation.
9614
9792
  # @return [Array<Types::TagSpecification>]
9615
9793
  #
9794
+ # @!attribute [rw] ip_address_type
9795
+ # The IP address type of the endpoint.
9796
+ #
9797
+ # If no value is specified, the default value is determined by the IP
9798
+ # address type of the subnet:
9799
+ #
9800
+ # * `dualstack` - If the subnet has both IPv4 and IPv6 CIDRs
9801
+ #
9802
+ # * `ipv4` - If the subnet has only IPv4 CIDRs
9803
+ #
9804
+ # * `ipv6` - If the subnet has only IPv6 CIDRs
9805
+ #
9806
+ # <note markdown="1"> `PreserveClientIp` is only supported on IPv4 EC2 Instance Connect
9807
+ # Endpoints. To use `PreserveClientIp`, the value for `IpAddressType`
9808
+ # must be `ipv4`.
9809
+ #
9810
+ # </note>
9811
+ # @return [String]
9812
+ #
9616
9813
  # @see http://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/CreateInstanceConnectEndpointRequest AWS API Documentation
9617
9814
  #
9618
9815
  class CreateInstanceConnectEndpointRequest < Struct.new(
@@ -9621,7 +9818,8 @@ module Aws::EC2
9621
9818
  :security_group_ids,
9622
9819
  :preserve_client_ip,
9623
9820
  :client_token,
9624
- :tag_specifications)
9821
+ :tag_specifications,
9822
+ :ip_address_type)
9625
9823
  SENSITIVE = []
9626
9824
  include Aws::Structure
9627
9825
  end
@@ -19553,6 +19751,14 @@ module Aws::EC2
19553
19751
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Query-Requests.html#api-pagination
19554
19752
  # @return [Integer]
19555
19753
  #
19754
+ # @!attribute [rw] ultraserver_type
19755
+ # The EC2 UltraServer type of the Capacity Block offerings.
19756
+ # @return [String]
19757
+ #
19758
+ # @!attribute [rw] ultraserver_count
19759
+ # The number of EC2 UltraServers in the offerings.
19760
+ # @return [Integer]
19761
+ #
19556
19762
  # @see http://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/DescribeCapacityBlockOfferingsRequest AWS API Documentation
19557
19763
  #
19558
19764
  class DescribeCapacityBlockOfferingsRequest < Struct.new(
@@ -19563,7 +19769,9 @@ module Aws::EC2
19563
19769
  :end_date_range,
19564
19770
  :capacity_duration_hours,
19565
19771
  :next_token,
19566
- :max_results)
19772
+ :max_results,
19773
+ :ultraserver_type,
19774
+ :ultraserver_count)
19567
19775
  SENSITIVE = []
19568
19776
  include Aws::Structure
19569
19777
  end
@@ -19586,6 +19794,152 @@ module Aws::EC2
19586
19794
  include Aws::Structure
19587
19795
  end
19588
19796
 
19797
+ # @!attribute [rw] capacity_block_ids
19798
+ # The ID of the Capacity Block.
19799
+ # @return [Array<String>]
19800
+ #
19801
+ # @!attribute [rw] next_token
19802
+ # The token to use to retrieve the next page of results.
19803
+ # @return [String]
19804
+ #
19805
+ # @!attribute [rw] max_results
19806
+ # The maximum number of items to return for this request. To get the
19807
+ # next page of items, make another request with the token returned in
19808
+ # the output. For more information, see [Pagination][1].
19809
+ #
19810
+ #
19811
+ #
19812
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Query-Requests.html#api-pagination
19813
+ # @return [Integer]
19814
+ #
19815
+ # @!attribute [rw] filters
19816
+ # One or more filters.
19817
+ #
19818
+ # * `interconnect-status` - The status of the interconnect for the
19819
+ # Capacity Block (`ok` \| `impaired` \| `insufficient-data`).
19820
+ #
19821
+ # ^
19822
+ # @return [Array<Types::Filter>]
19823
+ #
19824
+ # @!attribute [rw] dry_run
19825
+ # Checks whether you have the required permissions for the action,
19826
+ # without actually making the request, and provides an error response.
19827
+ # If you have the required permissions, the error response is
19828
+ # `DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.
19829
+ # @return [Boolean]
19830
+ #
19831
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/DescribeCapacityBlockStatusRequest AWS API Documentation
19832
+ #
19833
+ class DescribeCapacityBlockStatusRequest < Struct.new(
19834
+ :capacity_block_ids,
19835
+ :next_token,
19836
+ :max_results,
19837
+ :filters,
19838
+ :dry_run)
19839
+ SENSITIVE = []
19840
+ include Aws::Structure
19841
+ end
19842
+
19843
+ # @!attribute [rw] capacity_block_statuses
19844
+ # The availability of capacity for a Capacity Block.
19845
+ # @return [Array<Types::CapacityBlockStatus>]
19846
+ #
19847
+ # @!attribute [rw] next_token
19848
+ # The token to use to retrieve the next page of results. This value is
19849
+ # `null` when there are no more results to return.
19850
+ # @return [String]
19851
+ #
19852
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/DescribeCapacityBlockStatusResult AWS API Documentation
19853
+ #
19854
+ class DescribeCapacityBlockStatusResult < Struct.new(
19855
+ :capacity_block_statuses,
19856
+ :next_token)
19857
+ SENSITIVE = []
19858
+ include Aws::Structure
19859
+ end
19860
+
19861
+ # @!attribute [rw] capacity_block_ids
19862
+ # The IDs of the Capacity Blocks.
19863
+ # @return [Array<String>]
19864
+ #
19865
+ # @!attribute [rw] next_token
19866
+ # The token to use to retrieve the next page of results.
19867
+ # @return [String]
19868
+ #
19869
+ # @!attribute [rw] max_results
19870
+ # The maximum number of items to return for this request. To get the
19871
+ # next page of items, make another request with the token returned in
19872
+ # the output. For more information, see [Pagination][1].
19873
+ #
19874
+ #
19875
+ #
19876
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Query-Requests.html#api-pagination
19877
+ # @return [Integer]
19878
+ #
19879
+ # @!attribute [rw] filters
19880
+ # One or more filters.
19881
+ #
19882
+ # * `capacity-block-id` - The ID of the Capacity Block.
19883
+ #
19884
+ # * `ultraserver-type` - The Capacity Block type. The type can be
19885
+ # `instances` or `ultraservers`.
19886
+ #
19887
+ # * `availability-zone` - The Availability Zone of the Capacity Block.
19888
+ #
19889
+ # * `start-date` - The date and time at which the Capacity Block was
19890
+ # started.
19891
+ #
19892
+ # * `end-date` - The date and time at which the Capacity Block
19893
+ # expires. When a Capacity Block expires, all instances in the
19894
+ # Capacity Block are terminated.
19895
+ #
19896
+ # * `create-date` - The date and time at which the Capacity Block was
19897
+ # created.
19898
+ #
19899
+ # * `state` - The state of the Capacity Block (`active` \| `expired`
19900
+ # \| `unavailable` \| `cancelled` \| `failed` \| `scheduled` \|
19901
+ # `payment-pending` \| `payment-failed`).
19902
+ #
19903
+ # * `tags` - The tags assigned to the Capacity Block.
19904
+ # @return [Array<Types::Filter>]
19905
+ #
19906
+ # @!attribute [rw] dry_run
19907
+ # Checks whether you have the required permissions for the action,
19908
+ # without actually making the request, and provides an error response.
19909
+ # If you have the required permissions, the error response is
19910
+ # `DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.
19911
+ # @return [Boolean]
19912
+ #
19913
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/DescribeCapacityBlocksRequest AWS API Documentation
19914
+ #
19915
+ class DescribeCapacityBlocksRequest < Struct.new(
19916
+ :capacity_block_ids,
19917
+ :next_token,
19918
+ :max_results,
19919
+ :filters,
19920
+ :dry_run)
19921
+ SENSITIVE = []
19922
+ include Aws::Structure
19923
+ end
19924
+
19925
+ # @!attribute [rw] capacity_blocks
19926
+ # The Capacity Blocks.
19927
+ # @return [Array<Types::CapacityBlock>]
19928
+ #
19929
+ # @!attribute [rw] next_token
19930
+ # The token to use to retrieve the next page of results. This value is
19931
+ # `null` when there are no more results to return.
19932
+ # @return [String]
19933
+ #
19934
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/DescribeCapacityBlocksResult AWS API Documentation
19935
+ #
19936
+ class DescribeCapacityBlocksResult < Struct.new(
19937
+ :capacity_blocks,
19938
+ :next_token)
19939
+ SENSITIVE = []
19940
+ include Aws::Structure
19941
+ end
19942
+
19589
19943
  # @!attribute [rw] capacity_reservation_ids
19590
19944
  # The ID of the Capacity Reservation.
19591
19945
  # @return [Array<String>]
@@ -22186,6 +22540,10 @@ module Aws::EC2
22186
22540
  # * `ena-support` - A Boolean that indicates whether enhanced
22187
22541
  # networking with ENA is enabled.
22188
22542
  #
22543
+ # * `free-tier-eligible` - A Boolean that indicates whether this image
22544
+ # can be used under the Amazon Web Services Free Tier (`true` \|
22545
+ # `false`).
22546
+ #
22189
22547
  # * `hypervisor` - The hypervisor type (`ovm` \| `xen`).
22190
22548
  #
22191
22549
  # * `image-allowed` - A Boolean that indicates whether the image meets
@@ -23202,8 +23560,9 @@ module Aws::EC2
23202
23560
  # express (NVMe) is supported for EBS volumes (`required` \|
23203
23561
  # `supported` \| `unsupported`).
23204
23562
  #
23205
- # * `free-tier-eligible` - Indicates whether the instance type is
23206
- # eligible to use in the free tier (`true` \| `false`).
23563
+ # * `free-tier-eligible` - A Boolean that indicates whether this
23564
+ # instance type can be used under the Amazon Web Services Free Tier
23565
+ # (`true` \| `false`).
23207
23566
  #
23208
23567
  # * `hibernation-supported` - Indicates whether On-Demand hibernation
23209
23568
  # is supported (`true` \| `false`).
@@ -34191,11 +34550,18 @@ module Aws::EC2
34191
34550
  # but not both. If neither is specified, Amazon EC2 automatically
34192
34551
  # selects an Availability Zone within the Region.
34193
34552
  #
34194
- # This parameter is not supported when using [CreateImage][1].
34553
+ # This parameter is not supported when using [CreateFleet][1],
34554
+ # [CreateImage][2], [DescribeImages][3], [RequestSpotFleet][4],
34555
+ # [RequestSpotInstances][5], and [RunInstances][6].
34195
34556
  #
34196
34557
  #
34197
34558
  #
34198
- # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateImage.html
34559
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateFleet.html
34560
+ # [2]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateImage.html
34561
+ # [3]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeImages.html
34562
+ # [4]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RequestSpotFleet.html
34563
+ # [5]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RequestSpotInstances.html
34564
+ # [6]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RunInstances.html
34199
34565
  # @return [String]
34200
34566
  #
34201
34567
  # @!attribute [rw] encrypted
@@ -34292,11 +34658,18 @@ module Aws::EC2
34292
34658
  # but not both. If neither is specified, Amazon EC2 automatically
34293
34659
  # selects an Availability Zone within the Region.
34294
34660
  #
34295
- # This parameter is not supported when using [CreateImage][1].
34661
+ # This parameter is not supported when using [CreateFleet][1],
34662
+ # [CreateImage][2], [DescribeImages][3], [RequestSpotFleet][4],
34663
+ # [RequestSpotInstances][5], and [RunInstances][6].
34296
34664
  #
34297
34665
  #
34298
34666
  #
34299
- # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateImage.html
34667
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateFleet.html
34668
+ # [2]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateImage.html
34669
+ # [3]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeImages.html
34670
+ # [4]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RequestSpotFleet.html
34671
+ # [5]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RequestSpotInstances.html
34672
+ # [6]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RunInstances.html
34300
34673
  # @return [String]
34301
34674
  #
34302
34675
  # @see http://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/EbsBlockDevice AWS API Documentation
@@ -34432,15 +34805,15 @@ module Aws::EC2
34432
34805
  # @return [String]
34433
34806
  #
34434
34807
  # @!attribute [rw] associated_resource
34435
- # The ARN of the Amazon ECS or Fargate task to which the volume is
34436
- # attached.
34808
+ # The ARN of the Amazon Web Services-managed resource to which the
34809
+ # volume is attached.
34437
34810
  # @return [String]
34438
34811
  #
34439
34812
  # @!attribute [rw] volume_owner_id
34440
34813
  # The ID of the Amazon Web Services account that owns the volume.
34441
34814
  #
34442
34815
  # This parameter is returned only for volumes that are attached to
34443
- # Fargate tasks.
34816
+ # Amazon Web Services-managed resources.
34444
34817
  # @return [String]
34445
34818
  #
34446
34819
  # @!attribute [rw] operator
@@ -34598,6 +34971,8 @@ module Aws::EC2
34598
34971
  # @return [String]
34599
34972
  #
34600
34973
  # @!attribute [rw] fips_dns_name
34974
+ # The Federal Information Processing Standards (FIPS) compliant DNS
34975
+ # name of the EC2 Instance Connect Endpoint.
34601
34976
  # @return [String]
34602
34977
  #
34603
34978
  # @!attribute [rw] network_interface_ids
@@ -34648,6 +35023,10 @@ module Aws::EC2
34648
35023
  # The tags assigned to the EC2 Instance Connect Endpoint.
34649
35024
  # @return [Array<Types::Tag>]
34650
35025
  #
35026
+ # @!attribute [rw] ip_address_type
35027
+ # The IP address type of the endpoint.
35028
+ # @return [String]
35029
+ #
34651
35030
  # @see http://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/Ec2InstanceConnectEndpoint AWS API Documentation
34652
35031
  #
34653
35032
  class Ec2InstanceConnectEndpoint < Struct.new(
@@ -34665,7 +35044,8 @@ module Aws::EC2
34665
35044
  :subnet_id,
34666
35045
  :preserve_client_ip,
34667
35046
  :security_group_ids,
34668
- :tags)
35047
+ :tags,
35048
+ :ip_address_type)
34669
35049
  SENSITIVE = []
34670
35050
  include Aws::Structure
34671
35051
  end
@@ -42626,6 +43006,16 @@ module Aws::EC2
42626
43006
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/identify-source-ami-used-to-create-new-ami.html
42627
43007
  # @return [String]
42628
43008
  #
43009
+ # @!attribute [rw] free_tier_eligible
43010
+ # Indicates whether the image is eligible for Amazon Web Services Free
43011
+ # Tier.
43012
+ #
43013
+ # * If `true`, the AMI is eligible for Free Tier and can be used to
43014
+ # launch instances under the Free Tier limits.
43015
+ #
43016
+ # * If `false`, the AMI is not eligible for Free Tier.
43017
+ # @return [Boolean]
43018
+ #
42629
43019
  # @!attribute [rw] image_id
42630
43020
  # The ID of the AMI.
42631
43021
  # @return [String]
@@ -42707,6 +43097,7 @@ module Aws::EC2
42707
43097
  :image_allowed,
42708
43098
  :source_image_id,
42709
43099
  :source_image_region,
43100
+ :free_tier_eligible,
42710
43101
  :image_id,
42711
43102
  :image_location,
42712
43103
  :state,
@@ -44069,6 +44460,46 @@ module Aws::EC2
44069
44460
  include Aws::Structure
44070
44461
  end
44071
44462
 
44463
+ # Information about the volume initialization. For more information, see
44464
+ # [Initialize Amazon EBS volumes][1].
44465
+ #
44466
+ #
44467
+ #
44468
+ # [1]: https://docs.aws.amazon.com/ebs/latest/userguide/initalize-volume.html
44469
+ #
44470
+ # @!attribute [rw] initialization_type
44471
+ # The method used for volume initialization. Possible values include:
44472
+ #
44473
+ # * `default` - Volume initialized using the default volume
44474
+ # initialization rate or fast snapshot restore.
44475
+ #
44476
+ # * `provisioned-rate` - Volume initialized using an Amazon EBS
44477
+ # Provisioned Rate for Volume Initialization.
44478
+ # @return [String]
44479
+ #
44480
+ # @!attribute [rw] progress
44481
+ # The current volume initialization progress as a percentage (0-100).
44482
+ # Returns `100` when volume initialization has completed.
44483
+ # @return [Integer]
44484
+ #
44485
+ # @!attribute [rw] estimated_time_to_complete_in_seconds
44486
+ # The estimated remaining time, in seconds, for volume initialization
44487
+ # to complete. Returns `0` when volume initialization has completed.
44488
+ #
44489
+ # Only available for volumes created with Amazon EBS Provisioned Rate
44490
+ # for Volume Initialization.
44491
+ # @return [Integer]
44492
+ #
44493
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/InitializationStatusDetails AWS API Documentation
44494
+ #
44495
+ class InitializationStatusDetails < Struct.new(
44496
+ :initialization_type,
44497
+ :progress,
44498
+ :estimated_time_to_complete_in_seconds)
44499
+ SENSITIVE = []
44500
+ include Aws::Structure
44501
+ end
44502
+
44072
44503
  # Describes an instance.
44073
44504
  #
44074
44505
  # @!attribute [rw] architecture
@@ -44177,6 +44608,16 @@ module Aws::EC2
44177
44608
  # The CPU options for the instance.
44178
44609
  # @return [Types::CpuOptions]
44179
44610
  #
44611
+ # @!attribute [rw] capacity_block_id
44612
+ # The ID of the Capacity Block.
44613
+ #
44614
+ # <note markdown="1"> For P5 instances, a Capacity Block ID refers to a group of
44615
+ # instances. For Trn2u instances, a capacity block ID refers to an EC2
44616
+ # UltraServer.
44617
+ #
44618
+ # </note>
44619
+ # @return [String]
44620
+ #
44180
44621
  # @!attribute [rw] capacity_reservation_id
44181
44622
  # The ID of the Capacity Reservation.
44182
44623
  # @return [String]
@@ -44418,6 +44859,7 @@ module Aws::EC2
44418
44859
  :tags,
44419
44860
  :virtualization_type,
44420
44861
  :cpu_options,
44862
+ :capacity_block_id,
44421
44863
  :capacity_reservation_id,
44422
44864
  :capacity_reservation_specification,
44423
44865
  :hibernation_options,
@@ -47290,6 +47732,12 @@ module Aws::EC2
47290
47732
  # in.
47291
47733
  # @return [String]
47292
47734
  #
47735
+ # @!attribute [rw] capacity_block_id
47736
+ # The ID of the Capacity Block. This parameter is only supported for
47737
+ # Ultraserver instances and identifies instances within the
47738
+ # Ultraserver domain.
47739
+ # @return [String]
47740
+ #
47293
47741
  # @see http://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/InstanceTopology AWS API Documentation
47294
47742
  #
47295
47743
  class InstanceTopology < Struct.new(
@@ -47298,7 +47746,8 @@ module Aws::EC2
47298
47746
  :group_name,
47299
47747
  :network_nodes,
47300
47748
  :availability_zone,
47301
- :zone_id)
47749
+ :zone_id,
47750
+ :capacity_block_id)
47302
47751
  SENSITIVE = []
47303
47752
  include Aws::Structure
47304
47753
  end
@@ -53907,7 +54356,7 @@ module Aws::EC2
53907
54356
  # value is specified for `DeleteOnTermination`, the default is `true`
53908
54357
  # and the volume is deleted when the instance is terminated. You
53909
54358
  # can't modify the `DeleteOnTermination` attribute for volumes that
53910
- # are attached to Fargate tasks.
54359
+ # are attached to Amazon Web Services-managed resources.
53911
54360
  #
53912
54361
  # To add instance store volumes to an Amazon EBS-backed instance, you
53913
54362
  # must add them when you launch the instance. For more information,
@@ -62113,10 +62562,15 @@ module Aws::EC2
62113
62562
  # The Capacity Reservation.
62114
62563
  # @return [Types::CapacityReservation]
62115
62564
  #
62565
+ # @!attribute [rw] capacity_blocks
62566
+ # The Capacity Block.
62567
+ # @return [Array<Types::CapacityBlock>]
62568
+ #
62116
62569
  # @see http://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/PurchaseCapacityBlockResult AWS API Documentation
62117
62570
  #
62118
62571
  class PurchaseCapacityBlockResult < Struct.new(
62119
- :capacity_reservation)
62572
+ :capacity_reservation,
62573
+ :capacity_blocks)
62120
62574
  SENSITIVE = []
62121
62575
  include Aws::Structure
62122
62576
  end
@@ -67044,12 +67498,12 @@ module Aws::EC2
67044
67498
  # @return [String]
67045
67499
  #
67046
67500
  # @!attribute [rw] instance_type
67047
- # The instance type. For more information, see [Amazon EC2 instance
67048
- # types][1] in the *Amazon EC2 User Guide*.
67501
+ # The instance type. For more information, see [Amazon EC2 Instance
67502
+ # Types Guide][1].
67049
67503
  #
67050
67504
  #
67051
67505
  #
67052
- # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html
67506
+ # [1]: https://docs.aws.amazon.com/ec2/latest/instancetypes/instance-types.html
67053
67507
  # @return [String]
67054
67508
  #
67055
67509
  # @!attribute [rw] ipv_6_address_count
@@ -67087,8 +67541,8 @@ module Aws::EC2
67087
67541
  # @return [String]
67088
67542
  #
67089
67543
  # @!attribute [rw] key_name
67090
- # The name of the key pair. You can create a key pair using
67091
- # [CreateKeyPair][1] or [ImportKeyPair][2].
67544
+ # The name of the key pair. For more information, see [Create a key
67545
+ # pair for your EC2 instance][1].
67092
67546
  #
67093
67547
  # If you do not specify a key pair, you can't connect to the instance
67094
67548
  # unless you choose an AMI that is configured to allow users another
@@ -67096,8 +67550,7 @@ module Aws::EC2
67096
67550
  #
67097
67551
  #
67098
67552
  #
67099
- # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateKeyPair.html
67100
- # [2]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ImportKeyPair.html
67553
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/create-key-pairs.html
67101
67554
  # @return [String]
67102
67555
  #
67103
67556
  # @!attribute [rw] max_count
@@ -67154,16 +67607,11 @@ module Aws::EC2
67154
67607
  # @return [String]
67155
67608
  #
67156
67609
  # @!attribute [rw] security_group_ids
67157
- # The IDs of the security groups. You can create a security group
67158
- # using [CreateSecurityGroup][1].
67610
+ # The IDs of the security groups.
67159
67611
  #
67160
67612
  # If you specify a network interface, you must specify any security
67161
67613
  # groups as part of the network interface instead of using this
67162
67614
  # parameter.
67163
- #
67164
- #
67165
- #
67166
- # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateSecurityGroup.html
67167
67615
  # @return [Array<String>]
67168
67616
  #
67169
67617
  # @!attribute [rw] security_groups
@@ -67187,11 +67635,11 @@ module Aws::EC2
67187
67635
  # The user data to make available to the instance. User data must be
67188
67636
  # base64-encoded. Depending on the tool or SDK that you're using, the
67189
67637
  # base64-encoding might be performed for you. For more information,
67190
- # see [Work with instance user data][1].
67638
+ # see [Run commands at launch using instance user data][1].
67191
67639
  #
67192
67640
  #
67193
67641
  #
67194
- # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instancedata-add-user-data.html
67642
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/user-data.html
67195
67643
  # @return [String]
67196
67644
  #
67197
67645
  # @!attribute [rw] elastic_gpu_specification
@@ -67301,25 +67749,24 @@ module Aws::EC2
67301
67749
  #
67302
67750
  # @!attribute [rw] metadata_options
67303
67751
  # The metadata options for the instance. For more information, see
67304
- # [Instance metadata and user data][1].
67752
+ # [Configure the Instance Metadata Service options][1].
67305
67753
  #
67306
67754
  #
67307
67755
  #
67308
- # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html
67756
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-options.html
67309
67757
  # @return [Types::InstanceMetadataOptionsRequest]
67310
67758
  #
67311
67759
  # @!attribute [rw] enclave_options
67312
67760
  # Indicates whether the instance is enabled for Amazon Web Services
67313
- # Nitro Enclaves. For more information, see [What is Amazon Web
67314
- # Services Nitro Enclaves?][1] in the *Amazon Web Services Nitro
67315
- # Enclaves User Guide*.
67761
+ # Nitro Enclaves. For more information, see [Amazon Web Services Nitro
67762
+ # Enclaves User Guide][1].
67316
67763
  #
67317
67764
  # You can't enable Amazon Web Services Nitro Enclaves and hibernation
67318
67765
  # on the same instance.
67319
67766
  #
67320
67767
  #
67321
67768
  #
67322
- # [1]: https://docs.aws.amazon.com/enclaves/latest/user/nitro-enclave.html
67769
+ # [1]: https://docs.aws.amazon.com/enclaves/latest/user/
67323
67770
  # @return [Types::EnclaveOptionsRequest]
67324
67771
  #
67325
67772
  # @!attribute [rw] private_dns_name_options
@@ -67334,11 +67781,12 @@ module Aws::EC2
67334
67781
  #
67335
67782
  # @!attribute [rw] disable_api_stop
67336
67783
  # Indicates whether an instance is enabled for stop protection. For
67337
- # more information, see [Stop protection][1].
67784
+ # more information, see [Enable stop protection for your EC2
67785
+ # instances][1].
67338
67786
  #
67339
67787
  #
67340
67788
  #
67341
- # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Stop_Start.html#Using_StopProtection
67789
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-stop-protection.html
67342
67790
  # @return [Boolean]
67343
67791
  #
67344
67792
  # @!attribute [rw] enable_primary_ipv_6
@@ -67412,7 +67860,8 @@ module Aws::EC2
67412
67860
  # randomly generated token is used for the request to ensure
67413
67861
  # idempotency.
67414
67862
  #
67415
- # For more information, see [Ensuring Idempotency][1].
67863
+ # For more information, see [Ensuring idempotency in Amazon EC2 API
67864
+ # requests][1].
67416
67865
  #
67417
67866
  # Constraints: Maximum 64 ASCII characters
67418
67867
  #
@@ -67421,7 +67870,7 @@ module Aws::EC2
67421
67870
  #
67422
67871
  #
67423
67872
  #
67424
- # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html
67873
+ # [1]: https://docs.aws.amazon.com/ec2/latest/devguide/ec2-api-idempotency.html
67425
67874
  # @return [String]
67426
67875
  #
67427
67876
  # @!attribute [rw] additional_info
@@ -71571,8 +72020,8 @@ module Aws::EC2
71571
72020
  # @!attribute [rw] hibernate
71572
72021
  # Hibernates the instance if the instance was enabled for hibernation
71573
72022
  # at launch. If the instance cannot hibernate successfully, a normal
71574
- # shutdown occurs. For more information, see [Hibernate your
71575
- # instance][1] in the *Amazon EC2 User Guide*.
72023
+ # shutdown occurs. For more information, see [Hibernate your Amazon
72024
+ # EC2 instance][1] in the *Amazon EC2 User Guide*.
71576
72025
  #
71577
72026
  # Default: `false`
71578
72027
  #
@@ -71581,6 +72030,17 @@ module Aws::EC2
71581
72030
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Hibernate.html
71582
72031
  # @return [Boolean]
71583
72032
  #
72033
+ # @!attribute [rw] skip_os_shutdown
72034
+ # Specifies whether to bypass the graceful OS shutdown process when
72035
+ # the instance is stopped.
72036
+ #
72037
+ # Bypassing the graceful OS shutdown might result in data loss or
72038
+ # corruption (for example, memory contents not flushed to disk or loss
72039
+ # of in-flight IOs) or skipped shutdown scripts.
72040
+ #
72041
+ # Default: `false`
72042
+ # @return [Boolean]
72043
+ #
71584
72044
  # @!attribute [rw] dry_run
71585
72045
  # Checks whether you have the required permissions for the operation,
71586
72046
  # without actually making the request, and provides an error response.
@@ -71612,6 +72072,7 @@ module Aws::EC2
71612
72072
  class StopInstancesRequest < Struct.new(
71613
72073
  :instance_ids,
71614
72074
  :hibernate,
72075
+ :skip_os_shutdown,
71615
72076
  :dry_run,
71616
72077
  :force)
71617
72078
  SENSITIVE = []
@@ -72554,6 +73015,13 @@ module Aws::EC2
72554
73015
  # request into smaller batches.
72555
73016
  # @return [Array<String>]
72556
73017
  #
73018
+ # @!attribute [rw] skip_os_shutdown
73019
+ # Specifies whether to bypass the graceful OS shutdown process when
73020
+ # the instance is terminated.
73021
+ #
73022
+ # Default: `false`
73023
+ # @return [Boolean]
73024
+ #
72557
73025
  # @!attribute [rw] dry_run
72558
73026
  # Checks whether you have the required permissions for the operation,
72559
73027
  # without actually making the request, and provides an error response.
@@ -72565,6 +73033,7 @@ module Aws::EC2
72565
73033
  #
72566
73034
  class TerminateInstancesRequest < Struct.new(
72567
73035
  :instance_ids,
73036
+ :skip_os_shutdown,
72568
73037
  :dry_run)
72569
73038
  SENSITIVE = []
72570
73039
  include Aws::Structure
@@ -76391,16 +76860,16 @@ module Aws::EC2
76391
76860
  # @return [Boolean]
76392
76861
  #
76393
76862
  # @!attribute [rw] associated_resource
76394
- # The ARN of the Amazon ECS or Fargate task to which the volume is
76395
- # attached.
76863
+ # The ARN of the Amazon Web Services-managed resource to which the
76864
+ # volume is attached.
76396
76865
  # @return [String]
76397
76866
  #
76398
76867
  # @!attribute [rw] instance_owning_service
76399
- # The service principal of Amazon Web Services service that owns the
76400
- # underlying instance to which the volume is attached.
76868
+ # The service principal of the Amazon Web Services service that owns
76869
+ # the underlying resource to which the volume is attached.
76401
76870
  #
76402
76871
  # This parameter is returned only for volumes that are attached to
76403
- # Fargate tasks.
76872
+ # Amazon Web Services-managed resources.
76404
76873
  # @return [String]
76405
76874
  #
76406
76875
  # @!attribute [rw] volume_id
@@ -76410,15 +76879,15 @@ module Aws::EC2
76410
76879
  # @!attribute [rw] instance_id
76411
76880
  # The ID of the instance.
76412
76881
  #
76413
- # If the volume is attached to a Fargate task, this parameter returns
76414
- # `null`.
76882
+ # If the volume is attached to an Amazon Web Services-managed
76883
+ # resource, this parameter returns `null`.
76415
76884
  # @return [String]
76416
76885
  #
76417
76886
  # @!attribute [rw] device
76418
76887
  # The device name.
76419
76888
  #
76420
- # If the volume is attached to a Fargate task, this parameter returns
76421
- # `null`.
76889
+ # If the volume is attached to an Amazon Web Services-managed
76890
+ # resource, this parameter returns `null`.
76422
76891
  # @return [String]
76423
76892
  #
76424
76893
  # @!attribute [rw] state
@@ -76599,6 +77068,21 @@ module Aws::EC2
76599
77068
  #
76600
77069
  # @!attribute [rw] name
76601
77070
  # The name of the volume status.
77071
+ #
77072
+ # * `io-enabled` - Indicates the volume I/O status. For more
77073
+ # information, see [Amazon EBS volume status checks][1].
77074
+ #
77075
+ # * `io-performance` - Indicates the volume performance status. For
77076
+ # more information, see [Amazon EBS volume status checks][1].
77077
+ #
77078
+ # * `initialization-state` - Indicates the status of the volume
77079
+ # initialization process. For more information, see [Initialize
77080
+ # Amazon EBS volumes][2].
77081
+ #
77082
+ #
77083
+ #
77084
+ # [1]: https://docs.aws.amazon.com/ebs/latest/userguide/monitoring-volume-checks.html
77085
+ # [2]: https://docs.aws.amazon.com/ebs/latest/userguide/initalize-volume.html
76602
77086
  # @return [String]
76603
77087
  #
76604
77088
  # @!attribute [rw] status
@@ -76702,6 +77186,20 @@ module Aws::EC2
76702
77186
  # Information about the instances to which the volume is attached.
76703
77187
  # @return [Array<Types::VolumeStatusAttachmentStatus>]
76704
77188
  #
77189
+ # @!attribute [rw] initialization_status_details
77190
+ # Information about the volume initialization. It can take up to 5
77191
+ # minutes for the volume initialization information to be updated.
77192
+ #
77193
+ # Only available for volumes created from snapshots. Not available for
77194
+ # empty volumes created without a snapshot.
77195
+ #
77196
+ # For more information, see [ Initialize Amazon EBS volumes][1].
77197
+ #
77198
+ #
77199
+ #
77200
+ # [1]: https://docs.aws.amazon.com/ebs/latest/userguide/initalize-volume.html
77201
+ # @return [Types::InitializationStatusDetails]
77202
+ #
76705
77203
  # @!attribute [rw] availability_zone_id
76706
77204
  # The ID of the Availability Zone.
76707
77205
  # @return [String]
@@ -76716,6 +77214,7 @@ module Aws::EC2
76716
77214
  :volume_id,
76717
77215
  :volume_status,
76718
77216
  :attachment_statuses,
77217
+ :initialization_status_details,
76719
77218
  :availability_zone_id)
76720
77219
  SENSITIVE = []
76721
77220
  include Aws::Structure