aws-sdk-rekognition 1.116.0 → 1.117.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 169d5325dfe33a9f19c367d62c41d860c0ec0506ea6ebae7bf244c3f98ce08a3
-  data.tar.gz: 25ee7ff693f8b0cb96271d0c539d1a54f4fc8d7f0bde5f9338835a33d6e7ba50
+  metadata.gz: 8f460eb63a351c2cf8f34040477b4bfceb01506fe47be7aaceab5ab6623fe294
+  data.tar.gz: 319d2f2fec2caa2d2eac631ea57e5de2fcc3987827aaa8903725cd25362cc737
 SHA512:
-  metadata.gz: fad9069b3ac830449d2853efbb76e8b73a001ebf081e14d3b6d93b2ac45cb08929cf9e399fb8e3065d60c93dd6bb2e84c55aa2fb2c160c16c69cdb734ece3039
-  data.tar.gz: cdc716bf4e6669033dda300b8ae075b403d6be58a75038bfe13f14c185e29c9b19df6a4c133a679a19bd87c4bee31d323095431ae9d5352c8b5e108106eae63a
+  metadata.gz: 38984f4ecfb64a7fce4aa93e66869855ceb24de5cbf5116bb9a1f140d76ce5ee8119d23c3ef37a1dfb22c2e3fdea31ffb62abfd3602117621f6880af3a8d7905
+  data.tar.gz: ef72a06929a9f1ebddad21c469aeb482e004f405810a3111018fffe561d13b20e72b5f31aba53dfbe3ed5c56bb001091847a3105b27d47b01e48f36fdbf68d6e

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.117.0 (2025-06-06)
+------------------
+
+* Feature - Adds support for defining an ordered preference list of different Rekognition Face Liveness challenge types when calling CreateFaceLivenessSession.
+
 1.116.0 (2025-06-02)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.116.0
+1.117.0

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

@@ -478,8 +478,14 @@ module Aws::Rekognition
 
     # Associates one or more faces with an existing UserID. Takes an array
     # of `FaceIds`. Each `FaceId` that are present in the `FaceIds` list is
-    # associated with the provided UserID. The maximum number of total
-    # `FaceIds` per UserID is 100.
+    # associated with the provided UserID. The number of FaceIds that can be
+    # used as input in a single request is limited to 100.
+    #
+    # Note that the total number of faces that can be associated with a
+    # single `UserID` is also limited to 100. Once a `UserID` has 100 faces
+    # associated with it, no additional faces can be added. If more API
+    # calls are made after the limit is reached, a
+    # `ServiceQuotaExceededException` will result.
     #
     # The `UserMatchThreshold` parameter specifies the minimum user match
     # confidence required for the face to be associated with a UserID that
@@ -1213,6 +1219,15 @@ module Aws::Rekognition
     #         s3_key_prefix: "LivenessS3KeyPrefix",
     #       },
     #       audit_images_limit: 1,
+    #       challenge_preferences: [
+    #         {
+    #           type: "FaceMovementAndLightChallenge", # required, accepts FaceMovementAndLightChallenge, FaceMovementChallenge
+    #           versions: {
+    #             minimum: "Version",
+    #             maximum: "Version",
+    #           },
+    #         },
+    #       ],
     #     },
     #     client_request_token: "ClientRequestToken",
     #   })
@@ -2627,8 +2642,7 @@ module Aws::Rekognition
     # `CustomLabel` object provides the label name (`Name`), the level of
     # confidence that the image contains the object (`Confidence`), and
     # object location information, if it exists, for the label on the image
-    # (`Geometry`). Note that for the `DetectCustomLabelsLabels` operation,
-    # `Polygons` are not returned in the `Geometry` section of the response.
+    # (`Geometry`).
     #
     # To filter labels that are returned, specify a value for
     # `MinConfidence`. `DetectCustomLabelsLabels` only returns labels with a
