aws-sdk-cloudfront 1.143.0 → 1.145.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eed0a43fb9e14823c08fecea648a5d46e549c625a2e35c20454755fabeb6999f
-  data.tar.gz: a27d84997c4fcc42166e652d5a192296097eabedcd5a3611f3276b7c0024ea2e
+  metadata.gz: f4fa9a970dfa9eef6a2c1823df2f942afcc6a6e4b557d9101fc61d57f812fb37
+  data.tar.gz: dfc11f8d4ad1d9e72abe08ee6ea00eb3812edf59ba12a7e940fda1911394b093
 SHA512:
-  metadata.gz: 90406f320290d4e0749a3facd2d5e872423ba04fe403544ca1759e36803b3a91cd5b1af5e9adfabb3b7437709f553a04338325deb3dd4441a7e243a4fe1bb43b
-  data.tar.gz: 7b3b292901a05fee244fb3d609a842477f84a9a372ec9da42fc847871d73e3f966f20ed92a67b21d190a9b287dcb7001c2e896e8060b2a4d48725bd2eaa2e70c
+  metadata.gz: 454737822c8de845a5a804a82d2da111d9dac5c4b9684a64d32cf62253ec379044b80cd17bf44bb34d6bc4cd9e859e1d134d7309f02633b861135aa1bb257718
+  data.tar.gz: 5b17917be34d0bc24af0f24f85545569a84406ee8a5f7a300ede3671c6c08dce8f7829eefc56e694b9e706e6612c72b763d458f002a24cdb2f546c9d8bd6433b

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.145.0 (2026-05-05)
+------------------
+
+* Feature - Adds support for tagging CloudFront Functions and KeyValueStores resources.
+
+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.145.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"
@@ -2763,6 +2772,9 @@ module Aws::CloudFront
     #
     #   [1]: https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/writing-function-code.html
     #
+    # @option params [Types::Tags] :tags
+    #   A complex type that contains zero or more `Tag` elements.
+    #
     # @return [Types::CreateFunctionResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateFunctionResult#function_summary #function_summary} => Types::FunctionSummary
@@ -2836,6 +2848,14 @@ module Aws::CloudFront
     #       },
     #     },
     #     function_code: "data", # required
+    #     tags: {
+    #       items: [
+    #         {
+    #           key: "TagKey", # required
+    #           value: "TagValue",
+    #         },
+    #       ],
+    #     },
     #   })
     #
     # @example Response structure
@@ -3039,6 +3059,9 @@ module Aws::CloudFront
     #   The S3 bucket that provides the source for the import. The source must
     #   be in a valid JSON format.
     #
+    # @option params [Types::Tags] :tags
+    #   A complex type that contains zero or more `Tag` elements.
+    #
     # @return [Types::CreateKeyValueStoreResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateKeyValueStoreResult#key_value_store #key_value_store} => Types::KeyValueStore
@@ -3082,6 +3105,14 @@ module Aws::CloudFront
     #       source_type: "S3", # required, accepts S3
     #       source_arn: "string", # required
     #     },
+    #     tags: {
+    #       items: [
+    #         {
+    #           key: "TagKey", # required
+    #           value: "TagValue",
+    #         },
+    #       ],
+    #     },
     #   })
     #
     # @example Response structure
@@ -5658,6 +5689,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 +5912,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 +11931,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 +12145,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 +12544,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 +13804,7 @@ module Aws::CloudFront
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-cloudfront'
-      context[:gem_version] = '1.143.0'
+      context[:gem_version] = '1.145.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
@@ -1355,6 +1359,7 @@ module Aws::CloudFront
     CreateFunctionRequest.add_member(:name, Shapes::ShapeRef.new(shape: FunctionName, required: true, location_name: "Name"))
     CreateFunctionRequest.add_member(:function_config, Shapes::ShapeRef.new(shape: FunctionConfig, required: true, location_name: "FunctionConfig"))
     CreateFunctionRequest.add_member(:function_code, Shapes::ShapeRef.new(shape: FunctionBlob, required: true, location_name: "FunctionCode"))
