aws-sdk-cloudfront 1.143.0 → 1.144.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eed0a43fb9e14823c08fecea648a5d46e549c625a2e35c20454755fabeb6999f
-  data.tar.gz: a27d84997c4fcc42166e652d5a192296097eabedcd5a3611f3276b7c0024ea2e
+  metadata.gz: e61bf16c6e548cd2a0d7ade815e3ab817a4e3c6e62e99015dc940cfc7b0c9438
+  data.tar.gz: 5eb57bac8e6a735821ff70bcb323919b096fbc7e409e410f80245f1ccd4f2c8a
 SHA512:
-  metadata.gz: 90406f320290d4e0749a3facd2d5e872423ba04fe403544ca1759e36803b3a91cd5b1af5e9adfabb3b7437709f553a04338325deb3dd4441a7e243a4fe1bb43b
-  data.tar.gz: 7b3b292901a05fee244fb3d609a842477f84a9a372ec9da42fc847871d73e3f966f20ed92a67b21d190a9b287dcb7001c2e896e8060b2a4d48725bd2eaa2e70c
+  metadata.gz: 450e54526aaa89f915b2f6a722e575c8a1afafe295e5949987552836988b1e76732f0cd692d9d97f4b53e1231e01372e4a65d0d6097db5164b27600faf7a2ca6
+  data.tar.gz: 4254e29919b566c8f692fce374a4e693c609b59a8b3da24537f7ac557dc8efda9a60bd3b579430c6397a32cc0d3f46dc8d6b84dde5a3447b7dab190cca641355

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.144.0 (2026-04-29)
+------------------
+
+* Feature - Amazon CloudFront now supports cache tag. Tag objects via response headers and invalidate all matching objects in a single request, replacing manual URL tracking and broad wildcards.
+
 1.143.0 (2026-03-31)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.143.0
+1.144.0

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

@@ -889,6 +889,7 @@ module Aws::CloudFront
     #   resp.distribution.distribution_config.viewer_mtls_config.trust_store_config.advertise_trust_store_ca_names #=> Boolean
     #   resp.distribution.distribution_config.viewer_mtls_config.trust_store_config.ignore_certificate_expiry #=> Boolean
     #   resp.distribution.distribution_config.connection_function_association.id #=> String
+    #   resp.distribution.distribution_config.cache_tag_config.header_name #=> String
     #   resp.distribution.alias_icp_recordals #=> Array
     #   resp.distribution.alias_icp_recordals[0].cname #=> String
     #   resp.distribution.alias_icp_recordals[0].icp_recordal_status #=> String, one of "APPROVED", "SUSPENDED", "PENDING"
@@ -1683,6 +1684,9 @@ module Aws::CloudFront
     #       connection_function_association: {
     #         id: "ResourceId", # required
     #       },
+    #       cache_tag_config: {
+    #         header_name: "string", # required
+    #       },
     #     },
     #   })
     #
@@ -1892,6 +1896,7 @@ module Aws::CloudFront
     #   resp.distribution.distribution_config.viewer_mtls_config.trust_store_config.advertise_trust_store_ca_names #=> Boolean
     #   resp.distribution.distribution_config.viewer_mtls_config.trust_store_config.ignore_certificate_expiry #=> Boolean
     #   resp.distribution.distribution_config.connection_function_association.id #=> String
+    #   resp.distribution.distribution_config.cache_tag_config.header_name #=> String
     #   resp.distribution.alias_icp_recordals #=> Array
     #   resp.distribution.alias_icp_recordals[0].cname #=> String
     #   resp.distribution.alias_icp_recordals[0].icp_recordal_status #=> String, one of "APPROVED", "SUSPENDED", "PENDING"
@@ -2364,6 +2369,9 @@ module Aws::CloudFront
     #         connection_function_association: {
     #           id: "ResourceId", # required
     #         },
