aws-sdk-ec2 1.574.0 → 1.575.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 217d7a59a65bb261fe86dda86fb9ef23d78cba68588de8895809dbe9f9cade4a
-  data.tar.gz: 708972b2b0ea8219b8d70a4edb03ce352d293c5d860d17516e53052a152f6ad9
+  metadata.gz: 69f8898f04c9437087026b71db792aa441ab3711d3ab27322cb2b34f91ab66e2
+  data.tar.gz: e753c771a878d6f399c7494f239cb47c698baa1ae7cc5680c2df46f2af337485
 SHA512:
-  metadata.gz: 123fa1696aeca604a26bc152ca3374e2d46df7798654c8755c51d9666f7cb4e999382ba53e4552b6766275211bd9bb76bd110ce4d4982ed71545d83d1bb8599e
-  data.tar.gz: a52121ea571166a8448a6bfcaa1de5a0ef2f54003b19cc1c31ee035fc26e07dd92e228e2941000e479a0ff6b78afa39a3a33ec743a35a5df2b1eeed3f972dd65
+  metadata.gz: ea578468ecea7ae8865893210e0a9bbcd806bdb4df59a7ba75f71baa7f7828392aad1611f090fd3763fb6b2b463e57d38268a7ac58d991d56952bb3a6493540a
+  data.tar.gz: 98696d6bbfec52b92c7a756d55b5cdef9b3a37868c4240bf55f1c8029bf73e91bdaae40c49531cd1338bb604ac63b3c5d8d76acdf2620c89f71dc4fc9f5b95fa

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.575.0 (2025-11-12)
+------------------
+
+* Feature - Adds complete AMI ancestry tracing from immediate parent through each preceding generation back to the root AMI
+
 1.574.0 (2025-11-11)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.574.0
+1.575.0

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

@@ -49253,6 +49253,52 @@ module Aws::EC2
       req.send_request(options)
     end
 
