aws-sdk-ec2 1.285.0 → 1.417.0

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

@@ -88,8 +88,8 @@ module Aws::EC2
     end
 
     # The platform details associated with the billing code of the AMI. For
-    # more information, see [Understanding AMI billing][1] in the *Amazon
-    # Elastic Compute Cloud User Guide*.
+    # more information, see [Understand AMI billing information][1] in the
+    # *Amazon EC2 User Guide*.
     #
     #
     #
@@ -157,7 +157,8 @@ module Aws::EC2
       data[:ena_support]
     end
 
-    # The hypervisor type of the image.
+    # The hypervisor type of the image. Only `xen` is supported. `ovm` is
+    # not supported.
     # @return [String]
     def hypervisor
       data[:hypervisor]
@@ -215,7 +216,7 @@ module Aws::EC2
     end
 
     # The boot mode of the image. For more information, see [Boot modes][1]
-    # in the *Amazon Elastic Compute Cloud User Guide*.
+    # in the *Amazon EC2 User Guide*.
     #
     #
     #
@@ -225,14 +226,53 @@ module Aws::EC2
       data[:boot_mode]
     end
 
+    # If the image is configured for NitroTPM support, the value is `v2.0`.
+    # For more information, see [NitroTPM][1] in the *Amazon EC2 User
+    # Guide*.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/nitrotpm.html
+    # @return [String]
+    def tpm_support
+      data[:tpm_support]
+    end
+
     # The date and time to deprecate the AMI, in UTC, in the following
-    # format: *YYYY*-*MM*-*DD*T*HH*\:*MM*\:*SS*Z. If you specified a value
-    # for seconds, Amazon EC2 rounds the seconds to the nearest minute.
+    # format: *YYYY*-*MM*-*DD*T*HH*:*MM*:*SS*Z. If you specified a value for
+    # seconds, Amazon EC2 rounds the seconds to the nearest minute.
     # @return [String]
     def deprecation_time
       data[:deprecation_time]
     end
 
+    # If `v2.0`, it indicates that IMDSv2 is specified in the AMI. Instances
+    # launched from this AMI will have `HttpTokens` automatically set to
+    # `required` so that, by default, the instance requires that IMDSv2 is
+    # used when requesting instance metadata. In addition,
+    # `HttpPutResponseHopLimit` is set to `2`. For more information, see
+    # [Configure the AMI][1] in the *Amazon EC2 User Guide*.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-IMDS-new-instances.html#configure-IMDS-new-instances-ami-configuration
+    # @return [String]
+    def imds_support
+      data[:imds_support]
+    end
+
+    # The ID of the instance that the AMI was created from if the AMI was
+    # created using [CreateImage][1]. This field only appears if the AMI was
+    # created using CreateImage.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateImage.html
+    # @return [String]
+    def source_instance_id
+      data[:source_instance_id]
+    end
+
     # @!endgroup
 
     # @return [Client]
@@ -247,7 +287,9 @@ module Aws::EC2
     #
     # @return [self]
     def load
-      resp = @client.describe_images(image_ids: [@id])
+      resp = Aws::Plugins::UserAgent.feature('resource') do
+        @client.describe_images(image_ids: [@id])
+      end
       @data = resp.images[0]
       self
     end
@@ -292,7 +334,9 @@ module Aws::EC2
       options, params = separate_params_and_options(options)
       waiter = Waiters::ImageExists.new(options)
       yield_waiter_and_warn(waiter, &block) if block_given?
