aws-sdk-bedrockruntime 1.5.0 → 1.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3b2d8b2b15d0b645438082efa8cc021dacc23b1edaad27237f1bcb530a99703e
-  data.tar.gz: 1143c1e6b8065ab13d4155e03120b5717f87a5d791b6b9ba17507161867bb4b2
+  metadata.gz: 9ad746f1ac5f474288cfc73bc784c88fa83be0401b44cb551e1a9ebe86ed36bc
+  data.tar.gz: b3d3ba3ad85bf09f70af9e9f4f1de55817f6e278dcbba53e09cfb1194d86418f
 SHA512:
-  metadata.gz: e3a7125448b85f078ad163ff9c4b0ff571f895320dd1cb33af4a0942041fa9ec4c155a97a1d46788c666f0104f533f1872a01fc3c058213ffd0868e43e0d9483
-  data.tar.gz: eaf09e1d79b45fa084ccd8753b1e48bbf7b8e890ebdef33ae661274f160acd12423190963e2858988841945b4d5597f7a010ee0d9be1f0ee1b29aa15a66efdc4
+  metadata.gz: 5a72bef496d6c9bf1ebbc69b516834d57b2b174d837a84cc2d277c001844a4c271226514bfe92894f8da9bef99c4650487dd0bac13f02b4f934ab3a0c6f779b5
+  data.tar.gz: b31a8c29f95a9d21b6a2f79bead4bd27ed3853fe52a3694aa8271cd8260ba640b0eb6d08c6a2e8c69312b2fae6438beca46bc3138b19de7407858c2cd25d9640

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.7.0 (2024-04-25)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.6.0 (2024-04-23)
+------------------
+
+* Feature - This release introduces Guardrails for Amazon Bedrock.
+
 1.5.0 (2024-01-26)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.5.0
+1.7.0

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

@@ -22,6 +22,7 @@ require 'aws-sdk-core/plugins/endpoint_pattern.rb'
 require 'aws-sdk-core/plugins/response_paging.rb'
 require 'aws-sdk-core/plugins/stub_responses.rb'
 require 'aws-sdk-core/plugins/idempotency_token.rb'
+require 'aws-sdk-core/plugins/invocation_id.rb'
 require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
 require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
 require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
@@ -73,6 +74,7 @@ module Aws::BedrockRuntime
     add_plugin(Aws::Plugins::ResponsePaging)
     add_plugin(Aws::Plugins::StubResponses)
     add_plugin(Aws::Plugins::IdempotencyToken)
+    add_plugin(Aws::Plugins::InvocationId)
     add_plugin(Aws::Plugins::JsonvalueConverter)
     add_plugin(Aws::Plugins::ClientMetricsPlugin)
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
@@ -198,10 +200,17 @@ module Aws::BedrockRuntime
     #     When set to 'true' the request body will not be compressed
     #     for supported operations.
     #
-    #   @option options [String] :endpoint
-    #     The client endpoint is normally constructed from the `:region`
-    #     option. You should only configure an `:endpoint` when connecting
-    #     to test or custom endpoints. This should be a valid HTTP(S) URI.
+    #   @option options [String, URI::HTTPS, URI::HTTP] :endpoint
+    #     Normally you should not configure the `:endpoint` option
+    #     directly. This is normally constructed from the `:region`
+    #     option. Configuring `:endpoint` is normally reserved for
+    #     connecting to test or custom endpoints. The endpoint should
+    #     be a URI formatted like:
+    #
+    #         'http://example.com'
+    #         'https://example.com'
+    #         'http://example.com:123'
+    #
     #
     #   @option options [Integer] :endpoint_cache_max_entries (1000)
     #     Used for the maximum size limit of the LRU cache storing endpoints data
@@ -348,50 +357,65 @@ module Aws::BedrockRuntime
     #   @option options [Aws::BedrockRuntime::EndpointProvider] :endpoint_provider
     #     The endpoint provider used to resolve endpoints. Any object that responds to `#resolve_endpoint(parameters)` where `parameters` is a Struct similar to `Aws::BedrockRuntime::EndpointParameters`
     #