+    # Retrieves the ancestry chain of the specified AMI, tracing its lineage
+    # back to the root AMI. For more information, see [AMI ancestry][1] in
+    # *Amazon EC2 User Guide*.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-ancestry.html
+    #
+    # @option params [required, String] :image_id
+    #   The ID of the AMI whose ancestry you want to trace.
+    #
+    # @option params [Boolean] :dry_run
+    #   Checks whether you have the required permissions for the action,
+    #   without actually making the request, and provides an error response.
+    #   If you have the required permissions, the error response is
+    #   `DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.
+    #
+    # @return [Types::GetImageAncestryResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetImageAncestryResult#image_ancestry_entries #image_ancestry_entries} => Array<Types::ImageAncestryEntry>
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_image_ancestry({
+    #     image_id: "ImageId", # required
+    #     dry_run: false,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.image_ancestry_entries #=> Array
+    #   resp.image_ancestry_entries[0].creation_date #=> Time
+    #   resp.image_ancestry_entries[0].image_id #=> String
+    #   resp.image_ancestry_entries[0].image_owner_alias #=> String
+    #   resp.image_ancestry_entries[0].source_image_id #=> String
+    #   resp.image_ancestry_entries[0].source_image_region #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/GetImageAncestry AWS API Documentation
+    #
+    # @overload get_image_ancestry(params = {})
+    # @param [Hash] params ({})
+    def get_image_ancestry(params = {}, options = {})
+      req = build_request(:get_image_ancestry, params)
+      req.send_request(options)
+    end
+
     # Gets the current state of *block public access for AMIs* at the
     # account level in the specified Amazon Web Services Region.
     #
@@ -69165,7 +69211,7 @@ module Aws::EC2
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-ec2'
-      context[:gem_version] = '1.574.0'
+      context[:gem_version] = '1.575.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -1727,6 +1727,8 @@ module Aws::EC2
     GetGroupsForCapacityReservationResult = Shapes::StructureShape.new(name: 'GetGroupsForCapacityReservationResult')
     GetHostReservationPurchasePreviewRequest = Shapes::StructureShape.new(name: 'GetHostReservationPurchasePreviewRequest')
     GetHostReservationPurchasePreviewResult = Shapes::StructureShape.new(name: 'GetHostReservationPurchasePreviewResult')
+    GetImageAncestryRequest = Shapes::StructureShape.new(name: 'GetImageAncestryRequest')
+    GetImageAncestryResult = Shapes::StructureShape.new(name: 'GetImageAncestryResult')
     GetImageBlockPublicAccessStateRequest = Shapes::StructureShape.new(name: 'GetImageBlockPublicAccessStateRequest')
     GetImageBlockPublicAccessStateResult = Shapes::StructureShape.new(name: 'GetImageBlockPublicAccessStateResult')
     GetInstanceMetadataDefaultsRequest = Shapes::StructureShape.new(name: 'GetInstanceMetadataDefaultsRequest')
@@ -1875,6 +1877,8 @@ module Aws::EC2
     IdFormatList = Shapes::ListShape.new(name: 'IdFormatList')
     Igmpv2SupportValue = Shapes::StringShape.new(name: 'Igmpv2SupportValue')
     Image = Shapes::StructureShape.new(name: 'Image')
+    ImageAncestryEntry = Shapes::StructureShape.new(name: 'ImageAncestryEntry')
+    ImageAncestryEntryList = Shapes::ListShape.new(name: 'ImageAncestryEntryList')
     ImageAttribute = Shapes::StructureShape.new(name: 'ImageAttribute')
     ImageAttributeName = Shapes::StringShape.new(name: 'ImageAttributeName')
     ImageBlockPublicAccessDisabledState = Shapes::StringShape.new(name: 'ImageBlockPublicAccessDisabledState')
@@ -10801,6 +10805,13 @@ module Aws::EC2
     GetHostReservationPurchasePreviewResult.add_member(:total_upfront_price, Shapes::ShapeRef.new(shape: String, location_name: "totalUpfrontPrice"))
     GetHostReservationPurchasePreviewResult.struct_class = Types::GetHostReservationPurchasePreviewResult
 
+    GetImageAncestryRequest.add_member(:image_id, Shapes::ShapeRef.new(shape: ImageId, required: true, location_name: "ImageId"))
+    GetImageAncestryRequest.add_member(:dry_run, Shapes::ShapeRef.new(shape: Boolean, location_name: "DryRun"))
+    GetImageAncestryRequest.struct_class = Types::GetImageAncestryRequest
+
+    GetImageAncestryResult.add_member(:image_ancestry_entries, Shapes::ShapeRef.new(shape: ImageAncestryEntryList, location_name: "imageAncestryEntrySet"))
+    GetImageAncestryResult.struct_class = Types::GetImageAncestryResult
+
     GetImageBlockPublicAccessStateRequest.add_member(:dry_run, Shapes::ShapeRef.new(shape: Boolean, location_name: "DryRun"))
     GetImageBlockPublicAccessStateRequest.struct_class = Types::GetImageBlockPublicAccessStateRequest
 
@@ -11453,6 +11464,15 @@ module Aws::EC2
     Image.add_member(:platform, Shapes::ShapeRef.new(shape: PlatformValues, location_name: "platform"))
     Image.struct_class = Types::Image
 
+    ImageAncestryEntry.add_member(:creation_date, Shapes::ShapeRef.new(shape: MillisecondDateTime, location_name: "creationDate"))
+    ImageAncestryEntry.add_member(:image_id, Shapes::ShapeRef.new(shape: ImageId, location_name: "imageId"))
+    ImageAncestryEntry.add_member(:image_owner_alias, Shapes::ShapeRef.new(shape: String, location_name: "imageOwnerAlias"))
+    ImageAncestryEntry.add_member(:source_image_id, Shapes::ShapeRef.new(shape: ImageId, location_name: "sourceImageId"))
+    ImageAncestryEntry.add_member(:source_image_region, Shapes::ShapeRef.new(shape: String, location_name: "sourceImageRegion"))
+    ImageAncestryEntry.struct_class = Types::ImageAncestryEntry
+
+    ImageAncestryEntryList.member = Shapes::ShapeRef.new(shape: ImageAncestryEntry, location_name: "item")
+
     ImageAttribute.add_member(:description, Shapes::ShapeRef.new(shape: AttributeValue, location_name: "description"))
     ImageAttribute.add_member(:kernel_id, Shapes::ShapeRef.new(shape: AttributeValue, location_name: "kernel"))
     ImageAttribute.add_member(:ramdisk_id, Shapes::ShapeRef.new(shape: AttributeValue, location_name: "ramdisk"))
@@ -23410,6 +23430,14 @@ module Aws::EC2
         o.output = Shapes::ShapeRef.new(shape: GetHostReservationPurchasePreviewResult)
       end)
 
+      api.add_operation(:get_image_ancestry, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetImageAncestry"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: GetImageAncestryRequest)
+        o.output = Shapes::ShapeRef.new(shape: GetImageAncestryResult)
+      end)
+
       api.add_operation(:get_image_block_public_access_state, Seahorse::Model::Operation.new.tap do |o|
         o.name = "GetImageBlockPublicAccessState"
         o.http_method = "POST"

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

@@ -41941,6 +41941,39 @@ module Aws::EC2
       include Aws::Structure
     end
 
+    # @!attribute [rw] image_id
+    #   The ID of the AMI whose ancestry you want to trace.
+    #   @return [String]
+    #
+    # @!attribute [rw] dry_run
+    #   Checks whether you have the required permissions for the action,
+    #   without actually making the request, and provides an error response.
+    #   If you have the required permissions, the error response is
+    #   `DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.
+    #   @return [Boolean]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/GetImageAncestryRequest AWS API Documentation
+    #
+    class GetImageAncestryRequest < Struct.new(
+      :image_id,
+      :dry_run)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] image_ancestry_entries
+    #   A list of entries in the AMI ancestry chain, from the specified AMI
+    #   to the root AMI.
+    #   @return [Array<Types::ImageAncestryEntry>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/GetImageAncestryResult AWS API Documentation
+    #
+    class GetImageAncestryResult < Struct.new(
+      :image_ancestry_entries)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] dry_run
     #   Checks whether you have the required permissions for the action,
     #   without actually making the request, and provides an error response.