+    #         cache_tag_config: {
+    #           header_name: "string", # required
+    #         },
     #       },
     #       tags: { # required
     #         items: [
@@ -2582,6 +2590,7 @@ module Aws::CloudFront
     #   resp.distribution.distribution_config.viewer_mtls_config.trust_store_config.advertise_trust_store_ca_names #=> Boolean
     #   resp.distribution.distribution_config.viewer_mtls_config.trust_store_config.ignore_certificate_expiry #=> Boolean
     #   resp.distribution.distribution_config.connection_function_association.id #=> String
+    #   resp.distribution.distribution_config.cache_tag_config.header_name #=> String
     #   resp.distribution.alias_icp_recordals #=> Array
     #   resp.distribution.alias_icp_recordals[0].cname #=> String
     #   resp.distribution.alias_icp_recordals[0].icp_recordal_status #=> String, one of "APPROVED", "SUSPENDED", "PENDING"
@@ -5658,6 +5667,7 @@ module Aws::CloudFront
     #   resp.distribution.distribution_config.viewer_mtls_config.trust_store_config.advertise_trust_store_ca_names #=> Boolean
     #   resp.distribution.distribution_config.viewer_mtls_config.trust_store_config.ignore_certificate_expiry #=> Boolean
     #   resp.distribution.distribution_config.connection_function_association.id #=> String
+    #   resp.distribution.distribution_config.cache_tag_config.header_name #=> String
     #   resp.distribution.alias_icp_recordals #=> Array
     #   resp.distribution.alias_icp_recordals[0].cname #=> String
     #   resp.distribution.alias_icp_recordals[0].icp_recordal_status #=> String, one of "APPROVED", "SUSPENDED", "PENDING"
@@ -5880,6 +5890,7 @@ module Aws::CloudFront
     #   resp.distribution_config.viewer_mtls_config.trust_store_config.advertise_trust_store_ca_names #=> Boolean
     #   resp.distribution_config.viewer_mtls_config.trust_store_config.ignore_certificate_expiry #=> Boolean
     #   resp.distribution_config.connection_function_association.id #=> String
+    #   resp.distribution_config.cache_tag_config.header_name #=> String
     #   resp.etag #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudfront-2020-05-31/GetDistributionConfig AWS API Documentation
@@ -11898,6 +11909,9 @@ module Aws::CloudFront
     #       connection_function_association: {
     #         id: "ResourceId", # required
     #       },
+    #       cache_tag_config: {
+    #         header_name: "string", # required
+    #       },
     #     },
     #     id: "string", # required
     #     if_match: "string",
@@ -12109,6 +12123,7 @@ module Aws::CloudFront
     #   resp.distribution.distribution_config.viewer_mtls_config.trust_store_config.advertise_trust_store_ca_names #=> Boolean
     #   resp.distribution.distribution_config.viewer_mtls_config.trust_store_config.ignore_certificate_expiry #=> Boolean
     #   resp.distribution.distribution_config.connection_function_association.id #=> String
+    #   resp.distribution.distribution_config.cache_tag_config.header_name #=> String
     #   resp.distribution.alias_icp_recordals #=> Array
     #   resp.distribution.alias_icp_recordals[0].cname #=> String
     #   resp.distribution.alias_icp_recordals[0].icp_recordal_status #=> String, one of "APPROVED", "SUSPENDED", "PENDING"
@@ -12507,6 +12522,7 @@ module Aws::CloudFront
     #   resp.distribution.distribution_config.viewer_mtls_config.trust_store_config.advertise_trust_store_ca_names #=> Boolean
     #   resp.distribution.distribution_config.viewer_mtls_config.trust_store_config.ignore_certificate_expiry #=> Boolean
     #   resp.distribution.distribution_config.connection_function_association.id #=> String