-    #   @option options [URI::HTTP,String] :http_proxy A proxy to send
-    #     requests through.  Formatted like 'http://proxy.com:123'.
-    #
-    #   @option options [Float] :http_open_timeout (15) The number of
-    #     seconds to wait when opening a HTTP session before raising a
-    #     `Timeout::Error`.
-    #
-    #   @option options [Float] :http_read_timeout (60) The default
-    #     number of seconds to wait for response data.  This value can
-    #     safely be set per-request on the session.
-    #
-    #   @option options [Float] :http_idle_timeout (5) The number of
-    #     seconds a connection is allowed to sit idle before it is
-    #     considered stale.  Stale connections are closed and removed
-    #     from the pool before making a request.
-    #
-    #   @option options [Float] :http_continue_timeout (1) The number of
-    #     seconds to wait for a 100-continue response before sending the
-    #     request body.  This option has no effect unless the request has
-    #     "Expect" header set to "100-continue".  Defaults to `nil` which
-    #     disables this behaviour.  This value can safely be set per
-    #     request on the session.
-    #
-    #   @option options [Float] :ssl_timeout (nil) Sets the SSL timeout
-    #     in seconds.
-    #
-    #   @option options [Boolean] :http_wire_trace (false) When `true`,
-    #     HTTP debug output will be sent to the `:logger`.
+    #   @option options [Float] :http_continue_timeout (1)
+    #     The number of seconds to wait for a 100-continue response before sending the
+    #     request body.  This option has no effect unless the request has "Expect"
+    #     header set to "100-continue".  Defaults to `nil` which  disables this
+    #     behaviour.  This value can safely be set per request on the session.
+    #
+    #   @option options [Float] :http_idle_timeout (5)
+    #     The number of seconds a connection is allowed to sit idle before it
+    #     is considered stale.  Stale connections are closed and removed from the
+    #     pool before making a request.
+    #
+    #   @option options [Float] :http_open_timeout (15)
+    #     The default number of seconds to wait for response data.
+    #     This value can safely be set per-request on the session.
+    #
+    #   @option options [URI::HTTP,String] :http_proxy
+    #     A proxy to send requests through.  Formatted like 'http://proxy.com:123'.
+    #
+    #   @option options [Float] :http_read_timeout (60)
+    #     The default number of seconds to wait for response data.
+    #     This value can safely be set per-request on the session.
+    #
+    #   @option options [Boolean] :http_wire_trace (false)
+    #     When `true`,  HTTP debug output will be sent to the `:logger`.
+    #
+    #   @option options [Proc] :on_chunk_received
+    #     When a Proc object is provided, it will be used as callback when each chunk
+    #     of the response body is received. It provides three arguments: the chunk,
+    #     the number of bytes received, and the total number of
+    #     bytes in the response (or nil if the server did not send a `content-length`).
+    #
+    #   @option options [Proc] :on_chunk_sent
+    #     When a Proc object is provided, it will be used as callback when each chunk
+    #     of the request body is sent. It provides three arguments: the chunk,
+    #     the number of bytes read from the body, and the total number of
+    #     bytes in the body.
+    #
+    #   @option options [Boolean] :raise_response_errors (true)
+    #     When `true`, response errors are raised.
+    #
+    #   @option options [String] :ssl_ca_bundle
+    #     Full path to the SSL certificate authority bundle file that should be used when
+    #     verifying peer certificates.  If you do not pass `:ssl_ca_bundle` or
+    #     `:ssl_ca_directory` the the system default will be used if available.
+    #
+    #   @option options [String] :ssl_ca_directory
+    #     Full path of the directory that contains the unbundled SSL certificate
+    #     authority files for verifying peer certificates.  If you do
+    #     not pass `:ssl_ca_bundle` or `:ssl_ca_directory` the the system
+    #     default will be used if available.
     #
-    #   @option options [Boolean] :ssl_verify_peer (true) When `true`,
-    #     SSL peer certificates are verified when establishing a
-    #     connection.
+    #   @option options [String] :ssl_ca_store
+    #     Sets the X509::Store to verify peer certificate.
     #
-    #   @option options [String] :ssl_ca_bundle Full path to the SSL
-    #     certificate authority bundle file that should be used when
-    #     verifying peer certificates.  If you do not pass
-    #     `:ssl_ca_bundle` or `:ssl_ca_directory` the the system default
-    #     will be used if available.
+    #   @option options [Float] :ssl_timeout
+    #     Sets the SSL timeout in seconds
     #
-    #   @option options [String] :ssl_ca_directory Full path of the
-    #     directory that contains the unbundled SSL certificate
-    #     authority files for verifying peer certificates.  If you do
-    #     not pass `:ssl_ca_bundle` or `:ssl_ca_directory` the the
-    #     system default will be used if available.
+    #   @option options [Boolean] :ssl_verify_peer (true)
+    #     When `true`, SSL peer certificates are verified when establishing a connection.
     #
     def initialize(*args)
       super
