aws-sdk-ec2 1.522.0 → 1.560.0

data/lib/aws-sdk-ec2/customizations.rb

@@ -1 +0,0 @@
-# frozen_string_literal: true

data/lib/aws-sdk-ec2/image.rb

@@ -142,8 +142,9 @@ module Aws::EC2
       data[:virtualization_type]
     end
 
-    # The boot mode of the image. For more information, see [Boot modes][1]
-    # in the *Amazon EC2 User Guide*.
+    # The boot mode of the image. For more information, see [Instance launch
+    # behavior with Amazon EC2 boot modes][1] in the *Amazon EC2 User
+    # Guide*.
     #
     #
     #
@@ -240,38 +241,29 @@ module Aws::EC2
     end
 
     # The ID of the source AMI from which the AMI was created.
-    #
-    # The ID only appears if the AMI was created using CreateImage,
-    # CopyImage, or CreateRestoreImageTask. The ID does not appear if the
-    # AMI was created using any other API. For some older AMIs, the ID might
-    # not be available. For more information, see [Identify the source AMI
-    # used to create a new AMI][1] in the *Amazon EC2 User Guide*.
-    #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/identify-source-ami-used-to-create-new-ami.html
     # @return [String]
     def source_image_id
       data[:source_image_id]
     end
 
     # The Region of the source AMI.
-    #
-    # The Region only appears if the AMI was created using CreateImage,
-    # CopyImage, or CreateRestoreImageTask. The Region does not appear if
-    # the AMI was created using any other API. For some older AMIs, the
-    # Region might not be available. For more information, see [Identify the
-    # source AMI used to create a new AMI][1] in the *Amazon EC2 User
-    # Guide*.
-    #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/identify-source-ami-used-to-create-new-ami.html
     # @return [String]
     def source_image_region
       data[:source_image_region]
     end
 
+    # Indicates whether the image is eligible for Amazon Web Services Free
+    # Tier.
+    #
+    # * If `true`, the AMI is eligible for Free Tier and can be used to
+    #   launch instances under the Free Tier limits.
+    #
+    # * If `false`, the AMI is not eligible for Free Tier.
+    # @return [Boolean]
+    def free_tier_eligible
+      data[:free_tier_eligible]
+    end
+
     # The location of the AMI.
     # @return [String]
     def image_location
@@ -605,9 +597,20 @@ module Aws::EC2
     # @example Request syntax with placeholder values
     #
     #   image.deregister({
+    #     delete_associated_snapshots: false,
     #     dry_run: false,
     #   })
     # @param [Hash] options ({})
+    # @option options [Boolean] :delete_associated_snapshots
+    #   Specifies whether to delete the snapshots associated with the AMI
+    #   during deregistration.
+    #
+    #   <note markdown="1"> If a snapshot is associated with multiple AMIs, it is not deleted,
+    #   regardless of this setting.
+    #
+    #    </note>
+    #
+    #   Default: The snapshots are not deleted.
     # @option options [Boolean] :dry_run
     #   Checks whether you have the required permissions for the action,
     #   without actually making the request, and provides an error response.
@@ -634,8 +637,8 @@ module Aws::EC2
     #
     #   **Note**: The `blockDeviceMapping` attribute is deprecated. Using this
     #   attribute returns the `Client.AuthFailure` error. To get information
-    #   about the block device mappings for an AMI, use the DescribeImages
-    #   action.
+    #   about the block device mappings for an AMI, describe the image
+    #   instead.
     # @option options [Boolean] :dry_run
     #   Checks whether you have the required permissions for the action,
     #   without actually making the request, and provides an error response.

data/lib/aws-sdk-ec2/instance.rb

@@ -177,6 +177,17 @@ module Aws::EC2
       data[:cpu_options]
     end
 
+    # The ID of the Capacity Block.
+    #
+    # <note markdown="1"> For P5 instances, a Capacity Block ID refers to a group of instances.
+    # For Trn2u instances, a capacity block ID refers to an EC2 UltraServer.
+    #
+    #  </note>
+    # @return [String]
+    def capacity_block_id
+      data[:capacity_block_id]
+    end
+
     # The ID of the Capacity Reservation.
     # @return [String]
     def capacity_reservation_id
@@ -345,9 +356,14 @@ module Aws::EC2
       data[:private_dns_name]
     end
 
