aws-sdk-sagemakerfeaturestoreruntime 1.67.0 → 1.68.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e87096e9b7806f145a8188c9a02f55c520a75dffc56b6e724abe62b0cd95a5c5
-  data.tar.gz: 3459fb0f098181ecf0ee9422e19559953b105d0803d6969e521cf4e13b4ffcdf
+  metadata.gz: a480ad248105bda4bea2774061f03a825d9291acf5d6e04e4157955251346c5a
+  data.tar.gz: 216930b1a23393dc1daa2aca5f3f99805429f2798233bd31d685e9e8e9a4f685
 SHA512:
-  metadata.gz: b2582358597ca9e7cb9b86623208d3cb8fd50c90cb360f0b2153d0d63132473f234bfa530ee6d0cdbab2975a3cb36d8851bb8cf4dedfaa429b4be7274ee631ef
-  data.tar.gz: 19a69d454af2230204e8f21a1c1803fe7377959428ac628f6d0a0959744d4060400aa85c6a9ab5918e6828812e173725759e0565c23a55a50a7e377bcaf41adf
+  metadata.gz: 8df23151905389bfd3890595afced5ab9005b97a8e91e07e784237acd43c34e545a613ec69edea983edbe11b1ce16252c1e65c9f8ce056317f6032bbec0ca9e2
+  data.tar.gz: 7ef26cb0254d02673dfad9e9f19e9f49dd3b9adb841290f7e2698d9a6cd139b80d981aee8cf23ff168102195290ef9ffca4688c07eea890c87f1f7d0d1d1a1dc

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.68.0 (2026-09-02)
+------------------
+
+* Feature - Amazon SageMaker Feature Store now supports the UpdateRecord API, enabling partial updates to individual feature values in an existing Online Store record without rewriting the entire record. This reduces write payloads and latency for high-frequency feature-level writes .
+
 1.67.0 (2026-07-09)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.67.0
+1.68.0

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

@@ -934,6 +934,140 @@ module Aws::SageMakerFeatureStoreRuntime
       req.send_request(options)
     end
 
+    # Updates one or more feature values for an existing record in the
+    # specified feature group. Features that you do not include in the
+    # request remain unchanged. You can update up to 100 features per call.
+    #
+    # This operation is available only for feature groups that use the
+    # `Standard_V2` or `InMemory` online store type.
+    #
+    # The record must already exist. If the record does not exist or has
+    # been soft-deleted, the operation returns a `ResourceNotFound` error.
+    # To create a record, use `PutRecord`.
+    #
+    # If you provide an `EventTime` that is older than the record's current
+    # `EventTime`, the service rejects the update with a
+    # `ConflictException`. If the `EventTime` is equal to or newer than the
+    # current value, the service applies the update. If you omit
+    # `EventTime`, the service keeps the record's existing `EventTime` and
+    # applies the update.
+    #
+    # If you specify a `TtlDuration`, you must also provide an `EventTime`
+    # in the request. Otherwise, the operation returns a `ValidationError`.
+    #
+    # @option params [required, String] :feature_group_name
+    #   The identifier for the feature group that contains the record to
+    #   update. You can specify one of the following:
+    #
+    #   * The feature group name.
+    #
+    #   * The feature group Amazon Resource Name (ARN).
+    #
+    # @option params [required, String] :record_identifier_value_as_string
+    #   The value that uniquely identifies the record in the feature group.
+    #   This must match the value defined by the feature group's record
+    #   identifier feature.
+    #
+    # @option params [required, Array<Types::FeatureValue>] :features
+    #   The feature values to write to the record.
+    #
+    # @option params [Array<String>] :target_stores
+    #   The target stores for the record update. By default, Amazon SageMaker
+    #   Feature Store updates the record in all stores associated with the
+    #   `FeatureGroup`.
+    #
+    # @option params [Types::TtlDuration] :ttl_duration
+    #   The time-to-live (TTL) duration for the record. Amazon SageMaker
+    #   Feature Store deletes the record when `EventTime` + `TtlDuration`
+    #   elapses. If you omit this parameter, the record's existing TTL
+    #   setting remains unchanged. For information about `HardDelete`, see the
+    #   [DeleteRecord][1] operation in the Amazon SageMaker API Reference.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_feature_store_DeleteRecord.html
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    #
+    # @example Example: Update specific features in a record
+    #
+    #   resp = client.update_record({
+    #     feature_group_name: "my-feature-group", 
+    #     features: [
+    #       {
+    #         feature_name: "age", 
+    #         value_as_string: "26", 
+    #       }, 
+    #       {
+    #         feature_name: "membership_tier", 
+    #         value_as_string: "gold", 
+    #       }, 
+    #       {
+    #         feature_name: "event_time", 
+    #         value_as_string: "2026-07-26T12:00:00Z", 
+    #       }, 
+    #     ], 
+    #     record_identifier_value_as_string: "cust-001", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
+    # @example Example: Update features and set a time-to-live (TTL) duration
+    #
+    #   resp = client.update_record({
+    #     feature_group_name: "my-feature-group", 
+    #     features: [
+    #       {
+    #         feature_name: "age", 
+    #         value_as_string: "26", 
+    #       }, 
+    #       {
+    #         feature_name: "event_time", 
+    #         value_as_string: "2026-07-26T12:00:00Z", 
+    #       }, 
+    #     ], 
+    #     record_identifier_value_as_string: "cust-001", 
+    #     ttl_duration: {
+    #       unit: "Weeks", 
+    #       value: 4, 
+    #     }, 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_record({
+    #     feature_group_name: "FeatureGroupNameOrArn", # required
+    #     record_identifier_value_as_string: "ValueAsString", # required
+    #     features: [ # required
+    #       {
+    #         feature_name: "FeatureName", # required
+    #         value_as_string: "ValueAsString",
+    #         value_as_string_list: ["ValueAsString"],
+    #       },
+    #     ],
+    #     target_stores: ["OnlineStore"], # accepts OnlineStore, OfflineStore
+    #     ttl_duration: {
+    #       unit: "Seconds", # required, accepts Seconds, Minutes, Hours, Days, Weeks
+    #       value: 1, # required
+    #     },
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-featurestore-runtime-2020-07-01/UpdateRecord AWS API Documentation
+    #
+    # @overload update_record(params = {})
+    # @param [Hash] params ({})
+    def update_record(params = {}, options = {})
+      req = build_request(:update_record, params)
+      req.send_request(options)
+    end
+
     # @!endgroup
 
     # @param params ({})