@@ -399,27 +423,27 @@ module Aws::BedrockRuntime
 
     # @!group API Operations
 
-    # Invokes the specified Bedrock model to run inference using the input
-    # provided in the request body. You use InvokeModel to run inference for
-    # text models, image models, and embedding models.
-    #
-    # For more information, see [Run inference][1] in the Bedrock User
-    # Guide.
+    # Invokes the specified Amazon Bedrock model to run inference using the
+    # prompt and inference parameters provided in the request body. You use
+    # model inference to generate text, images, and embeddings.
     #
-    # For example requests, see Examples (after the Errors section).
+    # For example code, see *Invoke model code examples* in the *Amazon
+    # Bedrock User Guide*.
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/api-methods-run.html
+    # This operation requires permission for the `bedrock:InvokeModel`
+    # action.
     #
     # @option params [required, String, StringIO, File] :body
-    #   Input data in the format specified in the content-type request header.
-    #   To see the format and content of this field for different models,
-    #   refer to [Inference parameters][1].
+    #   The prompt and inference parameters in the format specified in the
+    #   `contentType` in the header. To see the format and content of the
+    #   request and response bodies for different models, refer to [Inference
+    #   parameters][1]. For more information, see [Run inference][2] in the
+    #   Bedrock User Guide.
     #
     #
     #
     #   [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters.html
+    #   [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/api-methods-run.html
     #
     # @option params [String] :content_type
     #   The MIME type of the input data in the request. The default value is
@@ -430,7 +454,50 @@ module Aws::BedrockRuntime
     #   default value is `application/json`.
     #
     # @option params [required, String] :model_id
-    #   Identifier of the model.
+    #   The unique identifier of the model to invoke to run inference.
+    #
+    #   The `modelId` to provide depends on the type of model that you use:
+    #
+    #   * If you use a base model, specify the model ID or its ARN. For a list
+    #     of model IDs for base models, see [Amazon Bedrock base model IDs
+    #     (on-demand throughput)][1] in the Amazon Bedrock User Guide.
+    #
+    #   * If you use a provisioned model, specify the ARN of the Provisioned
+    #     Throughput. For more information, see [Run inference using a
+    #     Provisioned Throughput][2] in the Amazon Bedrock User Guide.
+    #
+    #   * If you use a custom model, first purchase Provisioned Throughput for
+    #     it. Then specify the ARN of the resulting provisioned model. For
+    #     more information, see [Use a custom model in Amazon Bedrock][3] in
+    #     the Amazon Bedrock User Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/model-ids.html#model-ids-arns
+    #   [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/prov-thru-use.html
+    #   [3]: https://docs.aws.amazon.com/bedrock/latest/userguide/model-customization-use.html
+    #
+    # @option params [String] :trace
+    #   Specifies whether to enable or disable the Bedrock trace. If enabled,
+    #   you can see the full Bedrock trace.
+    #
+    # @option params [String] :guardrail_identifier
+    #   The unique identifier of the guardrail that you want to use. If you
+    #   don't provide a value, no guardrail is applied to the invocation.
+    #
+    #   An error will be thrown in the following situations.
+    #
+    #   * You don't provide a guardrail identifier but you specify the
+    #     `amazon-bedrock-guardrailConfig` field in the request body.
+    #
+    #   * You enable the guardrail but the `contentType` isn't
+    #     `application/json`.
+    #
+    #   * You provide a guardrail identifier, but `guardrailVersion` isn't
+    #     specified.
+    #
+    # @option params [String] :guardrail_version
+    #   The version number for the guardrail. The value can also be `DRAFT`.
     #
     # @return [Types::InvokeModelResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -444,6 +511,9 @@ module Aws::BedrockRuntime
     #     content_type: "MimeType",
     #     accept: "MimeType",
     #     model_id: "InvokeModelIdentifier", # required
+    #     trace: "ENABLED", # accepts ENABLED, DISABLED
+    #     guardrail_identifier: "GuardrailIdentifier",
+    #     guardrail_version: "GuardrailVersion",
     #   })
     #
     # @example Response structure
@@ -460,27 +530,38 @@ module Aws::BedrockRuntime
       req.send_request(options)
     end
 