-    # \[IPv4 only\] The public DNS name assigned to the instance. This name
-    # is not available until the instance enters the `running` state. This
-    # name is only available if you've enabled DNS hostnames for your VPC.
+    # The public DNS name assigned to the instance. This name is not
+    # available until the instance enters the `running` state. This name is
+    # only available if you've enabled DNS hostnames for your VPC. The
+    # format of this name depends on the [public hostname type][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/hostname-types.html#public-hostnames
     # @return [String]
     def public_dns_name
       data[:public_dns_name]
@@ -769,7 +785,7 @@ module Aws::EC2
     #   image = instance.create_image({
     #     tag_specifications: [
     #       {
-    #         resource_type: "capacity-reservation", # accepts capacity-reservation, client-vpn-endpoint, customer-gateway, carrier-gateway, coip-pool, declarative-policies-report, dedicated-host, dhcp-options, egress-only-internet-gateway, elastic-ip, elastic-gpu, export-image-task, export-instance-task, fleet, fpga-image, host-reservation, image, import-image-task, import-snapshot-task, instance, instance-event-window, internet-gateway, ipam, ipam-pool, ipam-scope, ipv4pool-ec2, ipv6pool-ec2, key-pair, launch-template, local-gateway, local-gateway-route-table, local-gateway-virtual-interface, local-gateway-virtual-interface-group, local-gateway-route-table-vpc-association, local-gateway-route-table-virtual-interface-group-association, natgateway, network-acl, network-interface, network-insights-analysis, network-insights-path, network-insights-access-scope, network-insights-access-scope-analysis, outpost-lag, placement-group, prefix-list, replace-root-volume-task, reserved-instances, route-table, security-group, security-group-rule, service-link-virtual-interface, snapshot, spot-fleet-request, spot-instances-request, subnet, subnet-cidr-reservation, traffic-mirror-filter, traffic-mirror-session, traffic-mirror-target, transit-gateway, transit-gateway-attachment, transit-gateway-connect-peer, transit-gateway-multicast-domain, transit-gateway-policy-table, transit-gateway-route-table, transit-gateway-route-table-announcement, volume, vpc, vpc-endpoint, vpc-endpoint-connection, vpc-endpoint-service, vpc-endpoint-service-permission, vpc-peering-connection, vpn-connection, vpn-gateway, vpc-flow-log, capacity-reservation-fleet, traffic-mirror-filter-rule, vpc-endpoint-connection-device-type, verified-access-instance, verified-access-group, verified-access-endpoint, verified-access-policy, verified-access-trust-provider, vpn-connection-device-type, vpc-block-public-access-exclusion, route-server, route-server-endpoint, route-server-peer, ipam-resource-discovery, ipam-resource-discovery-association, instance-connect-endpoint, verified-access-endpoint-target, ipam-external-resource-verification-token
+    #         resource_type: "capacity-reservation", # accepts capacity-reservation, client-vpn-endpoint, customer-gateway, carrier-gateway, coip-pool, declarative-policies-report, dedicated-host, dhcp-options, egress-only-internet-gateway, elastic-ip, elastic-gpu, export-image-task, export-instance-task, fleet, fpga-image, host-reservation, image, image-usage-report, import-image-task, import-snapshot-task, instance, instance-event-window, internet-gateway, ipam, ipam-pool, ipam-scope, ipv4pool-ec2, ipv6pool-ec2, key-pair, launch-template, local-gateway, local-gateway-route-table, local-gateway-virtual-interface, local-gateway-virtual-interface-group, local-gateway-route-table-vpc-association, local-gateway-route-table-virtual-interface-group-association, natgateway, network-acl, network-interface, network-insights-analysis, network-insights-path, network-insights-access-scope, network-insights-access-scope-analysis, outpost-lag, placement-group, prefix-list, replace-root-volume-task, reserved-instances, route-table, security-group, security-group-rule, service-link-virtual-interface, snapshot, spot-fleet-request, spot-instances-request, subnet, subnet-cidr-reservation, traffic-mirror-filter, traffic-mirror-session, traffic-mirror-target, transit-gateway, transit-gateway-attachment, transit-gateway-connect-peer, transit-gateway-multicast-domain, transit-gateway-policy-table, transit-gateway-route-table, transit-gateway-route-table-announcement, volume, vpc, vpc-endpoint, vpc-endpoint-connection, vpc-endpoint-service, vpc-endpoint-service-permission, vpc-peering-connection, vpn-connection, vpn-gateway, vpc-flow-log, capacity-reservation-fleet, traffic-mirror-filter-rule, vpc-endpoint-connection-device-type, verified-access-instance, verified-access-group, verified-access-endpoint, verified-access-policy, verified-access-trust-provider, vpn-connection-device-type, vpc-block-public-access-exclusion, route-server, route-server-endpoint, route-server-peer, ipam-resource-discovery, ipam-resource-discovery-association, instance-connect-endpoint, verified-access-endpoint-target, ipam-external-resource-verification-token, capacity-block, mac-modification-task
     #         tags: [
     #           {
     #             key: "String",