@@ -952,7 +1086,7 @@ module Aws::SageMakerFeatureStoreRuntime
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-sagemakerfeaturestoreruntime'
-      context[:gem_version] = '1.67.0'
+      context[:gem_version] = '1.68.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -30,6 +30,7 @@ module Aws::SageMakerFeatureStoreRuntime
     BatchWriteRecordRequest = Shapes::StructureShape.new(name: 'BatchWriteRecordRequest')
     BatchWriteRecordResponse = Shapes::StructureShape.new(name: 'BatchWriteRecordResponse')
     Boolean = Shapes::BooleanShape.new(name: 'Boolean')
+    ConflictException = Shapes::StructureShape.new(name: 'ConflictException')
     DeleteRecordRequest = Shapes::StructureShape.new(name: 'DeleteRecordRequest')
     DeletionMode = Shapes::StringShape.new(name: 'DeletionMode')
     ExpirationTimeResponse = Shapes::StringShape.new(name: 'ExpirationTimeResponse')
@@ -59,6 +60,7 @@ module Aws::SageMakerFeatureStoreRuntime
     TtlDurationValue = Shapes::IntegerShape.new(name: 'TtlDurationValue')
     UnprocessedBatchWriteRecordEntries = Shapes::ListShape.new(name: 'UnprocessedBatchWriteRecordEntries')
     UnprocessedIdentifiers = Shapes::ListShape.new(name: 'UnprocessedIdentifiers')
+    UpdateRecordRequest = Shapes::StructureShape.new(name: 'UpdateRecordRequest')
     ValidationError = Shapes::StructureShape.new(name: 'ValidationError')
     ValueAsString = Shapes::StringShape.new(name: 'ValueAsString')
     ValueAsStringList = Shapes::ListShape.new(name: 'ValueAsStringList')
@@ -121,6 +123,9 @@ module Aws::SageMakerFeatureStoreRuntime
     BatchWriteRecordResponse.add_member(:unprocessed_entries, Shapes::ShapeRef.new(shape: UnprocessedBatchWriteRecordEntries, required: true, location_name: "UnprocessedEntries"))
     BatchWriteRecordResponse.struct_class = Types::BatchWriteRecordResponse
 
+    ConflictException.add_member(:message, Shapes::ShapeRef.new(shape: Message, location_name: "Message"))
+    ConflictException.struct_class = Types::ConflictException
+
     DeleteRecordRequest.add_member(:feature_group_name, Shapes::ShapeRef.new(shape: FeatureGroupNameOrArn, required: true, location: "uri", location_name: "FeatureGroupName"))
     DeleteRecordRequest.add_member(:record_identifier_value_as_string, Shapes::ShapeRef.new(shape: ValueAsString, required: true, location: "querystring", location_name: "RecordIdentifierValueAsString"))
     DeleteRecordRequest.add_member(:event_time, Shapes::ShapeRef.new(shape: ValueAsString, required: true, location: "querystring", location_name: "EventTime"))