+    #   resp.distribution.distribution_config.cache_tag_config.header_name #=> String
     #   resp.distribution.alias_icp_recordals #=> Array
     #   resp.distribution.alias_icp_recordals[0].cname #=> String
     #   resp.distribution.alias_icp_recordals[0].icp_recordal_status #=> String, one of "APPROVED", "SUSPENDED", "PENDING"
@@ -13766,7 +13782,7 @@ module Aws::CloudFront
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-cloudfront'
-      context[:gem_version] = '1.143.0'
+      context[:gem_version] = '1.144.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -60,6 +60,7 @@ module Aws::CloudFront
     CachePolicySummary = Shapes::StructureShape.new(name: 'CachePolicySummary')
     CachePolicySummaryList = Shapes::ListShape.new(name: 'CachePolicySummaryList')
     CachePolicyType = Shapes::StringShape.new(name: 'CachePolicyType')
+    CacheTagConfig = Shapes::StructureShape.new(name: 'CacheTagConfig')
     CachedMethods = Shapes::StructureShape.new(name: 'CachedMethods')
     CannotChangeImmutablePublicKeyFields = Shapes::StructureShape.new(name: 'CannotChangeImmutablePublicKeyFields')
     CannotDeleteEntityWhileInUse = Shapes::StructureShape.new(name: 'CannotDeleteEntityWhileInUse')
@@ -1025,6 +1026,9 @@ module Aws::CloudFront
 
     CachePolicySummaryList.member = Shapes::ShapeRef.new(shape: CachePolicySummary, location_name: "CachePolicySummary")
 
+    CacheTagConfig.add_member(:header_name, Shapes::ShapeRef.new(shape: string, required: true, location_name: "HeaderName"))
+    CacheTagConfig.struct_class = Types::CacheTagConfig
+
     CachedMethods.add_member(:quantity, Shapes::ShapeRef.new(shape: integer, required: true, location_name: "Quantity"))
     CachedMethods.add_member(:items, Shapes::ShapeRef.new(shape: MethodsList, required: true, location_name: "Items"))
     CachedMethods.struct_class = Types::CachedMethods
@@ -1760,6 +1764,7 @@ module Aws::CloudFront
     DistributionConfig.add_member(:connection_mode, Shapes::ShapeRef.new(shape: ConnectionMode, location_name: "ConnectionMode"))
     DistributionConfig.add_member(:viewer_mtls_config, Shapes::ShapeRef.new(shape: ViewerMtlsConfig, location_name: "ViewerMtlsConfig"))
     DistributionConfig.add_member(:connection_function_association, Shapes::ShapeRef.new(shape: ConnectionFunctionAssociation, location_name: "ConnectionFunctionAssociation"))
+    DistributionConfig.add_member(:cache_tag_config, Shapes::ShapeRef.new(shape: CacheTagConfig, location_name: "CacheTagConfig"))
     DistributionConfig.struct_class = Types::DistributionConfig
 
     DistributionConfigWithTags.add_member(:distribution_config, Shapes::ShapeRef.new(shape: DistributionConfig, required: true, location_name: "DistributionConfig"))

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

@@ -1353,6 +1353,28 @@ module Aws::CloudFront
       include Aws::Structure
     end
 
+    # A complex type that specifies the HTTP header name from which
+    # CloudFront extracts cache tags from origin responses. When you add
+    # `CacheTagConfig` to a distribution, CloudFront reads the specified
+    # header from origin responses, parses the comma-separated tag values,
+    # and stores them with the cached object. You can then invalidate cached
+    # objects by tag using the `CreateInvalidation` API.
+    #
+    # @!attribute [rw] header_name
+    #   The name of the HTTP header that your origin includes in responses.
+    #   CloudFront uses this header to extract cache tags. The header value
+    #   must contain comma-separated tag values (for example,
+    #   `product:electronics, category:tv, brand:example`).
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudfront-2020-05-31/CacheTagConfig AWS API Documentation
+    #
+    class CacheTagConfig < Struct.new(
+      :header_name)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # A complex type that controls whether CloudFront caches the response to
     # requests using the specified HTTP methods. There are two choices:
     #