@@ -778,6 +794,7 @@ module Aws::EC2
     #         ],
     #       },
     #     ],
+    #     snapshot_location: "regional", # accepts regional, local
     #     dry_run: false,
     #     name: "String", # required
     #     description: "String",
@@ -793,8 +810,10 @@ module Aws::EC2
     #           kms_key_id: "String",
     #           throughput: 1,
     #           outpost_arn: "String",
+    #           availability_zone: "String",
     #           encrypted: false,
     #           volume_initialization_rate: 1,
+    #           availability_zone_id: "String",
     #         },
     #         no_device: "String",
     #         device_name: "String",
@@ -822,6 +841,21 @@ module Aws::EC2
     #
     #
     #   [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateTags.html
+    # @option options [String] :snapshot_location
+    #   <note markdown="1"> Only supported for instances in Local Zones. If the source instance is
+    #   not in a Local Zone, omit this parameter.
+    #
+    #    </note>
+    #
+    #   The Amazon S3 location where the snapshots will be stored.
+    #
+    #   * To create local snapshots in the same Local Zone as the source
+    #     instance, specify `local`.
+    #
+    #   * To create regional snapshots in the parent Region of the Local Zone,
+    #     specify `regional` or omit this parameter.
+    #
+    #   Default: `regional`
     # @option options [Boolean] :dry_run
     #   Checks whether you have the required permissions for the action,
     #   without actually making the request, and provides an error response.
@@ -863,7 +897,7 @@ module Aws::EC2
     #     snapshots. To create an AMI with volumes or snapshots that have a
     #     different encryption status (for example, where the source volume
     #     and snapshots are unencrypted, and you want to create an AMI with
-    #     encrypted volumes or snapshots), use the CopyImage action.
+    #     encrypted volumes or snapshots), copy the image instead.
     #
     #   * The only option that can be changed for existing mappings or
     #     snapshots is `DeleteOnTermination`.
@@ -1140,7 +1174,7 @@ module Aws::EC2
     #   value is specified for `DeleteOnTermination`, the default is `true`
     #   and the volume is deleted when the instance is terminated. You can't
     #   modify the `DeleteOnTermination` attribute for volumes that are
-    #   attached to Fargate tasks.
+    #   attached to Amazon Web Services-managed resources.
     #
     #   To add instance store volumes to an Amazon EBS-backed instance, you
     #   must add them when you launch the instance. For more information, see
@@ -1468,6 +1502,7 @@ module Aws::EC2
     #
     #   instance.stop({
     #     hibernate: false,
+    #     skip_os_shutdown: false,
     #     dry_run: false,
     #     force: false,
     #   })
@@ -1475,7 +1510,7 @@ module Aws::EC2
     # @option options [Boolean] :hibernate
     #   Hibernates the instance if the instance was enabled for hibernation at
     #   launch. If the instance cannot hibernate successfully, a normal
-    #   shutdown occurs. For more information, see [Hibernate your
+    #   shutdown occurs. For more information, see [Hibernate your Amazon EC2
     #   instance][1] in the *Amazon EC2 User Guide*.
     #
     #   Default: `false`
@@ -1483,6 +1518,15 @@ module Aws::EC2
     #
     #
     #   [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Hibernate.html
+    # @option options [Boolean] :skip_os_shutdown
+    #   Specifies whether to bypass the graceful OS shutdown process when the
+    #   instance is stopped.
+    #
+    #   Bypassing the graceful OS shutdown might result in data loss or
+    #   corruption (for example, memory contents not flushed to disk or loss
+    #   of in-flight IOs) or skipped shutdown scripts.
+    #
+    #   Default: `false`
     # @option options [Boolean] :dry_run
     #   Checks whether you have the required permissions for the operation,
     #   without actually making the request, and provides an error response.