-    # Invoke the specified Bedrock model to run inference using the input
-    # provided. Return the response in a stream.
+    # Invoke the specified Amazon Bedrock model to run inference using the
+    # prompt and inference parameters provided in the request body. The
+    # response is returned in a stream.
+    #
+    # To see if a model supports streaming, call [GetFoundationModel][1] and
+    # check the `responseStreamingSupported` field in the response.
     #
-    # For more information, see [Run inference][1] in the Bedrock User
-    # Guide.
+    # <note markdown="1"> The CLI doesn't support `InvokeModelWithResponseStream`.
     #
-    # For an example request and response, see Examples (after the Errors
-    # section).
+    #  </note>
     #
+    # For example code, see *Invoke model with streaming code example* in
+    # the *Amazon Bedrock User Guide*.
     #
+    # This operation requires permissions to perform the
+    # `bedrock:InvokeModelWithResponseStream` action.
     #
-    # [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/api-methods-run.html
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/bedrock/latest/APIReference/API_GetFoundationModel.html
     #
     # @option params [required, String, StringIO, File] :body
-    #   Inference input in the format specified by the content-type. To see
-    #   the format and content of this field for different models, refer to
-    #   [Inference parameters][1].
+    #   The prompt and inference parameters in the format specified in the
+    #   `contentType` in the header. To see the format and content of the
+    #   request and response bodies for different models, refer to [Inference
+    #   parameters][1]. For more information, see [Run inference][2] in the
+    #   Bedrock User Guide.
     #
     #
     #
     #   [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters.html
+    #   [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/api-methods-run.html
     #
     # @option params [String] :content_type
     #   The MIME type of the input data in the request. The default value is
@@ -491,7 +572,50 @@ module Aws::BedrockRuntime
     #   default value is `application/json`.
     #
     # @option params [required, String] :model_id
-    #   Id of the model to invoke using the streaming request.
+    #   The unique identifier of the model to invoke to run inference.
+    #
+    #   The `modelId` to provide depends on the type of model that you use:
+    #
+    #   * If you use a base model, specify the model ID or its ARN. For a list
+    #     of model IDs for base models, see [Amazon Bedrock base model IDs
+    #     (on-demand throughput)][1] in the Amazon Bedrock User Guide.
+    #
+    #   * If you use a provisioned model, specify the ARN of the Provisioned
+    #     Throughput. For more information, see [Run inference using a
+    #     Provisioned Throughput][2] in the Amazon Bedrock User Guide.
+    #
+    #   * If you use a custom model, first purchase Provisioned Throughput for
+    #     it. Then specify the ARN of the resulting provisioned model. For
+    #     more information, see [Use a custom model in Amazon Bedrock][3] in
+    #     the Amazon Bedrock User Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/model-ids.html#model-ids-arns
+    #   [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/prov-thru-use.html
+    #   [3]: https://docs.aws.amazon.com/bedrock/latest/userguide/model-customization-use.html
+    #
+    # @option params [String] :trace
+    #   Specifies whether to enable or disable the Bedrock trace. If enabled,
+    #   you can see the full Bedrock trace.
+    #
+    # @option params [String] :guardrail_identifier
+    #   The unique identifier of the guardrail that you want to use. If you
+    #   don't provide a value, no guardrail is applied to the invocation.
+    #
+    #   An error is thrown in the following situations.
+    #
+    #   * You don't provide a guardrail identifier but you specify the
+    #     `amazon-bedrock-guardrailConfig` field in the request body.
+    #
+    #   * You enable the guardrail but the `contentType` isn't
+    #     `application/json`.
+    #
+    #   * You provide a guardrail identifier, but `guardrailVersion` isn't
+    #     specified.
+    #
+    # @option params [String] :guardrail_version
+    #   The version number for the guardrail. The value can also be `DRAFT`.
     #
     # @return [Types::InvokeModelWithResponseStreamResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -500,22 +624,22 @@ module Aws::BedrockRuntime
     #
     # @example EventStream Operation Example
     #
-    #   You can process event once it arrives immediately, or wait until
-    #   full response complete and iterate through eventstream enumerator.
+    #   You can process the event once it arrives immediately, or wait until the
+    #   full response is complete and iterate through the eventstream enumerator.
     #
     #   To interact with event immediately, you need to register #invoke_model_with_response_stream
-    #   with callbacks, callbacks can be register for specifc events or for all events,
-    #   callback for errors in the event stream is also available for register.
+    #   with callbacks. Callbacks can be registered for specific events or for all
+    #   events, including error events.
     #