@@ -4266,6 +4280,7 @@ module Aws::Rekognition
     #   * {Types::GetFaceLivenessSessionResultsResponse#confidence #confidence} => Float
     #   * {Types::GetFaceLivenessSessionResultsResponse#reference_image #reference_image} => Types::AuditImage
     #   * {Types::GetFaceLivenessSessionResultsResponse#audit_images #audit_images} => Array<Types::AuditImage>
+    #   * {Types::GetFaceLivenessSessionResultsResponse#challenge #challenge} => Types::Challenge
     #
     # @example Request syntax with placeholder values
     #
@@ -4295,6 +4310,8 @@ module Aws::Rekognition
     #   resp.audit_images[0].bounding_box.height #=> Float
     #   resp.audit_images[0].bounding_box.left #=> Float
     #   resp.audit_images[0].bounding_box.top #=> Float
+    #   resp.challenge.type #=> String, one of "FaceMovementAndLightChallenge", "FaceMovementChallenge"
+    #   resp.challenge.version #=> String
     #
     # @overload get_face_liveness_session_results(params = {})
     # @param [Hash] params ({})
@@ -4761,6 +4778,13 @@ module Aws::Rekognition
       req.send_request(options)
     end
 
+    # <note markdown="1"> *End of support notice:* On October 31, 2025, AWS will discontinue
+    # support for Amazon Rekognition People Pathing. After October 31, 2025,
+    # you will no longer be able to use the Rekognition People Pathing
+    # capability. For more information, visit this [blog post][1].
+    #
+    #  </note>
+    #
     # Gets the path tracking results of a Amazon Rekognition Video analysis
     # started by StartPersonTracking.
     #
@@ -4800,6 +4824,10 @@ module Aws::Rekognition
     # with the token value returned from the previous call to
     # `GetPersonTracking`.
     #
+    #
+    #
+    # [1]: https://aws.amazon.com/blogs/machine-learning/transitioning-from-amazon-rekognition-people-pathing-exploring-other-alternatives/
+    #
     # @option params [required, String] :job_id
     #   The identifier for a job that tracks persons in a video. You get the
     #   `JobId` from a call to `StartPersonTracking`.
@@ -7764,6 +7792,13 @@ module Aws::Rekognition
       req.send_request(options)
     end
 
+    # <note markdown="1"> *End of support notice:* On October 31, 2025, AWS will discontinue
+    # support for Amazon Rekognition People Pathing. After October 31, 2025,
+    # you will no longer be able to use the Rekognition People Pathing
+    # capability. For more information, visit this [blog post][1].
+    #
+    #  </note>
+    #
     # Starts the asynchronous tracking of a person's path in a stored
     # video.
     #
@@ -7780,6 +7815,10 @@ module Aws::Rekognition
     # so, call GetPersonTracking and pass the job identifier (`JobId`) from
     # the initial call to `StartPersonTracking`.
     #
+    #
+    #
+    # [1]: https://aws.amazon.com/blogs/machine-learning/transitioning-from-amazon-rekognition-people-pathing-exploring-other-alternatives/
+    #
     # @option params [required, Types::Video] :video
     #   The video in which you want to detect people. The video must be stored
     #   in an Amazon S3 bucket.
@@ -8481,7 +8520,7 @@ module Aws::Rekognition
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-rekognition'
-      context[:gem_version] = '1.116.0'
+      context[:gem_version] = '1.117.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -43,6 +43,10 @@ module Aws::Rekognition
     CelebrityRecognition = Shapes::StructureShape.new(name: 'CelebrityRecognition')
     CelebrityRecognitionSortBy = Shapes::StringShape.new(name: 'CelebrityRecognitionSortBy')
     CelebrityRecognitions = Shapes::ListShape.new(name: 'CelebrityRecognitions')
+    Challenge = Shapes::StructureShape.new(name: 'Challenge')
+    ChallengePreference = Shapes::StructureShape.new(name: 'ChallengePreference')
+    ChallengePreferences = Shapes::ListShape.new(name: 'ChallengePreferences')
+    ChallengeType = Shapes::StringShape.new(name: 'ChallengeType')
     ClientRequestToken = Shapes::StringShape.new(name: 'ClientRequestToken')
     CollectionId = Shapes::StringShape.new(name: 'CollectionId')
     CollectionIdList = Shapes::ListShape.new(name: 'CollectionIdList')