@@ -1517,9 +1561,22 @@ module Aws::EC2
     # @example Request syntax with placeholder values
     #
     #   instance.terminate({
+    #     force: false,
+    #     skip_os_shutdown: false,
     #     dry_run: false,
     #   })
     # @param [Hash] options ({})
+    # @option options [Boolean] :force
+    #   Forces the instances to terminate. The instance will first attempt a
+    #   graceful shutdown, which includes flushing file system caches and
+    #   metadata. If the graceful shutdown fails to complete within the
+    #   timeout period, the instance shuts down forcibly without flushing the
+    #   file system caches and metadata.
+    # @option options [Boolean] :skip_os_shutdown
+    #   Specifies whether to bypass the graceful OS shutdown process when the
+    #   instance is terminated.
+    #
+    #   Default: `false`
     # @option options [Boolean] :dry_run
     #   Checks whether you have the required permissions for the operation,
     #   without actually making the request, and provides an error response.
@@ -1671,6 +1728,9 @@ module Aws::EC2
     #   * `availability-zone` - The Availability Zone in which the volume was
     #     created.
     #
+    #   * `availability-zone-id` - The ID of the Availability Zone in which
+    #     the volume was created.
+    #
     #   * `create-time` - The time stamp when the volume was created.
     #
     #   * `encrypted` - Indicates whether the volume is encrypted (`true` \|
@@ -2045,6 +2105,7 @@ module Aws::EC2
       #
       #   instance.batch_stop({
       #     hibernate: false,
+      #     skip_os_shutdown: false,
       #     dry_run: false,
       #     force: false,
       #   })
@@ -2052,7 +2113,7 @@ module Aws::EC2
       # @option options [Boolean] :hibernate
       #   Hibernates the instance if the instance was enabled for hibernation at
       #   launch. If the instance cannot hibernate successfully, a normal
-      #   shutdown occurs. For more information, see [Hibernate your
+      #   shutdown occurs. For more information, see [Hibernate your Amazon EC2
       #   instance][1] in the *Amazon EC2 User Guide*.
       #
       #   Default: `false`
@@ -2060,6 +2121,15 @@ module Aws::EC2
       #
       #
       #   [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Hibernate.html
+      # @option options [Boolean] :skip_os_shutdown
+      #   Specifies whether to bypass the graceful OS shutdown process when the
+      #   instance is stopped.
+      #
+      #   Bypassing the graceful OS shutdown might result in data loss or
+      #   corruption (for example, memory contents not flushed to disk or loss
+      #   of in-flight IOs) or skipped shutdown scripts.
+      #
+      #   Default: `false`
       # @option options [Boolean] :dry_run
       #   Checks whether you have the required permissions for the operation,
       #   without actually making the request, and provides an error response.
@@ -2100,9 +2170,22 @@ module Aws::EC2
       # @example Request syntax with placeholder values
       #
       #   instance.batch_terminate!({
+      #     force: false,
+      #     skip_os_shutdown: false,
       #     dry_run: false,
       #   })
       # @param options ({})
+      # @option options [Boolean] :force
+      #   Forces the instances to terminate. The instance will first attempt a
+      #   graceful shutdown, which includes flushing file system caches and
+      #   metadata. If the graceful shutdown fails to complete within the
+      #   timeout period, the instance shuts down forcibly without flushing the
+      #   file system caches and metadata.
+      # @option options [Boolean] :skip_os_shutdown
+      #   Specifies whether to bypass the graceful OS shutdown process when the
+      #   instance is terminated.
+      #
+      #   Default: `false`
       # @option options [Boolean] :dry_run
       #   Checks whether you have the required permissions for the operation,
       #   without actually making the request, and provides an error response.

data/lib/aws-sdk-ec2/network_interface.rb

@@ -103,12 +103,39 @@ module Aws::EC2
       data[:owner_id]
     end
 
-    # The private DNS name.
+    # The private hostname. For more information, see [EC2 instance
+    # hostnames, DNS names, and domains][1] in the *Amazon EC2 User Guide*.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-naming.html
     # @return [String]
     def private_dns_name
       data[:private_dns_name]
     end
 