-    #   Callbacks can be passed in by `:event_stream_handler` option or within block
-    #   statement attached to #invoke_model_with_response_stream call directly. Hybrid pattern of both
-    #   is also supported.
+    #   Callbacks can be passed into the `:event_stream_handler` option or within a
+    #   block statement attached to the #invoke_model_with_response_stream call directly. Hybrid
+    #   pattern of both is also supported.
     #
-    #   `:event_stream_handler` option takes in either Proc object or
+    #   `:event_stream_handler` option takes in either a Proc object or
     #   Aws::BedrockRuntime::EventStreams::ResponseStream object.
     #
-    #   Usage pattern a): callbacks with a block attached to #invoke_model_with_response_stream
-    #     Example for registering callbacks for all event types and error event
+    #   Usage pattern a): Callbacks with a block attached to #invoke_model_with_response_stream
+    #     Example for registering callbacks for all event types and an error event
     #
     #     client.invoke_model_with_response_stream( # params input# ) do |stream|
     #       stream.on_error_event do |event|
@@ -535,9 +659,9 @@ module Aws::BedrockRuntime
     #
     #     end
     #
-    #   Usage pattern b): pass in `:event_stream_handler` for #invoke_model_with_response_stream
+    #   Usage pattern b): Pass in `:event_stream_handler` for #invoke_model_with_response_stream
     #
-    #     1) create a Aws::BedrockRuntime::EventStreams::ResponseStream object
+    #     1) Create a Aws::BedrockRuntime::EventStreams::ResponseStream object
     #     Example for registering callbacks with specific events
     #
     #       handler = Aws::BedrockRuntime::EventStreams::ResponseStream.new
@@ -562,7 +686,7 @@ module Aws::BedrockRuntime
     #
     #     client.invoke_model_with_response_stream( # params input #, event_stream_handler: handler)
     #
-    #     2) use a Ruby Proc object
+    #     2) Use a Ruby Proc object
     #     Example for registering callbacks with specific events
     #
     #     handler = Proc.new do |stream|
@@ -588,7 +712,7 @@ module Aws::BedrockRuntime
     #
     #     client.invoke_model_with_response_stream( # params input #, event_stream_handler: handler)
     #
-    #   Usage pattern c): hybird pattern of a) and b)
+    #   Usage pattern c): Hybrid pattern of a) and b)
     #
     #       handler = Aws::BedrockRuntime::EventStreams::ResponseStream.new
     #       handler.on_chunk_event do |event|
@@ -621,8 +745,7 @@ module Aws::BedrockRuntime
     #       end
     #     end
     #
-    #   Besides above usage patterns for process events when they arrive immediately, you can also
-    #   iterate through events after response complete.
+    #   You can also iterate through events after the response complete.
     #
     #   Events are available at resp.body # => Enumerator
     #   For parameter input example, please refer to following request syntax
@@ -634,6 +757,9 @@ module Aws::BedrockRuntime
     #     content_type: "MimeType",
     #     accept: "MimeType",
     #     model_id: "InvokeModelIdentifier", # required
+    #     trace: "ENABLED", # accepts ENABLED, DISABLED
+    #     guardrail_identifier: "GuardrailIdentifier",
+    #     guardrail_version: "GuardrailVersion",
     #   })
     #
     # @example Response structure
@@ -704,7 +830,7 @@ module Aws::BedrockRuntime
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-bedrockruntime'
-      context[:gem_version] = '1.5.0'
+      context[:gem_version] = '1.7.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -15,6 +15,8 @@ module Aws::BedrockRuntime
 
     AccessDeniedException = Shapes::StructureShape.new(name: 'AccessDeniedException')
     Body = Shapes::BlobShape.new(name: 'Body')
+    GuardrailIdentifier = Shapes::StringShape.new(name: 'GuardrailIdentifier')
+    GuardrailVersion = Shapes::StringShape.new(name: 'GuardrailVersion')
     InternalServerException = Shapes::StructureShape.new(name: 'InternalServerException')
     InvokeModelIdentifier = Shapes::StringShape.new(name: 'InvokeModelIdentifier')
     InvokeModelRequest = Shapes::StructureShape.new(name: 'InvokeModelRequest')
@@ -34,6 +36,7 @@ module Aws::BedrockRuntime
     ServiceQuotaExceededException = Shapes::StructureShape.new(name: 'ServiceQuotaExceededException')
     StatusCode = Shapes::IntegerShape.new(name: 'StatusCode')
     ThrottlingException = Shapes::StructureShape.new(name: 'ThrottlingException')