@@ -186,6 +191,13 @@ module Aws::SageMakerFeatureStoreRuntime
 
     UnprocessedIdentifiers.member = Shapes::ShapeRef.new(shape: BatchGetRecordIdentifier)
 
+    UpdateRecordRequest.add_member(:feature_group_name, Shapes::ShapeRef.new(shape: FeatureGroupNameOrArn, required: true, location: "uri", location_name: "FeatureGroupName"))
+    UpdateRecordRequest.add_member(:record_identifier_value_as_string, Shapes::ShapeRef.new(shape: ValueAsString, required: true, location_name: "RecordIdentifierValueAsString"))
+    UpdateRecordRequest.add_member(:features, Shapes::ShapeRef.new(shape: Record, required: true, location_name: "Features"))
+    UpdateRecordRequest.add_member(:target_stores, Shapes::ShapeRef.new(shape: TargetStores, location_name: "TargetStores"))
+    UpdateRecordRequest.add_member(:ttl_duration, Shapes::ShapeRef.new(shape: TtlDuration, location_name: "TtlDuration"))
+    UpdateRecordRequest.struct_class = Types::UpdateRecordRequest
+
     ValidationError.add_member(:message, Shapes::ShapeRef.new(shape: Message, location_name: "Message"))
     ValidationError.struct_class = Types::ValidationError
 
@@ -291,6 +303,20 @@ module Aws::SageMakerFeatureStoreRuntime
         o.errors << Shapes::ShapeRef.new(shape: ServiceUnavailable)
         o.errors << Shapes::ShapeRef.new(shape: AccessForbidden)
       end)
+
+      api.add_operation(:update_record, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "UpdateRecord"
+        o.http_method = "POST"
+        o.http_request_uri = "/FeatureGroup/{FeatureGroupName}/Record"
+        o.input = Shapes::ShapeRef.new(shape: UpdateRecordRequest)
+        o.output = Shapes::ShapeRef.new(shape: Shapes::StructureShape.new(struct_class: Aws::EmptyStructure))
+        o.errors << Shapes::ShapeRef.new(shape: ValidationError)
+        o.errors << Shapes::ShapeRef.new(shape: InternalFailure)
+        o.errors << Shapes::ShapeRef.new(shape: ServiceUnavailable)
+        o.errors << Shapes::ShapeRef.new(shape: AccessForbidden)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFound)
+        o.errors << Shapes::ShapeRef.new(shape: ConflictException)
+      end)
     end
 
   end

data/lib/aws-sdk-sagemakerfeaturestoreruntime/errors.rb

@@ -28,6 +28,7 @@ module Aws::SageMakerFeatureStoreRuntime
   #
   # ## Error Classes
   # * {AccessForbidden}
+  # * {ConflictException}
   # * {InternalFailure}
   # * {ResourceNotFound}
   # * {ServiceUnavailable}
@@ -54,6 +55,21 @@ module Aws::SageMakerFeatureStoreRuntime
       end
     end
 
+    class ConflictException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::SageMakerFeatureStoreRuntime::Types::ConflictException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+
+      # @return [String]
+      def message
+        @message || @data[:message]
+      end
+    end
+
     class InternalFailure < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context

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

@@ -267,6 +267,22 @@ module Aws::SageMakerFeatureStoreRuntime
       include Aws::Structure
     end
 
+    # The service rejected the update because the provided `EventTime` is
+    # older than the record's current `EventTime`. To persist the update,
+    # retrieve the record's latest `EventTime` and resubmit the request
+    # with an `EventTime` that is equal to or newer than the current value.
+    #
+    # @!attribute [rw] message
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-featurestore-runtime-2020-07-01/ConflictException AWS API Documentation
+    #
+    class ConflictException < Struct.new(
+      :message)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] feature_group_name
     #   The name or Amazon Resource Name (ARN) of the feature group to
     #   delete the record from.
@@ -546,6 +562,56 @@ module Aws::SageMakerFeatureStoreRuntime
       include Aws::Structure
     end
 