+    CreateFunctionRequest.add_member(:tags, Shapes::ShapeRef.new(shape: Tags, location_name: "Tags"))
     CreateFunctionRequest.struct_class = Types::CreateFunctionRequest
 
     CreateFunctionResult.add_member(:function_summary, Shapes::ShapeRef.new(shape: FunctionSummary, location_name: "FunctionSummary"))
@@ -1403,6 +1408,7 @@ module Aws::CloudFront
     CreateKeyValueStoreRequest.add_member(:name, Shapes::ShapeRef.new(shape: KeyValueStoreName, required: true, location_name: "Name"))
     CreateKeyValueStoreRequest.add_member(:comment, Shapes::ShapeRef.new(shape: KeyValueStoreComment, location_name: "Comment"))
     CreateKeyValueStoreRequest.add_member(:import_source, Shapes::ShapeRef.new(shape: ImportSource, location_name: "ImportSource"))
+    CreateKeyValueStoreRequest.add_member(:tags, Shapes::ShapeRef.new(shape: Tags, location_name: "Tags"))
     CreateKeyValueStoreRequest.struct_class = Types::CreateKeyValueStoreRequest
 
     CreateKeyValueStoreResult.add_member(:key_value_store, Shapes::ShapeRef.new(shape: KeyValueStore, location_name: "KeyValueStore"))
@@ -1760,6 +1766,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:
     #
@@ -2915,12 +2937,17 @@ module Aws::CloudFront
     #   [1]: https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/writing-function-code.html
     #   @return [String]
     #
+    # @!attribute [rw] tags
+    #   A complex type that contains zero or more `Tag` elements.
+    #   @return [Types::Tags]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudfront-2020-05-31/CreateFunctionRequest AWS API Documentation
     #
     class CreateFunctionRequest < Struct.new(
       :name,
       :function_config,
-      :function_code)
+      :function_code,
+      :tags)
       SENSITIVE = [:function_code]
       include Aws::Structure
     end
@@ -3071,12 +3098,17 @@ module Aws::CloudFront
     #   must be in a valid JSON format.
     #   @return [Types::ImportSource]
     #
+    # @!attribute [rw] tags
+    #   A complex type that contains zero or more `Tag` elements.
+    #   @return [Types::Tags]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cloudfront-2020-05-31/CreateKeyValueStoreRequest AWS API Documentation
     #
     class CreateKeyValueStoreRequest < Struct.new(
       :name,
       :comment,
-      :import_source)
+      :import_source,
+      :tags)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -5239,6 +5271,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 +5318,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.145.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: {
@@ -1078,7 +1084,15 @@ module Aws
                                  ]?
                                }?
                              },
-                             function_code: ::String
+                             function_code: ::String,
+                             ?tags: {
+                               items: Array[
+                                 {
+                                   key: ::String,
+                                   value: ::String?
+                                 },
+                               ]?
+                             }
                            ) -> _CreateFunctionResponseSuccess
                          | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _CreateFunctionResponseSuccess
 
@@ -1147,6 +1161,14 @@ module Aws
                                     ?import_source: {
                                       source_type: ("S3"),
                                       source_arn: ::String
+                                    },
+                                    ?tags: {
+                                      items: Array[
+                                        {
+                                          key: ::String,
+                                          value: ::String?
+                                        },
+                                      ]?
                                     }
                                   ) -> _CreateKeyValueStoreResponseSuccess
                                 | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _CreateKeyValueStoreResponseSuccess
@@ -3152,6 +3174,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")]
@@ -625,6 +630,7 @@ module Aws::CloudFront
       attr_accessor name: ::String
       attr_accessor function_config: Types::FunctionConfig
       attr_accessor function_code: ::String
+      attr_accessor tags: Types::Tags
       SENSITIVE: [:function_code]
     end
 
@@ -675,6 +681,7 @@ module Aws::CloudFront
       attr_accessor name: ::String
       attr_accessor comment: ::String
       attr_accessor import_source: Types::ImportSource
+      attr_accessor tags: Types::Tags
       SENSITIVE: []
     end
 
@@ -1117,6 +1124,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.145.0
 platform: ruby
 authors:
 - Amazon Web Services