@@ -45368,6 +45401,42 @@ module Aws::EC2
       include Aws::Structure
     end
 
+    # Information about a single AMI in the ancestry chain and its source
+    # (parent) AMI.
+    #
+    # @!attribute [rw] creation_date
+    #   The date and time when this AMI was created.
+    #   @return [Time]
+    #
+    # @!attribute [rw] image_id
+    #   The ID of this AMI.
+    #   @return [String]
+    #
+    # @!attribute [rw] image_owner_alias
+    #   The owner alias (`amazon` \| `aws-backup-vault` \| `aws-marketplace`
+    #   ) of this AMI, if one is assigned. Otherwise, the value is `null`.
+    #   @return [String]
+    #
+    # @!attribute [rw] source_image_id
+    #   The ID of the parent AMI.
+    #   @return [String]
+    #
+    # @!attribute [rw] source_image_region
+    #   The Amazon Web Services Region of the parent AMI.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/ImageAncestryEntry AWS API Documentation
+    #
+    class ImageAncestryEntry < Struct.new(
+      :creation_date,
+      :image_id,
+      :image_owner_alias,
+      :source_image_id,
+      :source_image_region)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Describes an image attribute.
     #
     # @!attribute [rw] description

data/lib/aws-sdk-ec2.rb

@@ -78,7 +78,7 @@ module Aws::EC2
   autoload :VpcPeeringConnection, 'aws-sdk-ec2/vpc_peering_connection'
   autoload :VpcAddress, 'aws-sdk-ec2/vpc_address'
 
-  GEM_VERSION = '1.574.0'
+  GEM_VERSION = '1.575.0'
 
 end
 

data/sig/client.rbs

@@ -10187,6 +10187,17 @@ module Aws
                                                  ) -> _GetHostReservationPurchasePreviewResponseSuccess
                                                | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _GetHostReservationPurchasePreviewResponseSuccess
 
+      interface _GetImageAncestryResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::GetImageAncestryResult]
+        def image_ancestry_entries: () -> ::Array[Types::ImageAncestryEntry]
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/EC2/Client.html#get_image_ancestry-instance_method
+      def get_image_ancestry: (
+                                image_id: ::String,
+                                ?dry_run: bool
+                              ) -> _GetImageAncestryResponseSuccess
+                            | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _GetImageAncestryResponseSuccess
+
       interface _GetImageBlockPublicAccessStateResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::GetImageBlockPublicAccessStateResult]
         def image_block_public_access_state: () -> ::String

data/sig/types.rbs

@@ -9188,6 +9188,17 @@ module Aws::EC2
       SENSITIVE: []
     end
 
+    class GetImageAncestryRequest
+      attr_accessor image_id: ::String
+      attr_accessor dry_run: bool
+      SENSITIVE: []
+    end
+
+    class GetImageAncestryResult
+      attr_accessor image_ancestry_entries: ::Array[Types::ImageAncestryEntry]
+      SENSITIVE: []
+    end
+
     class GetImageBlockPublicAccessStateRequest
       attr_accessor dry_run: bool
       SENSITIVE: []
@@ -10018,6 +10029,15 @@ module Aws::EC2
       SENSITIVE: []
     end
 
+    class ImageAncestryEntry
+      attr_accessor creation_date: ::Time
+      attr_accessor image_id: ::String
+      attr_accessor image_owner_alias: ::String
+      attr_accessor source_image_id: ::String
+      attr_accessor source_image_region: ::String
+      SENSITIVE: []
+    end
+
     class ImageAttribute
       attr_accessor description: Types::AttributeValue
       attr_accessor kernel_id: Types::AttributeValue

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-ec2
 version: !ruby/object:Gem::Version
-  version: 1.574.0
+  version: 1.575.0
 platform: ruby
 authors:
 - Amazon Web Services