+    Trace = Shapes::StringShape.new(name: 'Trace')
     ValidationException = Shapes::StructureShape.new(name: 'ValidationException')
 
     AccessDeniedException.add_member(:message, Shapes::ShapeRef.new(shape: NonBlankString, location_name: "message"))
@@ -46,6 +49,9 @@ module Aws::BedrockRuntime
     InvokeModelRequest.add_member(:content_type, Shapes::ShapeRef.new(shape: MimeType, location: "header", location_name: "Content-Type"))
     InvokeModelRequest.add_member(:accept, Shapes::ShapeRef.new(shape: MimeType, location: "header", location_name: "Accept"))
     InvokeModelRequest.add_member(:model_id, Shapes::ShapeRef.new(shape: InvokeModelIdentifier, required: true, location: "uri", location_name: "modelId"))
+    InvokeModelRequest.add_member(:trace, Shapes::ShapeRef.new(shape: Trace, location: "header", location_name: "X-Amzn-Bedrock-Trace"))
+    InvokeModelRequest.add_member(:guardrail_identifier, Shapes::ShapeRef.new(shape: GuardrailIdentifier, location: "header", location_name: "X-Amzn-Bedrock-GuardrailIdentifier"))
+    InvokeModelRequest.add_member(:guardrail_version, Shapes::ShapeRef.new(shape: GuardrailVersion, location: "header", location_name: "X-Amzn-Bedrock-GuardrailVersion"))
     InvokeModelRequest.struct_class = Types::InvokeModelRequest
     InvokeModelRequest[:payload] = :body
     InvokeModelRequest[:payload_member] = InvokeModelRequest.member(:body)
@@ -60,6 +66,9 @@ module Aws::BedrockRuntime
     InvokeModelWithResponseStreamRequest.add_member(:content_type, Shapes::ShapeRef.new(shape: MimeType, location: "header", location_name: "Content-Type"))
     InvokeModelWithResponseStreamRequest.add_member(:accept, Shapes::ShapeRef.new(shape: MimeType, location: "header", location_name: "X-Amzn-Bedrock-Accept"))
     InvokeModelWithResponseStreamRequest.add_member(:model_id, Shapes::ShapeRef.new(shape: InvokeModelIdentifier, required: true, location: "uri", location_name: "modelId"))
+    InvokeModelWithResponseStreamRequest.add_member(:trace, Shapes::ShapeRef.new(shape: Trace, location: "header", location_name: "X-Amzn-Bedrock-Trace"))
+    InvokeModelWithResponseStreamRequest.add_member(:guardrail_identifier, Shapes::ShapeRef.new(shape: GuardrailIdentifier, location: "header", location_name: "X-Amzn-Bedrock-GuardrailIdentifier"))
+    InvokeModelWithResponseStreamRequest.add_member(:guardrail_version, Shapes::ShapeRef.new(shape: GuardrailVersion, location: "header", location_name: "X-Amzn-Bedrock-GuardrailVersion"))
     InvokeModelWithResponseStreamRequest.struct_class = Types::InvokeModelWithResponseStreamRequest
     InvokeModelWithResponseStreamRequest[:payload] = :body
     InvokeModelWithResponseStreamRequest[:payload_member] = InvokeModelWithResponseStreamRequest.member(:body)

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

@@ -38,13 +38,16 @@ module Aws::BedrockRuntime
     end
 
     # @!attribute [rw] body
-    #   Input data in the format specified in the content-type request
-    #   header. To see the format and content of this field for different
-    #   models, refer to [Inference parameters][1].
+    #   The prompt and inference parameters in the format specified in the
+    #   `contentType` in the header. To see the format and content of the
+    #   request and response bodies for different models, refer to
+    #   [Inference parameters][1]. For more information, see [Run
+    #   inference][2] in the Bedrock User Guide.
     #
     #
     #
     #   [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters.html
+    #   [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/api-methods-run.html
     #   @return [String]
     #
     # @!attribute [rw] content_type
@@ -58,7 +61,53 @@ module Aws::BedrockRuntime
     #   @return [String]
     #
     # @!attribute [rw] model_id