@@ -5239,6 +5261,27 @@ module Aws::CloudFront
     #   The distribution's connection function association.
     #   @return [Types::ConnectionFunctionAssociation]
     #
+    # @!attribute [rw] cache_tag_config
+    #   Configuration for cache tag extraction from origin responses. When
+    #   specified, CloudFront reads the header named in `HeaderName` from
+    #   origin responses and stores the comma-separated values as cache tags
+    #   on the object.
+    #
+    #   Distributions without `CacheTagConfig` do not extract tags. When
+    #   `CacheTagConfig` is removed from a distribution via
+    #   `UpdateDistribution`, CloudFront stops extracting tags from origin
+    #   responses.
+    #
+    #   <note markdown="1"> Changing the `HeaderName` on an existing distribution does not
+    #   retroactively affect previously cached objects. Tag-based
+    #   invalidations will not apply to objects already cached using a
+    #   previous header. To ensure tag invalidations function after updating
+    #   the header name, use path-based invalidations to recache all objects
+    #   that use cache tags.
+    #
+    #    </note>
+    #   @return [Types::CacheTagConfig]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudfront-2020-05-31/DistributionConfig AWS API Documentation
     #
     class DistributionConfig < Struct.new(
@@ -5265,7 +5308,8 @@ module Aws::CloudFront
       :tenant_config,
       :connection_mode,
       :viewer_mtls_config,
-      :connection_function_association)
+      :connection_function_association,
+      :cache_tag_config)
       SENSITIVE = [:comment]
       include Aws::Structure
     end

data/lib/aws-sdk-cloudfront.rb

@@ -55,7 +55,7 @@ module Aws::CloudFront
   autoload :EndpointProvider, 'aws-sdk-cloudfront/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-cloudfront/endpoints'
 
-  GEM_VERSION = '1.143.0'
+  GEM_VERSION = '1.144.0'
 
 end
 

data/sig/client.rbs

@@ -610,6 +610,9 @@ module Aws
                                    }?,
                                    connection_function_association: {
                                      id: ::String
+                                   }?,
+                                   cache_tag_config: {
+                                     header_name: ::String
                                    }?
                                  }
                                ) -> _CreateDistributionResponseSuccess
@@ -974,6 +977,9 @@ module Aws
                                                }?,
                                                connection_function_association: {
                                                  id: ::String
+                                               }?,
+                                               cache_tag_config: {
+                                                 header_name: ::String
                                                }?
                                              },
                                              tags: {
@@ -3152,6 +3158,9 @@ module Aws
                                    }?,
                                    connection_function_association: {
                                      id: ::String
+                                   }?,
+                                   cache_tag_config: {
+                                     header_name: ::String
                                    }?
                                  },
                                  id: ::String,

data/sig/types.rbs

@@ -234,6 +234,11 @@ module Aws::CloudFront
       SENSITIVE: []
     end
 
+    class CacheTagConfig
+      attr_accessor header_name: ::String
+      SENSITIVE: []
+    end
+
     class CachedMethods
       attr_accessor quantity: ::Integer
       attr_accessor items: ::Array[("GET" | "HEAD" | "POST" | "PUT" | "PATCH" | "OPTIONS" | "DELETE")]
@@ -1117,6 +1122,7 @@ module Aws::CloudFront
       attr_accessor connection_mode: ("direct" | "tenant-only")
       attr_accessor viewer_mtls_config: Types::ViewerMtlsConfig
       attr_accessor connection_function_association: Types::ConnectionFunctionAssociation
+      attr_accessor cache_tag_config: Types::CacheTagConfig
       SENSITIVE: [:comment]
     end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-cloudfront
 version: !ruby/object:Gem::Version
-  version: 1.143.0
+  version: 1.144.0
 platform: ruby
 authors:
 - Amazon Web Services