@@ -542,9 +546,11 @@ module Aws::Rekognition
     UserMatchList = Shapes::ListShape.new(name: 'UserMatchList')
     UserStatus = Shapes::StringShape.new(name: 'UserStatus')
     ValidationData = Shapes::StructureShape.new(name: 'ValidationData')
+    Version = Shapes::StringShape.new(name: 'Version')
     VersionDescription = Shapes::StringShape.new(name: 'VersionDescription')
     VersionName = Shapes::StringShape.new(name: 'VersionName')
     VersionNames = Shapes::ListShape.new(name: 'VersionNames')
+    Versions = Shapes::StructureShape.new(name: 'Versions')
     Video = Shapes::StructureShape.new(name: 'Video')
     VideoColorRange = Shapes::StringShape.new(name: 'VideoColorRange')
     VideoJobStatus = Shapes::StringShape.new(name: 'VideoJobStatus')
@@ -638,6 +644,16 @@ module Aws::Rekognition
 
     CelebrityRecognitions.member = Shapes::ShapeRef.new(shape: CelebrityRecognition)
 
+    Challenge.add_member(:type, Shapes::ShapeRef.new(shape: ChallengeType, required: true, location_name: "Type"))
+    Challenge.add_member(:version, Shapes::ShapeRef.new(shape: Version, required: true, location_name: "Version"))
+    Challenge.struct_class = Types::Challenge
+
+    ChallengePreference.add_member(:type, Shapes::ShapeRef.new(shape: ChallengeType, required: true, location_name: "Type"))
+    ChallengePreference.add_member(:versions, Shapes::ShapeRef.new(shape: Versions, location_name: "Versions"))
+    ChallengePreference.struct_class = Types::ChallengePreference
+
+    ChallengePreferences.member = Shapes::ShapeRef.new(shape: ChallengePreference)
+
     CollectionIdList.member = Shapes::ShapeRef.new(shape: CollectionId)
 
     CompareFacesMatch.add_member(:similarity, Shapes::ShapeRef.new(shape: Percent, location_name: "Similarity"))
@@ -747,6 +763,7 @@ module Aws::Rekognition
 
     CreateFaceLivenessSessionRequestSettings.add_member(:output_config, Shapes::ShapeRef.new(shape: LivenessOutputConfig, location_name: "OutputConfig"))
     CreateFaceLivenessSessionRequestSettings.add_member(:audit_images_limit, Shapes::ShapeRef.new(shape: AuditImagesLimit, location_name: "AuditImagesLimit"))
+    CreateFaceLivenessSessionRequestSettings.add_member(:challenge_preferences, Shapes::ShapeRef.new(shape: ChallengePreferences, location_name: "ChallengePreferences"))
     CreateFaceLivenessSessionRequestSettings.struct_class = Types::CreateFaceLivenessSessionRequestSettings
 
     CreateFaceLivenessSessionResponse.add_member(:session_id, Shapes::ShapeRef.new(shape: LivenessSessionId, required: true, location_name: "SessionId"))
@@ -1275,6 +1292,7 @@ module Aws::Rekognition
     GetFaceLivenessSessionResultsResponse.add_member(:confidence, Shapes::ShapeRef.new(shape: Percent, location_name: "Confidence"))
     GetFaceLivenessSessionResultsResponse.add_member(:reference_image, Shapes::ShapeRef.new(shape: AuditImage, location_name: "ReferenceImage"))
     GetFaceLivenessSessionResultsResponse.add_member(:audit_images, Shapes::ShapeRef.new(shape: AuditImages, location_name: "AuditImages"))