-    #   Identifier of the model.
+    #   The unique identifier of the model to invoke to run inference.
+    #
+    #   The `modelId` to provide depends on the type of model that you use:
+    #
+    #   * If you use a base model, specify the model ID or its ARN. For a
+    #     list of model IDs for base models, see [Amazon Bedrock base model
+    #     IDs (on-demand throughput)][1] in the Amazon Bedrock User Guide.
+    #
+    #   * If you use a provisioned model, specify the ARN of the Provisioned
+    #     Throughput. For more information, see [Run inference using a
+    #     Provisioned Throughput][2] in the Amazon Bedrock User Guide.
+    #
+    #   * If you use a custom model, first purchase Provisioned Throughput
+    #     for it. Then specify the ARN of the resulting provisioned model.
+    #     For more information, see [Use a custom model in Amazon
+    #     Bedrock][3] in the Amazon Bedrock User Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/model-ids.html#model-ids-arns
+    #   [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/prov-thru-use.html
+    #   [3]: https://docs.aws.amazon.com/bedrock/latest/userguide/model-customization-use.html
+    #   @return [String]
+    #
+    # @!attribute [rw] trace
+    #   Specifies whether to enable or disable the Bedrock trace. If
+    #   enabled, you can see the full Bedrock trace.
+    #   @return [String]
+    #
+    # @!attribute [rw] guardrail_identifier
+    #   The unique identifier of the guardrail that you want to use. If you
+    #   don't provide a value, no guardrail is applied to the invocation.
+    #
+    #   An error will be thrown in the following situations.
+    #
+    #   * You don't provide a guardrail identifier but you specify the
+    #     `amazon-bedrock-guardrailConfig` field in the request body.
+    #
+    #   * You enable the guardrail but the `contentType` isn't
+    #     `application/json`.
+    #
+    #   * You provide a guardrail identifier, but `guardrailVersion` isn't
+    #     specified.
+    #   @return [String]
+    #
+    # @!attribute [rw] guardrail_version
+    #   The version number for the guardrail. The value can also be `DRAFT`.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/InvokeModelRequest AWS API Documentation
@@ -67,15 +116,19 @@ module Aws::BedrockRuntime
       :body,
       :content_type,
       :accept,
-      :model_id)
+      :model_id,
+      :trace,
+      :guardrail_identifier,
+      :guardrail_version)
       SENSITIVE = [:body]
       include Aws::Structure
     end
 
     # @!attribute [rw] body
     #   Inference response from the model in the format specified in the
-    #   content-type header field. To see the format and content of this
-    #   field for different models, refer to [Inference parameters][1].
+    #   `contentType` header. To see the format and content of the request
+    #   and response bodies for different models, refer to [Inference
+    #   parameters][1].
     #
     #
     #
@@ -96,13 +149,16 @@ module Aws::BedrockRuntime
     end
 
     # @!attribute [rw] body
-    #   Inference input in the format specified by the content-type. To see
-    #   the format and content of this field for different models, refer to
-    #   [Inference parameters][1].
+    #   The prompt and inference parameters in the format specified in the
+    #   `contentType` in the header. To see the format and content of the
+    #   request and response bodies for different models, refer to
+    #   [Inference parameters][1]. For more information, see [Run
+    #   inference][2] in the Bedrock User Guide.
     #
     #
     #
     #   [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters.html
+    #   [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/api-methods-run.html
     #   @return [String]
     #
     # @!attribute [rw] content_type
@@ -116,7 +172,53 @@ module Aws::BedrockRuntime
     #   @return [String]
     #
     # @!attribute [rw] model_id
-    #   Id of the model to invoke using the streaming request.
+    #   The unique identifier of the model to invoke to run inference.
+    #
+    #   The `modelId` to provide depends on the type of model that you use:
+    #
+    #   * If you use a base model, specify the model ID or its ARN. For a
+    #     list of model IDs for base models, see [Amazon Bedrock base model
+    #     IDs (on-demand throughput)][1] in the Amazon Bedrock User Guide.
+    #
+    #   * If you use a provisioned model, specify the ARN of the Provisioned
+    #     Throughput. For more information, see [Run inference using a
+    #     Provisioned Throughput][2] in the Amazon Bedrock User Guide.
+    #
+    #   * If you use a custom model, first purchase Provisioned Throughput
+    #     for it. Then specify the ARN of the resulting provisioned model.
+    #     For more information, see [Use a custom model in Amazon
+    #     Bedrock][3] in the Amazon Bedrock User Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/bedrock/latest/userguide/model-ids.html#model-ids-arns
+    #   [2]: https://docs.aws.amazon.com/bedrock/latest/userguide/prov-thru-use.html
+    #   [3]: https://docs.aws.amazon.com/bedrock/latest/userguide/model-customization-use.html
+    #   @return [String]
+    #
+    # @!attribute [rw] trace
+    #   Specifies whether to enable or disable the Bedrock trace. If
+    #   enabled, you can see the full Bedrock trace.
+    #   @return [String]
+    #
+    # @!attribute [rw] guardrail_identifier
+    #   The unique identifier of the guardrail that you want to use. If you
+    #   don't provide a value, no guardrail is applied to the invocation.
+    #
+    #   An error is thrown in the following situations.
+    #
+    #   * You don't provide a guardrail identifier but you specify the
+    #     `amazon-bedrock-guardrailConfig` field in the request body.
+    #
+    #   * You enable the guardrail but the `contentType` isn't
+    #     `application/json`.
+    #
+    #   * You provide a guardrail identifier, but `guardrailVersion` isn't
+    #     specified.
+    #   @return [String]
+    #
+    # @!attribute [rw] guardrail_version
+    #   The version number for the guardrail. The value can also be `DRAFT`.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/InvokeModelWithResponseStreamRequest AWS API Documentation
@@ -125,15 +227,18 @@ module Aws::BedrockRuntime
       :body,
       :content_type,
       :accept,