-      resp = waiter.wait(params.merge(image_ids: [@id]))
+      resp = Aws::Plugins::UserAgent.feature('resource') do
+        waiter.wait(params.merge(image_ids: [@id]))
+      end
       Image.new({
         id: @id,
         data: resp.data.images[0],
@@ -394,7 +438,9 @@ module Aws::EC2
           :retry
         end
       end
-      Aws::Waiters::Waiter.new(options).wait({})
+      Aws::Plugins::UserAgent.feature('resource') do
+        Aws::Waiters::Waiter.new(options).wait({})
+      end
     end
 
     # @!group Actions
@@ -424,7 +470,9 @@ module Aws::EC2
     def create_tags(options = {})
       batch = []
       options = Aws::Util.deep_merge(options, resources: [@id])
-      resp = @client.create_tags(options)
+      resp = Aws::Plugins::UserAgent.feature('resource') do
+        @client.create_tags(options)
+      end
       options[:tags].each do |t|
         batch << Tag.new(
           resource_id: @id,
@@ -469,7 +517,9 @@ module Aws::EC2
     def delete_tags(options = {})
       batch = []
       options = Aws::Util.deep_merge(options, resources: [@id])
-      resp = @client.delete_tags(options)
+      resp = Aws::Plugins::UserAgent.feature('resource') do
+        @client.delete_tags(options)
+      end
       options[:tags].each do |t|
         batch << Tag.new(
           resource_id: @id,
@@ -495,24 +545,26 @@ module Aws::EC2
     # @return [EmptyStructure]
     def deregister(options = {})
       options = options.merge(image_id: @id)
-      resp = @client.deregister_image(options)
+      resp = Aws::Plugins::UserAgent.feature('resource') do
+        @client.deregister_image(options)
+      end
       resp.data
     end
 
     # @example Request syntax with placeholder values
     #
     #   image.describe_attribute({
-    #     attribute: "description", # required, accepts description, kernel, ramdisk, launchPermission, productCodes, blockDeviceMapping, sriovNetSupport, bootMode
+    #     attribute: "description", # required, accepts description, kernel, ramdisk, launchPermission, productCodes, blockDeviceMapping, sriovNetSupport, bootMode, tpmSupport, uefiData, lastLaunchedTime, imdsSupport
     #     dry_run: false,
     #   })
     # @param [Hash] options ({})
     # @option options [required, String] :attribute
     #   The AMI attribute.
     #
-    #   **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.
+    #   **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.
     # @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.
@@ -521,7 +573,9 @@ module Aws::EC2
     # @return [Types::ImageAttribute]
     def describe_attribute(options = {})
       options = options.merge(image_id: @id)
-      resp = @client.describe_image_attribute(options)
+      resp = Aws::Plugins::UserAgent.feature('resource') do
+        @client.describe_image_attribute(options)
+      end
       resp.data
     end
 
@@ -556,12 +610,13 @@ module Aws::EC2
     #     dry_run: false,
     #     organization_arns: ["String"],
     #     organizational_unit_arns: ["String"],
+    #     imds_support: "value", # value <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
     #   })
     # @param [Hash] options ({})
     # @option options [String] :attribute
     #   The name of the attribute to modify.
     #
-    #   Valid values: `description` \| `launchPermission`
+    #   Valid values: `description` \| `imdsSupport` \| `launchPermission`
     # @option options [Types::AttributeValue] :description
     #   A new description for the AMI.
     # @option options [Types::LaunchPermissionModifications] :launch_permission
@@ -579,7 +634,7 @@ module Aws::EC2
     #   when the `Attribute` parameter is `launchPermission`.
     # @option options [String] :value
     #   The value of the attribute being modified. This parameter can be used
-    #   only when the `Attribute` parameter is `description`.
+    #   only when the `Attribute` parameter is `description` or `imdsSupport`.
     # @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.
@@ -592,10 +647,27 @@ module Aws::EC2
     #   The Amazon Resource Name (ARN) of an organizational unit (OU). This
     #   parameter can be used only when the `Attribute` parameter is
     #   `launchPermission`.
+    # @option options [Types::AttributeValue] :imds_support
+    #   Set to `v2.0` to indicate that IMDSv2 is specified in the AMI.
+    #   Instances launched from this AMI will have `HttpTokens` automatically
+    #   set to `required` so that, by default, the instance requires that
+    #   IMDSv2 is used when requesting instance metadata. In addition,
+    #   `HttpPutResponseHopLimit` is set to `2`. For more information, see
+    #   [Configure the AMI][1] in the *Amazon EC2 User Guide*.
+    #
+    #   Do not use this parameter unless your AMI software supports IMDSv2.
+    #   After you set the value to `v2.0`, you can't undo it. The only way to
+    #   “reset” your AMI is to create a new AMI from the underlying snapshot.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-IMDS-new-instances.html#configure-IMDS-new-instances-ami-configuration
     # @return [EmptyStructure]
     def modify_attribute(options = {})
       options = options.merge(image_id: @id)
-      resp = @client.modify_image_attribute(options)
+      resp = Aws::Plugins::UserAgent.feature('resource') do
+        @client.modify_image_attribute(options)
+      end
       resp.data
     end
 
@@ -617,7 +689,9 @@ module Aws::EC2
     # @return [EmptyStructure]
     def reset_attribute(options = {})
       options = options.merge(image_id: @id)
-      resp = @client.reset_image_attribute(options)
+      resp = Aws::Plugins::UserAgent.feature('resource') do
+        @client.reset_image_attribute(options)
+      end
       resp.data
     end