+    GetFaceLivenessSessionResultsResponse.add_member(:challenge, Shapes::ShapeRef.new(shape: Challenge, location_name: "Challenge"))
     GetFaceLivenessSessionResultsResponse.struct_class = Types::GetFaceLivenessSessionResultsResponse
 
     GetFaceSearchRequest.add_member(:job_id, Shapes::ShapeRef.new(shape: JobId, required: true, location_name: "JobId"))
@@ -2223,6 +2241,10 @@ module Aws::Rekognition
 
     VersionNames.member = Shapes::ShapeRef.new(shape: VersionName)
 
+    Versions.add_member(:minimum, Shapes::ShapeRef.new(shape: Version, location_name: "Minimum"))
+    Versions.add_member(:maximum, Shapes::ShapeRef.new(shape: Version, location_name: "Maximum"))
+    Versions.struct_class = Types::Versions
+
     Video.add_member(:s3_object, Shapes::ShapeRef.new(shape: S3Object, location_name: "S3Object"))
     Video.struct_class = Types::Video
 

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

@@ -432,6 +432,44 @@ module Aws::Rekognition
       include Aws::Structure
     end
 
+    # Describes the type and version of the challenge being used for the
+    # Face Liveness session.
+    #
+    # @!attribute [rw] type
+    #   The type of the challenge being used for the Face Liveness session.
+    #   @return [String]
+    #
+    # @!attribute [rw] version
+    #   The version of the challenge being used for the Face Liveness
+    #   session.
+    #   @return [String]
+    #
+    class Challenge < Struct.new(
+      :type,
+      :version)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # An ordered list of preferred challenge type and versions.
+    #
+    # @!attribute [rw] type
+    #   The types of challenges that have been selected for the Face
+    #   Liveness session.
+    #   @return [String]
+    #
+    # @!attribute [rw] versions
+    #   The version of the challenges that have been selected for the Face
+    #   Liveness session.
+    #   @return [Types::Versions]
+    #
+    class ChallengePreference < Struct.new(
+      :type,
+      :versions)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Provides information about a face in a target image that matches the
     # source image face analyzed by `CompareFaces`. The `Face` property
     # contains the bounding box of the face in the target image. The
@@ -974,9 +1012,15 @@ module Aws::Rekognition
     #   selfie-video.
     #   @return [Integer]
     #
+    # @!attribute [rw] challenge_preferences
+    #   Indicates preferred challenge types and versions for the Face
+    #   Liveness session to be created.
+    #   @return [Array<Types::ChallengePreference>]
+    #
     class CreateFaceLivenessSessionRequestSettings < Struct.new(
       :output_config,
-      :audit_images_limit)
+      :audit_images_limit,
+      :challenge_preferences)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2717,12 +2761,14 @@ module Aws::Rekognition
       include Aws::Structure
     end
 
-    # The emotions that appear to be expressed on the face, and the
-    # confidence level in the determination. The API is only making a
-    # determination of the physical appearance of a person's face. It is
-    # not a determination of the person’s internal emotional state and
-    # should not be used in such a way. For example, a person pretending to
-    # have a sad face might not be sad emotionally.
+    # The API returns a prediction of an emotion based on a person's facial
+    # expressions, along with the confidence level for the predicted
+    # emotion. It is not a determination of the person’s internal emotional
+    # state and should not be used in such a way. For example, a person
+    # pretending to have a sad face might not be sad emotionally. The API is
+    # not intended to be used, and you may not use it, in a manner that
+    # violates the EU Artificial Intelligence Act or any other applicable
+    # law.
     #
     # @!attribute [rw] type
     #   Type of emotion detected.
@@ -3629,12 +3675,18 @@ module Aws::Rekognition
     #   instead.
     #   @return [Array<Types::AuditImage>]
     #
+    # @!attribute [rw] challenge
+    #   Contains information regarding the challenge type used for the Face
+    #   Liveness check.
+    #   @return [Types::Challenge]
+    #
     class GetFaceLivenessSessionResultsResponse < Struct.new(
       :session_id,
       :status,
       :confidence,
       :reference_image,
-      :audit_images)
+      :audit_images,
+      :challenge)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -8266,6 +8318,23 @@ module Aws::Rekognition
       include Aws::Structure
     end
 