+    # @!attribute [rw] feature_group_name
+    #   The identifier for the feature group that contains the record to
+    #   update. You can specify one of the following:
+    #
+    #   * The feature group name.
+    #
+    #   * The feature group Amazon Resource Name (ARN).
+    #   @return [String]
+    #
+    # @!attribute [rw] record_identifier_value_as_string
+    #   The value that uniquely identifies the record in the feature group.
+    #   This must match the value defined by the feature group's record
+    #   identifier feature.
+    #   @return [String]
+    #
+    # @!attribute [rw] features
+    #   The feature values to write to the record.
+    #   @return [Array<Types::FeatureValue>]
+    #
+    # @!attribute [rw] target_stores
+    #   The target stores for the record update. By default, Amazon
+    #   SageMaker Feature Store updates the record in all stores associated
+    #   with the `FeatureGroup`.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] ttl_duration
+    #   The time-to-live (TTL) duration for the record. Amazon SageMaker
+    #   Feature Store deletes the record when `EventTime` + `TtlDuration`
+    #   elapses. If you omit this parameter, the record's existing TTL
+    #   setting remains unchanged. For information about `HardDelete`, see
+    #   the [DeleteRecord][1] operation in the Amazon SageMaker API
+    #   Reference.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_feature_store_DeleteRecord.html
+    #   @return [Types::TtlDuration]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sagemaker-featurestore-runtime-2020-07-01/UpdateRecordRequest AWS API Documentation
+    #
+    class UpdateRecordRequest < Struct.new(
+      :feature_group_name,
+      :record_identifier_value_as_string,
+      :features,
+      :target_stores,
+      :ttl_duration)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # There was an error validating your request.
     #
     # @!attribute [rw] message

data/lib/aws-sdk-sagemakerfeaturestoreruntime.rb

@@ -54,7 +54,7 @@ module Aws::SageMakerFeatureStoreRuntime
   autoload :EndpointProvider, 'aws-sdk-sagemakerfeaturestoreruntime/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-sagemakerfeaturestoreruntime/endpoints'
 
-  GEM_VERSION = '1.67.0'
+  GEM_VERSION = '1.68.0'
 
 end
 

data/sig/client.rbs

@@ -183,6 +183,25 @@ module Aws
                         }
                       ) -> ::Seahorse::Client::_ResponseSuccess[::Aws::EmptyStructure]
                     | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> ::Seahorse::Client::_ResponseSuccess[::Aws::EmptyStructure]
+
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/SageMakerFeatureStoreRuntime/Client.html#update_record-instance_method
+      def update_record: (
+                           feature_group_name: ::String,
+                           record_identifier_value_as_string: ::String,
+                           features: Array[
+                             {
+                               feature_name: ::String,
+                               value_as_string: ::String?,
+                               value_as_string_list: Array[::String]?
+                             }
+                           ],
+                           ?target_stores: Array[("OnlineStore" | "OfflineStore")],
+                           ?ttl_duration: {
+                             unit: ("Seconds" | "Minutes" | "Hours" | "Days" | "Weeks"),
+                             value: ::Integer
+                           }
+                         ) -> ::Seahorse::Client::_ResponseSuccess[::Aws::EmptyStructure]
+                       | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> ::Seahorse::Client::_ResponseSuccess[::Aws::EmptyStructure]
     end
   end
 end

data/sig/errors.rbs

@@ -14,6 +14,9 @@ module Aws
       class AccessForbidden < ::Aws::Errors::ServiceError
         def message: () -> ::String
       end
+      class ConflictException < ::Aws::Errors::ServiceError
+        def message: () -> ::String
+      end
       class InternalFailure < ::Aws::Errors::ServiceError
         def message: () -> ::String
       end

data/sig/types.rbs

@@ -76,6 +76,11 @@ module Aws::SageMakerFeatureStoreRuntime
       SENSITIVE: []
     end
 
+    class ConflictException
+      attr_accessor message: ::String
+      SENSITIVE: []
+    end
+
     class DeleteRecordRequest
       attr_accessor feature_group_name: ::String
       attr_accessor record_identifier_value_as_string: ::String
@@ -149,6 +154,15 @@ module Aws::SageMakerFeatureStoreRuntime
       SENSITIVE: []
     end
 
+    class UpdateRecordRequest
+      attr_accessor feature_group_name: ::String
+      attr_accessor record_identifier_value_as_string: ::String
+      attr_accessor features: ::Array[Types::FeatureValue]
+      attr_accessor target_stores: ::Array[("OnlineStore" | "OfflineStore")]
+      attr_accessor ttl_duration: Types::TtlDuration
+      SENSITIVE: []
+    end
+
     class ValidationError
       attr_accessor message: ::String
       SENSITIVE: []

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-sagemakerfeaturestoreruntime
 version: !ruby/object:Gem::Version
-  version: 1.67.0
+  version: 1.68.0
 platform: ruby
 authors:
 - Amazon Web Services