+    # A public hostname. For more information, see [EC2 instance hostnames,
+    # DNS names, and domains][1] in the *Amazon EC2 User Guide*.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-naming.html
+    # @return [String]
+    def public_dns_name
+      data[:public_dns_name]
+    end
+
+    # Public hostname type options. For more information, see [EC2 instance
+    # hostnames, DNS names, and domains][1] in the *Amazon EC2 User Guide*.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-naming.html
+    # @return [Types::PublicIpDnsNameOptions]
+    def public_ip_dns_name_options
+      data[:public_ip_dns_name_options]
+    end
+
     # The IPv4 address of the network interface within the subnet.
     # @return [String]
     def private_ip_address
@@ -207,6 +234,12 @@ module Aws::EC2
       data[:operator]
     end
 
+    # The subnets associated with this network interface.
+    # @return [Array<String>]
+    def associated_subnets
+      data[:associated_subnets]
+    end
+
     # @!endgroup
 
     # @return [Client]
@@ -617,6 +650,7 @@ module Aws::EC2
     #       udp_timeout: 1,
     #     },
     #     associate_public_ip_address: false,
+    #     associated_subnet_ids: ["SubnetId"],
     #     dry_run: false,
     #     description: "value", # value <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
     #     source_dest_check: {
@@ -656,6 +690,8 @@ module Aws::EC2
     #   Indicates whether to assign a public IPv4 address to a network
     #   interface. This option can be enabled for any network interface but
     #   will only apply to the primary network interface (eth0).
+    # @option options [Array<String>] :associated_subnet_ids
+    #   A list of subnet IDs to associate with the network interface.
     # @option options [Boolean] :dry_run
     #   Checks whether you have the required permissions for the action,
     #   without actually making the request, and provides an error response.

data/lib/aws-sdk-ec2/placement_group.rb

@@ -272,6 +272,9 @@ module Aws::EC2
     #
     #   * `availability-zone` - The Availability Zone of the instance.
     #
+    #   * `availability-zone-id` - The ID of the Availability Zone of the
+    #     instance.
+    #
     #   * `block-device-mapping.attach-time` - The attach time for an EBS
     #     volume mapped to the instance, for example,
     #     `2022-09-15T17:15:20.000Z`.
@@ -598,15 +601,16 @@ module Aws::EC2
     #
     #   * `platform-details` - The platform (`Linux/UNIX` \| `Red Hat BYOL
     #     Linux` \| ` Red Hat Enterprise Linux` \| `Red Hat Enterprise Linux
-    #     with HA` \| `Red Hat Enterprise Linux with SQL Server Standard and
-    #     HA` \| `Red Hat Enterprise Linux with SQL Server Enterprise and HA`
-    #     \| `Red Hat Enterprise Linux with SQL Server Standard` \| `Red Hat
-    #     Enterprise Linux with SQL Server Web` \| `Red Hat Enterprise Linux
-    #     with SQL Server Enterprise` \| `SQL Server Enterprise` \| `SQL
-    #     Server Standard` \| `SQL Server Web` \| `SUSE Linux` \| `Ubuntu Pro`
-    #     \| `Windows` \| `Windows BYOL` \| `Windows with SQL Server
-    #     Enterprise` \| `Windows with SQL Server Standard` \| `Windows with
-    #     SQL Server Web`).
+    #     with HA` \| `Red Hat Enterprise Linux with High Availability` \|
+    #     `Red Hat Enterprise Linux with SQL Server Standard and HA` \| `Red
+    #     Hat Enterprise Linux with SQL Server Enterprise and HA` \| `Red Hat
+    #     Enterprise Linux with SQL Server Standard` \| `Red Hat Enterprise
+    #     Linux with SQL Server Web` \| `Red Hat Enterprise Linux with SQL
+    #     Server Enterprise` \| `SQL Server Enterprise` \| `SQL Server
+    #     Standard` \| `SQL Server Web` \| `SUSE Linux` \| `Ubuntu Pro` \|
+    #     `Windows` \| `Windows BYOL` \| `Windows with SQL Server Enterprise`
+    #     \| `Windows with SQL Server Standard` \| `Windows with SQL Server
+    #     Web`).
     #
     #   * `private-dns-name` - The private IPv4 DNS name of the instance.
     #