-      :model_id)
+      :model_id,
+      :trace,
+      :guardrail_identifier,
+      :guardrail_version)
       SENSITIVE = [:body]
       include Aws::Structure
     end
 
     # @!attribute [rw] body
-    #   Inference response from the model in the format specified by
-    #   Content-Type. To see the format and content of this field for
-    #   different models, refer to [Inference parameters][1].
+    #   Inference response from the model in the format specified by the
+    #   `contentType` header. To see the format and content of this field
+    #   for different models, refer to [Inference parameters][1].
     #
     #
     #
@@ -190,7 +295,7 @@ module Aws::BedrockRuntime
       include Aws::Structure
     end
 
-    # An error occurred while streaming the response.
+    # An error occurred while streaming the response. Retry your request.
     #
     # @!attribute [rw] message
     #   @return [String]

data/lib/aws-sdk-bedrockruntime.rb

@@ -54,6 +54,6 @@ require_relative 'aws-sdk-bedrockruntime/event_streams'
 # @!group service
 module Aws::BedrockRuntime
 
-  GEM_VERSION = '1.5.0'
+  GEM_VERSION = '1.7.0'
 
 end

data/sig/client.rbs

@@ -85,7 +85,10 @@ module Aws
                           body: ::String,
                           ?content_type: ::String,
                           ?accept: ::String,
-                          model_id: ::String
+                          model_id: ::String,
+                          ?trace: ("ENABLED" | "DISABLED"),
+                          ?guardrail_identifier: ::String,
+                          ?guardrail_version: ::String
                         ) -> _InvokeModelResponseSuccess
                       | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _InvokeModelResponseSuccess
 
@@ -99,7 +102,10 @@ module Aws
                                                body: ::String,
                                                ?content_type: ::String,
                                                ?accept: ::String,
-                                               model_id: ::String
+                                               model_id: ::String,
+                                               ?trace: ("ENABLED" | "DISABLED"),
+                                               ?guardrail_identifier: ::String,
+                                               ?guardrail_version: ::String
                                              ) ?{ (*untyped) -> void } -> _InvokeModelWithResponseStreamResponseSuccess
                                            | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) ?{ (*untyped) -> void } -> _InvokeModelWithResponseStreamResponseSuccess
     end

data/sig/types.rbs

@@ -24,6 +24,9 @@ module Aws::BedrockRuntime
       attr_accessor content_type: ::String
       attr_accessor accept: ::String
       attr_accessor model_id: ::String
+      attr_accessor trace: ("ENABLED" | "DISABLED")
+      attr_accessor guardrail_identifier: ::String
+      attr_accessor guardrail_version: ::String
       SENSITIVE: [:body]
     end
 
@@ -38,6 +41,9 @@ module Aws::BedrockRuntime
       attr_accessor content_type: ::String
       attr_accessor accept: ::String
       attr_accessor model_id: ::String
+      attr_accessor trace: ("ENABLED" | "DISABLED")
+      attr_accessor guardrail_identifier: ::String
+      attr_accessor guardrail_version: ::String
       SENSITIVE: [:body]
     end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-bedrockruntime
 version: !ruby/object:Gem::Version
-  version: 1.5.0
+  version: 1.7.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-01-26 00:00:00.000000000 Z
+date: 2024-04-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.191.0
+        version: 3.193.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.191.0
+        version: 3.193.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement