aws-sdk-bedrockruntime 1.71.0 → 1.72.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d921b47acca94d9951cd91cdeef9723e09f3430c4b58e949ae29ce16beab02c0
-  data.tar.gz: 8759178f8b225b655c3fb892b0918e9c4cb5d905d7d138e8771e63fff7a1121e
+  metadata.gz: 301bb5aa68305df5bc9e951a0ed54fb5b93bb5fe0e4a7019125276c33ab399d5
+  data.tar.gz: 84bedbd592678e39f2ad442c83a3816108c6cc9505de0328af5951135d7fde00
 SHA512:
-  metadata.gz: abb320924257441dce34d26e0455f424144080ce923fd0415211b862fa6dab64b9c1a7f664cdd62fe96aa4203a643e26e8d3b1086a270a9ee67292c44acb3e62
-  data.tar.gz: 66a58aa04a468810651cfe032f46e5cfc70902f43dbe3643ed330ffa05f2a4e75427f4fc6759ac02b0e88cac974094775890c87da9824402b45bb607d0ae4488
+  metadata.gz: 26686c725ac9f5f0360f32a26504909aa8c74f48e1a0744c8d521621e952a5d4863832706ac47a067862d8f1603da277b6ee4e1a9bc52ff17368e4be956fc77e
+  data.tar.gz: 7107117ecb4207154e038099bc89f1bd64df9529ddd4e27433f1e9e64a6ffca1cf967105da2e3b2e4ff980e6e9bbf7fe8be83f8328d8966425a721f9e4b893b4

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.72.0 (2026-01-20)
+------------------
+
+* Feature - Added support for extended prompt caching with one hour TTL.
+
 1.71.0 (2026-01-16)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.71.0
+1.72.0

data/lib/aws-sdk-bedrockruntime/async_client.rb

@@ -621,7 +621,7 @@ module Aws::BedrockRuntime
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-bedrockruntime'
-      context[:gem_version] = '1.71.0'
+      context[:gem_version] = '1.72.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -1091,6 +1091,7 @@ module Aws::BedrockRuntime
     #             },
     #             cache_point: {
     #               type: "default", # required, accepts default
+    #               ttl: "5m", # accepts 5m, 1h
     #             },
     #             reasoning_content: {
     #               reasoning_text: {
@@ -1176,6 +1177,7 @@ module Aws::BedrockRuntime
     #         },
     #         cache_point: {
     #           type: "default", # required, accepts default
+    #           ttl: "5m", # accepts 5m, 1h
     #         },
     #       },
     #     ],
@@ -1201,6 +1203,7 @@ module Aws::BedrockRuntime
     #           },
     #           cache_point: {
     #             type: "default", # required, accepts default
+    #             ttl: "5m", # accepts 5m, 1h
     #           },
     #         },
     #       ],
@@ -1305,6 +1308,7 @@ module Aws::BedrockRuntime
     #   resp.output.message.content[0].guard_content.image.format #=> String, one of "png", "jpeg"
     #   resp.output.message.content[0].guard_content.image.source.bytes #=> String
     #   resp.output.message.content[0].cache_point.type #=> String, one of "default"
+    #   resp.output.message.content[0].cache_point.ttl #=> String, one of "5m", "1h"
     #   resp.output.message.content[0].reasoning_content.reasoning_text.text #=> String
     #   resp.output.message.content[0].reasoning_content.reasoning_text.signature #=> String
     #   resp.output.message.content[0].reasoning_content.redacted_content #=> String
@@ -1340,6 +1344,9 @@ module Aws::BedrockRuntime
     #   resp.usage.total_tokens #=> Integer
     #   resp.usage.cache_read_input_tokens #=> Integer
     #   resp.usage.cache_write_input_tokens #=> Integer
+    #   resp.usage.cache_details #=> Array
+    #   resp.usage.cache_details[0].ttl #=> String, one of "5m", "1h"
+    #   resp.usage.cache_details[0].input_tokens #=> Integer
     #   resp.metrics.latency_ms #=> Integer
     #   resp.trace.guardrail.model_output #=> Array
     #   resp.trace.guardrail.model_output[0] #=> String
@@ -2216,6 +2223,7 @@ module Aws::BedrockRuntime
     #             },
     #             cache_point: {
     #               type: "default", # required, accepts default
+    #               ttl: "5m", # accepts 5m, 1h
     #             },
     #             reasoning_content: {
     #               reasoning_text: {
@@ -2301,6 +2309,7 @@ module Aws::BedrockRuntime
     #         },
     #         cache_point: {
     #           type: "default", # required, accepts default
+    #           ttl: "5m", # accepts 5m, 1h
     #         },
     #       },
     #     ],
@@ -2326,6 +2335,7 @@ module Aws::BedrockRuntime
     #           },
     #           cache_point: {
     #             type: "default", # required, accepts default
+    #             ttl: "5m", # accepts 5m, 1h
     #           },
     #         },
     #       ],
@@ -2427,6 +2437,9 @@ module Aws::BedrockRuntime
     #   event.usage.total_tokens #=> Integer
     #   event.usage.cache_read_input_tokens #=> Integer
     #   event.usage.cache_write_input_tokens #=> Integer
+    #   event.usage.cache_details #=> Array
+    #   event.usage.cache_details[0].ttl #=> String, one of "5m", "1h"
+    #   event.usage.cache_details[0].input_tokens #=> Integer
     #   event.metrics.latency_ms #=> Integer
     #   event.trace.guardrail.model_output #=> Array
     #   event.trace.guardrail.model_output[0] #=> String
@@ -3031,6 +3044,7 @@ module Aws::BedrockRuntime
     #                 },
     #                 cache_point: {
     #                   type: "default", # required, accepts default
+    #                   ttl: "5m", # accepts 5m, 1h
     #                 },
     #                 reasoning_content: {
     #                   reasoning_text: {
@@ -3116,6 +3130,7 @@ module Aws::BedrockRuntime
     #             },
     #             cache_point: {
     #               type: "default", # required, accepts default
+    #               ttl: "5m", # accepts 5m, 1h
     #             },
     #           },
     #         ],
@@ -3135,6 +3150,7 @@ module Aws::BedrockRuntime
     #               },
     #               cache_point: {
     #                 type: "default", # required, accepts default
+    #                 ttl: "5m", # accepts 5m, 1h
     #               },
     #             },
     #           ],
@@ -3877,7 +3893,7 @@ module Aws::BedrockRuntime
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-bedrockruntime'
-      context[:gem_version] = '1.71.0'
+      context[:gem_version] = '1.72.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -40,8 +40,12 @@ module Aws::BedrockRuntime
     Blob = Shapes::BlobShape.new(name: 'Blob')
     Body = Shapes::BlobShape.new(name: 'Body')
     Boolean = Shapes::BooleanShape.new(name: 'Boolean')
+    CacheDetail = Shapes::StructureShape.new(name: 'CacheDetail')
+    CacheDetailInputTokensInteger = Shapes::IntegerShape.new(name: 'CacheDetailInputTokensInteger')
+    CacheDetailsList = Shapes::ListShape.new(name: 'CacheDetailsList')
     CachePointBlock = Shapes::StructureShape.new(name: 'CachePointBlock')
     CachePointType = Shapes::StringShape.new(name: 'CachePointType')
+    CacheTTL = Shapes::StringShape.new(name: 'CacheTTL')
     Citation = Shapes::StructureShape.new(name: 'Citation')
     CitationGeneratedContent = Shapes::UnionShape.new(name: 'CitationGeneratedContent')
     CitationGeneratedContentList = Shapes::ListShape.new(name: 'CitationGeneratedContentList')
@@ -421,7 +425,14 @@ module Aws::BedrockRuntime
     BidirectionalOutputPayloadPart.add_member(:bytes, Shapes::ShapeRef.new(shape: PartBody, location_name: "bytes"))
     BidirectionalOutputPayloadPart.struct_class = Types::BidirectionalOutputPayloadPart
 
+    CacheDetail.add_member(:ttl, Shapes::ShapeRef.new(shape: CacheTTL, required: true, location_name: "ttl"))
+    CacheDetail.add_member(:input_tokens, Shapes::ShapeRef.new(shape: CacheDetailInputTokensInteger, required: true, location_name: "inputTokens"))
+    CacheDetail.struct_class = Types::CacheDetail
+
+    CacheDetailsList.member = Shapes::ShapeRef.new(shape: CacheDetail)
+
     CachePointBlock.add_member(:type, Shapes::ShapeRef.new(shape: CachePointType, required: true, location_name: "type"))
+    CachePointBlock.add_member(:ttl, Shapes::ShapeRef.new(shape: CacheTTL, location_name: "ttl"))
     CachePointBlock.struct_class = Types::CachePointBlock
 
     Citation.add_member(:title, Shapes::ShapeRef.new(shape: String, location_name: "title"))
@@ -1275,6 +1286,7 @@ module Aws::BedrockRuntime
     TokenUsage.add_member(:total_tokens, Shapes::ShapeRef.new(shape: TokenUsageTotalTokensInteger, required: true, location_name: "totalTokens"))
     TokenUsage.add_member(:cache_read_input_tokens, Shapes::ShapeRef.new(shape: TokenUsageCacheReadInputTokensInteger, location_name: "cacheReadInputTokens"))
     TokenUsage.add_member(:cache_write_input_tokens, Shapes::ShapeRef.new(shape: TokenUsageCacheWriteInputTokensInteger, location_name: "cacheWriteInputTokens"))
+    TokenUsage.add_member(:cache_details, Shapes::ShapeRef.new(shape: CacheDetailsList, location_name: "cacheDetails"))
     TokenUsage.struct_class = Types::TokenUsage
 
     Tool.add_member(:tool_spec, Shapes::ShapeRef.new(shape: ToolSpecification, location_name: "toolSpec"))

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

@@ -372,6 +372,26 @@ module Aws::BedrockRuntime
       include Aws::Structure
     end
 
+    # Cache creation metrics for a specific TTL duration
+    #
+    # @!attribute [rw] ttl
+    #   TTL duration for these cached tokens
+    #   @return [String]
+    #
+    # @!attribute [rw] input_tokens
+    #   Number of tokens written to cache with this TTL (cache creation
+    #   tokens)
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/CacheDetail AWS API Documentation
+    #
+    class CacheDetail < Struct.new(
+      :ttl,
+      :input_tokens)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Defines a section of content to be cached for reuse in subsequent API
     # calls.
     #
@@ -379,10 +399,17 @@ module Aws::BedrockRuntime
     #   Specifies the type of cache point within the CachePointBlock.
     #   @return [String]
     #
+    # @!attribute [rw] ttl
+    #   Optional TTL duration for cache entries. When specified, enables
+    #   extended TTL caching with the specified duration. When omitted, uses
+    #   `type` value for caching behavior.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/CachePointBlock AWS API Documentation
     #
     class CachePointBlock < Struct.new(
-      :type)
+      :type,
+      :ttl)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -4304,6 +4331,11 @@ module Aws::BedrockRuntime
     #   The number of input tokens written to the cache for the request.
     #   @return [Integer]
     #
+    # @!attribute [rw] cache_details
+    #   Detailed breakdown of cache writes by TTL. Empty if no cache
+    #   creation occurred. Sorted by TTL duration (1h before 5m).
+    #   @return [Array<Types::CacheDetail>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/TokenUsage AWS API Documentation
     #
     class TokenUsage < Struct.new(
@@ -4311,7 +4343,8 @@ module Aws::BedrockRuntime
       :output_tokens,
       :total_tokens,
       :cache_read_input_tokens,
-      :cache_write_input_tokens)
+      :cache_write_input_tokens,
+      :cache_details)
       SENSITIVE = []
       include Aws::Structure
     end