+    # Object specifying the acceptable range of challenge versions.
+    #
+    # @!attribute [rw] minimum
+    #   The desired minimum version for the challenge.
+    #   @return [String]
+    #
+    # @!attribute [rw] maximum
+    #   The desired maximum version for the challenge.
+    #   @return [String]
+    #
+    class Versions < Struct.new(
+      :minimum,
+      :maximum)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Video file stored in an Amazon S3 bucket. Amazon Rekognition video
     # start operations such as StartLabelDetection use `Video` to specify a
     # video for analysis. The supported file formats are .mp4, .mov and

data/lib/aws-sdk-rekognition.rb

@@ -55,7 +55,7 @@ module Aws::Rekognition
   autoload :EndpointProvider, 'aws-sdk-rekognition/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-rekognition/endpoints'
 
-  GEM_VERSION = '1.116.0'
+  GEM_VERSION = '1.117.0'
 
 end
 

data/sig/client.rbs

@@ -191,7 +191,16 @@ module Aws
                                               s3_bucket: ::String,
                                               s3_key_prefix: ::String?
                                             }?,
-                                            audit_images_limit: ::Integer?
+                                            audit_images_limit: ::Integer?,
+                                            challenge_preferences: Array[
+                                              {
+                                                type: ("FaceMovementAndLightChallenge" | "FaceMovementChallenge"),
+                                                versions: {
+                                                  minimum: ::String?,
+                                                  maximum: ::String?
+                                                }?
+                                              },
+                                            ]?
                                           },
                                           ?client_request_token: ::String
                                         ) -> _CreateFaceLivenessSessionResponseSuccess
@@ -763,6 +772,7 @@ module Aws
         def confidence: () -> ::Float
         def reference_image: () -> Types::AuditImage
         def audit_images: () -> ::Array[Types::AuditImage]
+        def challenge: () -> Types::Challenge
       end
       # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Rekognition/Client.html#get_face_liveness_session_results-instance_method
       def get_face_liveness_session_results: (

data/sig/types.rbs

@@ -105,6 +105,18 @@ module Aws::Rekognition
       SENSITIVE: []
     end
 
+    class Challenge
+      attr_accessor type: ("FaceMovementAndLightChallenge" | "FaceMovementChallenge")
+      attr_accessor version: ::String
+      SENSITIVE: []
+    end
+
+    class ChallengePreference
+      attr_accessor type: ("FaceMovementAndLightChallenge" | "FaceMovementChallenge")
+      attr_accessor versions: Types::Versions
+      SENSITIVE: []
+    end
+
     class CompareFacesMatch
       attr_accessor similarity: ::Float
       attr_accessor face: Types::ComparedFace
@@ -234,6 +246,7 @@ module Aws::Rekognition
     class CreateFaceLivenessSessionRequestSettings
       attr_accessor output_config: Types::LivenessOutputConfig
       attr_accessor audit_images_limit: ::Integer
+      attr_accessor challenge_preferences: ::Array[Types::ChallengePreference]
       SENSITIVE: []
     end
 
@@ -914,6 +927,7 @@ module Aws::Rekognition
       attr_accessor confidence: ::Float
       attr_accessor reference_image: Types::AuditImage
       attr_accessor audit_images: ::Array[Types::AuditImage]
+      attr_accessor challenge: Types::Challenge
       SENSITIVE: []
     end
 
@@ -2116,6 +2130,12 @@ module Aws::Rekognition
       SENSITIVE: []
     end
 
+    class Versions
+      attr_accessor minimum: ::String
+      attr_accessor maximum: ::String
+      SENSITIVE: []
+    end
+
     class Video
       attr_accessor s3_object: Types::S3Object
       SENSITIVE: []

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-rekognition
 version: !ruby/object:Gem::Version
-  version: 1.116.0
+  version: 1.117.0
 platform: ruby
 authors:
 - Amazon Web Services