data/lib/aws-sdk-bedrockruntime.rb

@@ -73,7 +73,7 @@ module Aws::BedrockRuntime
   autoload :AsyncClient, 'aws-sdk-bedrockruntime/async_client'
   autoload :EventStreams, 'aws-sdk-bedrockruntime/event_streams'
 
-  GEM_VERSION = '1.71.0'
+  GEM_VERSION = '1.72.0'
 
 end
 

data/sig/client.rbs

@@ -278,7 +278,8 @@ module Aws
                                 }?
                               }?,
                               cache_point: {
-                                type: ("default")
+                                type: ("default"),
+                                ttl: ("5m" | "1h")?
                               }?,
                               reasoning_content: {
                                 reasoning_text: {
@@ -363,7 +364,8 @@ module Aws
                             }?
                           }?,
                           cache_point: {
-                            type: ("default")
+                            type: ("default"),
+                            ttl: ("5m" | "1h")?
                           }?
                         },
                       ],
@@ -388,7 +390,8 @@ module Aws
                               name: ::String
                             }?,
                             cache_point: {
-                              type: ("default")
+                              type: ("default"),
+                              ttl: ("5m" | "1h")?
                             }?
                           },
                         ],
@@ -581,7 +584,8 @@ module Aws
                                        }?
                                      }?,
                                      cache_point: {
-                                       type: ("default")
+                                       type: ("default"),
+                                       ttl: ("5m" | "1h")?
                                      }?,
                                      reasoning_content: {
                                        reasoning_text: {
@@ -666,7 +670,8 @@ module Aws
                                    }?
                                  }?,
                                  cache_point: {
-                                   type: ("default")
+                                   type: ("default"),
+                                   ttl: ("5m" | "1h")?
                                  }?
                                },
                              ],
@@ -691,7 +696,8 @@ module Aws
                                      name: ::String
                                    }?,
                                    cache_point: {
-                                     type: ("default")
+                                     type: ("default"),
+                                     ttl: ("5m" | "1h")?
                                    }?
                                  },
                                ],
@@ -890,7 +896,8 @@ module Aws
                                         }?
                                       }?,
                                       cache_point: {
-                                        type: ("default")
+                                        type: ("default"),
+                                        ttl: ("5m" | "1h")?
                                       }?,
                                       reasoning_content: {
                                         reasoning_text: {
@@ -975,7 +982,8 @@ module Aws
                                     }?
                                   }?,
                                   cache_point: {
-                                    type: ("default")
+                                    type: ("default"),
+                                    ttl: ("5m" | "1h")?
                                   }?
                                 },
                               ]?,
@@ -994,7 +1002,8 @@ module Aws
                                       name: ::String
                                     }?,
                                     cache_point: {
-                                      type: ("default")
+                                      type: ("default"),
+                                      ttl: ("5m" | "1h")?
                                     }?
                                   },
                                 ],

data/sig/types.rbs

@@ -111,8 +111,15 @@ module Aws::BedrockRuntime
       SENSITIVE: [:bytes]
     end
 
+    class CacheDetail
+      attr_accessor ttl: ("5m" | "1h")
+      attr_accessor input_tokens: ::Integer
+      SENSITIVE: []
+    end
+
     class CachePointBlock
       attr_accessor type: ("default")
+      attr_accessor ttl: ("5m" | "1h")
       SENSITIVE: []
     end
 
@@ -1206,6 +1213,7 @@ module Aws::BedrockRuntime
       attr_accessor total_tokens: ::Integer
       attr_accessor cache_read_input_tokens: ::Integer
       attr_accessor cache_write_input_tokens: ::Integer
+      attr_accessor cache_details: ::Array[Types::CacheDetail]
       SENSITIVE: []
     end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-bedrockruntime
 version: !ruby/object:Gem::Version
-  version: 1.71.0
+  version: 1.72.0
 platform: ruby
 authors:
 - Amazon Web Services