aws-sdk-rekognition 1.51.0 → 1.55.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 709460c698f273a75c1b14b0e2e2b6d6f492843c4b10dc26c994bfc59857095a
-  data.tar.gz: 442cded6750bd3b1db14e0f43148b982211be699715995a948900e0ea1d0aa14
+  metadata.gz: 7eeed39966b02dbca262b06448e70e72199cf1be48216013201792fb3f4bc779
+  data.tar.gz: 328270c34037105ee62bb85c125603be2d9f3d7bdf3c47d0195e2118171ebb07
 SHA512:
-  metadata.gz: f139ba6134b751e92ddb02b72217540671ea04904bab47ecc4ed77b2ff434de96ae775686e82e345c33ebab7681e867732a0fa37f1e27a7471e2f2e1f1ba9a20
-  data.tar.gz: 58ae5f48bc2a2cad7569200a2ee401fe933c2a67b2cb0f24dedef2db3a7bfb4d4040c5d36725b34f75cbbbf8fd0299bbc9c6dcc13d5cdc39c846b52f16e843be
+  metadata.gz: cdf637272f8f63dd7cd98e866de36e35a5be0c11ba3d3e04cc7ebb41922a52fb7c0d6e78b4d160e8cdb90ada2d1c1bb2cdb1682bdfd086d010b746d8c4a3baf5
+  data.tar.gz: 93af3da3840cfc76847214f6f7ae61789cca32152f9978256030332ea169b052a40354e72c7d38f6fb5ed913731277ee741d3d6b6081660c483232a1369b607d

data/CHANGELOG.md

@@ -1,6 +1,26 @@
 Unreleased Changes
 ------------------
 
+1.55.0 (2021-08-26)
+------------------
+
+* Feature - This release added new attributes to Rekognition RecognizeCelebities and GetCelebrityInfo API operations.
+
+1.54.0 (2021-08-09)
+------------------
+
+* Feature - This release adds support for four new types of segments (opening credits, content segments, slates, and studio logos), improved accuracy for credits and shot detection and new filters to control black frame detection.
+
+1.53.0 (2021-07-30)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.52.0 (2021-07-28)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
 1.51.0 (2021-05-19)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.51.0
+1.55.0

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

@@ -547,6 +547,11 @@ module Aws::Rekognition
     #   resp.face_matches[0].face.pose.pitch #=> Float
     #   resp.face_matches[0].face.quality.brightness #=> Float
     #   resp.face_matches[0].face.quality.sharpness #=> Float
+    #   resp.face_matches[0].face.emotions #=> Array
+    #   resp.face_matches[0].face.emotions[0].type #=> String, one of "HAPPY", "SAD", "ANGRY", "CONFUSED", "DISGUSTED", "SURPRISED", "CALM", "UNKNOWN", "FEAR"
+    #   resp.face_matches[0].face.emotions[0].confidence #=> Float
+    #   resp.face_matches[0].face.smile.value #=> Boolean
+    #   resp.face_matches[0].face.smile.confidence #=> Float
     #   resp.unmatched_faces #=> Array
     #   resp.unmatched_faces[0].bounding_box.width #=> Float
     #   resp.unmatched_faces[0].bounding_box.height #=> Float
@@ -562,6 +567,11 @@ module Aws::Rekognition
     #   resp.unmatched_faces[0].pose.pitch #=> Float
     #   resp.unmatched_faces[0].quality.brightness #=> Float
     #   resp.unmatched_faces[0].quality.sharpness #=> Float
+    #   resp.unmatched_faces[0].emotions #=> Array
+    #   resp.unmatched_faces[0].emotions[0].type #=> String, one of "HAPPY", "SAD", "ANGRY", "CONFUSED", "DISGUSTED", "SURPRISED", "CALM", "UNKNOWN", "FEAR"
+    #   resp.unmatched_faces[0].emotions[0].confidence #=> Float
+    #   resp.unmatched_faces[0].smile.value #=> Boolean
+    #   resp.unmatched_faces[0].smile.confidence #=> Float
     #   resp.source_image_orientation_correction #=> String, one of "ROTATE_0", "ROTATE_90", "ROTATE_180", "ROTATE_270"
     #   resp.target_image_orientation_correction #=> String, one of "ROTATE_0", "ROTATE_90", "ROTATE_180", "ROTATE_270"
     #
@@ -699,7 +709,9 @@ module Aws::Rekognition
     #   A name for the version of the model. This value must be unique.
     #
     # @option params [required, Types::OutputConfig] :output_config
-    #   The Amazon S3 location to store the results of training.
+    #   The Amazon S3 bucket location to store the results of training. The S3
+    #   bucket can be in any AWS account as long as the caller has
+    #   `s3:PutObject` permissions on the S3 bucket.
     #
     # @option params [required, Types::TrainingData] :training_data
     #   The dataset to use for training.
@@ -713,11 +725,22 @@ module Aws::Rekognition
     # @option params [String] :kms_key_id
     #   The identifier for your AWS Key Management Service (AWS KMS) customer
     #   master key (CMK). You can supply the Amazon Resource Name (ARN) of
-    #   your CMK, the ID of your CMK, or an alias for your CMK. The key is
-    #   used to encrypt training and test images copied into the service for
-    #   model training. Your source images are unaffected. The key is also
-    #   used to encrypt training results and manifest files written to the
-    #   output Amazon S3 bucket (`OutputConfig`).
+    #   your CMK, the ID of your CMK, an alias for your CMK, or an alias ARN.
+    #   The key is used to encrypt training and test images copied into the
+    #   service for model training. Your source images are unaffected. The key
+    #   is also used to encrypt training results and manifest files written to
+    #   the output Amazon S3 bucket (`OutputConfig`).
+    #
+    #   If you choose to use your own CMK, you need the following permissions
+    #   on the CMK.
+    #
+    #   * kms:CreateGrant
+    #
+    #   * kms:DescribeKey
+    #
+    #   * kms:GenerateDataKey
+    #
+    #   * kms:Decrypt
     #
     #   If you don't specify a value for `KmsKeyId`, images copied into the
     #   service are encrypted using a key that AWS owns and manages.
@@ -1322,18 +1345,23 @@ module Aws::Rekognition
     # object location information, if it exists, for the label on the image
     # (`Geometry`).
     #
-    # During training model calculates a threshold value that determines if
-    # a prediction for a label is true. By default, `DetectCustomLabels`
-    # doesn't return labels whose confidence value is below the model's
-    # calculated threshold value. To filter labels that are returned,
-    # specify a value for `MinConfidence` that is higher than the model's
-    # calculated threshold. You can get the model's calculated threshold
-    # from the model's training results shown in the Amazon Rekognition
-    # Custom Labels console. To get all labels, regardless of confidence,
-    # specify a `MinConfidence` value of 0.
-    #
-    # You can also add the `MaxResults` parameter to limit the number of
-    # labels returned.
+    # To filter labels that are returned, specify a value for
+    # `MinConfidence`. `DetectCustomLabelsLabels` only returns labels with a
+    # confidence that's higher than the specified value. The value of
+    # `MinConfidence` maps to the assumed threshold values created during
+    # training. For more information, see *Assumed threshold* in the Amazon
+    # Rekognition Custom Labels Developer Guide. Amazon Rekognition Custom
+    # Labels metrics expresses an assumed threshold as a floating point
+    # value between 0-1. The range of `MinConfidence` normalizes the
+    # threshold value to a percentage value (0-100). Confidence responses
+    # from `DetectCustomLabels` are also returned as a percentage. You can
+    # use `MinConfidence` to change the precision and recall or your model.
+    # For more information, see *Analyzing an image* in the Amazon
+    # Rekognition Custom Labels Developer Guide.
+    #
+    # If you don't specify a value for `MinConfidence`,
+    # `DetectCustomLabels` returns labels based on the assumed threshold of
+    # each label.
     #
     # This is a stateless API operation. That is, the operation does not
     # persist any data.
@@ -1341,6 +1369,9 @@ module Aws::Rekognition
     # This operation requires permissions to perform the
     # `rekognition:DetectCustomLabels` action.
     #
+    # For more information, see *Analyzing an image* in the Amazon
+    # Rekognition Custom Labels Developer Guide.
+    #
     # @option params [required, String] :project_version_arn
     #   The ARN of the model version that you want to use.
     #
@@ -1380,10 +1411,12 @@ module Aws::Rekognition
     #
     # @option params [Float] :min_confidence
     #   Specifies the minimum confidence level for the labels to return.
-    #   Amazon Rekognition doesn't return any labels with a confidence lower
-    #   than this specified value. If you specify a value of 0, all labels are
-    #   return, regardless of the default thresholds that the model version
-    #   applies.
+    #   `DetectCustomLabels` doesn't return any labels with a confidence
+    #   value that's lower than this specified value. If you specify a value
+    #   of 0, `DetectCustomLabels` returns all labels, regardless of the
+    #   assumed threshold applied to each label. If you don't specify a value
+    #   for `MinConfidence`, `DetectCustomLabels` returns labels based on the
+    #   assumed threshold of each label.
     #
     # @return [Types::DetectCustomLabelsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1990,7 +2023,7 @@ module Aws::Rekognition
     # the image.
     #
     # A word is one or more ISO basic latin script characters that are not
-    # separated by spaces. `DetectText` can detect up to 50 words in an
+    # separated by spaces. `DetectText` can detect up to 100 words in an
     # image.
     #
     # A line is a string of equally spaced words. A line isn't necessarily
@@ -2086,9 +2119,9 @@ module Aws::Rekognition
     end
 
     # Gets the name and additional information about a celebrity based on
-    # his or her Amazon Rekognition ID. The additional information is
-    # returned as an array of URLs. If there is no additional information
-    # about the celebrity, this list is empty.
+    # their Amazon Rekognition ID. The additional information is returned as
+    # an array of URLs. If there is no additional information about the
+    # celebrity, this list is empty.
     #
     # For more information, see Recognizing Celebrities in an Image in the
     # Amazon Rekognition Developer Guide.
@@ -2105,6 +2138,7 @@ module Aws::Rekognition
     #
     #   * {Types::GetCelebrityInfoResponse#urls #urls} => Array<String>
     #   * {Types::GetCelebrityInfoResponse#name #name} => String
+    #   * {Types::GetCelebrityInfoResponse#known_gender #known_gender} => Types::KnownGender
     #
     # @example Request syntax with placeholder values
     #
@@ -2117,6 +2151,7 @@ module Aws::Rekognition
     #   resp.urls #=> Array
     #   resp.urls[0] #=> String
     #   resp.name #=> String
+    #   resp.known_gender.type #=> String, one of "Male", "Female"
     #
     # @overload get_celebrity_info(params = {})
     # @param [Hash] params ({})
@@ -2225,6 +2260,7 @@ module Aws::Rekognition
     #   resp.video_metadata.frame_rate #=> Float
     #   resp.video_metadata.frame_height #=> Integer
     #   resp.video_metadata.frame_width #=> Integer
+    #   resp.video_metadata.color_range #=> String, one of "FULL", "LIMITED"
     #   resp.next_token #=> String
     #   resp.celebrities #=> Array
     #   resp.celebrities[0].timestamp #=> Integer
@@ -2280,26 +2316,29 @@ module Aws::Rekognition
       req.send_request(options)
     end
 
-    # Gets the unsafe content analysis results for a Amazon Rekognition
-    # Video analysis started by StartContentModeration.
-    #
-    # Unsafe content analysis of a video is an asynchronous operation. You
-    # start analysis by calling StartContentModeration which returns a job
-    # identifier (`JobId`). When analysis finishes, Amazon Rekognition Video
-    # publishes a completion status to the Amazon Simple Notification
-    # Service topic registered in the initial call to
-    # `StartContentModeration`. To get the results of the unsafe content
-    # analysis, first check that the status value published to the Amazon
-    # SNS topic is `SUCCEEDED`. If so, call `GetContentModeration` and pass
-    # the job identifier (`JobId`) from the initial call to
-    # `StartContentModeration`.
+    # Gets the inappropriate, unwanted, or offensive content analysis
+    # results for a Amazon Rekognition Video analysis started by
+    # StartContentModeration. For a list of moderation labels in Amazon
+    # Rekognition, see [Using the image and video moderation APIs][1].
+    #
+    # Amazon Rekognition Video inappropriate or offensive content detection
+    # in a stored video is an asynchronous operation. You start analysis by
+    # calling StartContentModeration which returns a job identifier
+    # (`JobId`). When analysis finishes, Amazon Rekognition Video publishes
+    # a completion status to the Amazon Simple Notification Service topic
+    # registered in the initial call to `StartContentModeration`. To get the
+    # results of the content analysis, first check that the status value
+    # published to the Amazon SNS topic is `SUCCEEDED`. If so, call
+    # `GetContentModeration` and pass the job identifier (`JobId`) from the
+    # initial call to `StartContentModeration`.
     #
     # For more information, see Working with Stored Videos in the Amazon
     # Rekognition Devlopers Guide.
     #
-    # `GetContentModeration` returns detected unsafe content labels, and the
-    # time they are detected, in an array, `ModerationLabels`, of
-    # ContentModerationDetection objects.
+    # `GetContentModeration` returns detected inappropriate, unwanted, or
+    # offensive content moderation labels, and the time they are detected,
+    # in an array, `ModerationLabels`, of ContentModerationDetection
+    # objects.
     #
     # By default, the moderated labels are returned sorted by time, in
     # milliseconds from the start of the video. You can also sort them by
@@ -2314,12 +2353,17 @@ module Aws::Rekognition
     # and populate the `NextToken` request parameter with the value of
     # `NextToken` returned from the previous call to `GetContentModeration`.
     #
-    # For more information, see Detecting Unsafe Content in the Amazon
-    # Rekognition Developer Guide.
+    # For more information, see Content moderation in the Amazon Rekognition
+    # Developer Guide.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/rekognition/latest/dg/moderation.html#moderation-api
     #
     # @option params [required, String] :job_id
-    #   The identifier for the unsafe content job. Use `JobId` to identify the
-    #   job in a subsequent call to `GetContentModeration`.
+    #   The identifier for the inappropriate, unwanted, or offensive content
+    #   moderation job. Use `JobId` to identify the job in a subsequent call
+    #   to `GetContentModeration`.
     #
     # @option params [Integer] :max_results
     #   Maximum number of results to return per paginated call. The largest
@@ -2331,7 +2375,7 @@ module Aws::Rekognition
     #   If the previous response was incomplete (because there is more data to
     #   retrieve), Amazon Rekognition returns a pagination token in the
     #   response. You can use this pagination token to retrieve the next set
-    #   of unsafe content labels.
+    #   of content moderation labels.
     #
     # @option params [String] :sort_by
     #   Sort to use for elements in the `ModerationLabelDetections` array. Use
@@ -2370,6 +2414,7 @@ module Aws::Rekognition
     #   resp.video_metadata.frame_rate #=> Float
     #   resp.video_metadata.frame_height #=> Integer
     #   resp.video_metadata.frame_width #=> Integer
+    #   resp.video_metadata.color_range #=> String, one of "FULL", "LIMITED"
     #   resp.moderation_labels #=> Array
     #   resp.moderation_labels[0].timestamp #=> Integer
     #   resp.moderation_labels[0].moderation_label.confidence #=> Float
@@ -2453,6 +2498,7 @@ module Aws::Rekognition
     #   resp.video_metadata.frame_rate #=> Float
     #   resp.video_metadata.frame_height #=> Integer
     #   resp.video_metadata.frame_width #=> Integer
+    #   resp.video_metadata.color_range #=> String, one of "FULL", "LIMITED"
     #   resp.next_token #=> String
     #   resp.faces #=> Array
     #   resp.faces[0].timestamp #=> Integer
@@ -2586,6 +2632,7 @@ module Aws::Rekognition
     #   resp.video_metadata.frame_rate #=> Float
     #   resp.video_metadata.frame_height #=> Integer
     #   resp.video_metadata.frame_width #=> Integer
+    #   resp.video_metadata.color_range #=> String, one of "FULL", "LIMITED"
     #   resp.persons #=> Array
     #   resp.persons[0].timestamp #=> Integer
     #   resp.persons[0].person.index #=> Integer
@@ -2733,6 +2780,7 @@ module Aws::Rekognition
     #   resp.video_metadata.frame_rate #=> Float
     #   resp.video_metadata.frame_height #=> Integer
     #   resp.video_metadata.frame_width #=> Integer
+    #   resp.video_metadata.color_range #=> String, one of "FULL", "LIMITED"
     #   resp.next_token #=> String
     #   resp.labels #=> Array
     #   resp.labels[0].timestamp #=> Integer
@@ -2846,6 +2894,7 @@ module Aws::Rekognition
     #   resp.video_metadata.frame_rate #=> Float
     #   resp.video_metadata.frame_height #=> Integer
     #   resp.video_metadata.frame_width #=> Integer
+    #   resp.video_metadata.color_range #=> String, one of "FULL", "LIMITED"
     #   resp.next_token #=> String
     #   resp.persons #=> Array
     #   resp.persons[0].timestamp #=> Integer
@@ -2978,6 +3027,7 @@ module Aws::Rekognition
     #   resp.video_metadata[0].frame_rate #=> Float
     #   resp.video_metadata[0].frame_height #=> Integer
     #   resp.video_metadata[0].frame_width #=> Integer
+    #   resp.video_metadata[0].color_range #=> String, one of "FULL", "LIMITED"
     #   resp.audio_metadata #=> Array
     #   resp.audio_metadata[0].codec #=> String
     #   resp.audio_metadata[0].duration_millis #=> Integer
@@ -2992,10 +3042,13 @@ module Aws::Rekognition
     #   resp.segments[0].start_timecode_smpte #=> String
     #   resp.segments[0].end_timecode_smpte #=> String
     #   resp.segments[0].duration_smpte #=> String
-    #   resp.segments[0].technical_cue_segment.type #=> String, one of "ColorBars", "EndCredits", "BlackFrames"
+    #   resp.segments[0].technical_cue_segment.type #=> String, one of "ColorBars", "EndCredits", "BlackFrames", "OpeningCredits", "StudioLogo", "Slate", "Content"
     #   resp.segments[0].technical_cue_segment.confidence #=> Float
     #   resp.segments[0].shot_segment.index #=> Integer
     #   resp.segments[0].shot_segment.confidence #=> Float
+    #   resp.segments[0].start_frame_number #=> Integer
+    #   resp.segments[0].end_frame_number #=> Integer
+    #   resp.segments[0].duration_frames #=> Integer
     #   resp.selected_segment_types #=> Array
     #   resp.selected_segment_types[0].type #=> String, one of "TECHNICAL_CUE", "SHOT"
     #   resp.selected_segment_types[0].model_version #=> String
@@ -3082,6 +3135,7 @@ module Aws::Rekognition
     #   resp.video_metadata.frame_rate #=> Float
     #   resp.video_metadata.frame_height #=> Integer
     #   resp.video_metadata.frame_width #=> Integer
+    #   resp.video_metadata.color_range #=> String, one of "FULL", "LIMITED"
     #   resp.text_detections #=> Array
     #   resp.text_detections[0].timestamp #=> Integer
     #   resp.text_detections[0].text_detection.detected_text #=> String
@@ -3950,7 +4004,13 @@ module Aws::Rekognition
     #   resp.celebrity_faces[0].face.pose.pitch #=> Float
     #   resp.celebrity_faces[0].face.quality.brightness #=> Float
     #   resp.celebrity_faces[0].face.quality.sharpness #=> Float
+    #   resp.celebrity_faces[0].face.emotions #=> Array
+    #   resp.celebrity_faces[0].face.emotions[0].type #=> String, one of "HAPPY", "SAD", "ANGRY", "CONFUSED", "DISGUSTED", "SURPRISED", "CALM", "UNKNOWN", "FEAR"
+    #   resp.celebrity_faces[0].face.emotions[0].confidence #=> Float
+    #   resp.celebrity_faces[0].face.smile.value #=> Boolean
+    #   resp.celebrity_faces[0].face.smile.confidence #=> Float
     #   resp.celebrity_faces[0].match_confidence #=> Float
+    #   resp.celebrity_faces[0].known_gender.type #=> String, one of "Male", "Female"
     #   resp.unrecognized_faces #=> Array
     #   resp.unrecognized_faces[0].bounding_box.width #=> Float
     #   resp.unrecognized_faces[0].bounding_box.height #=> Float
@@ -3966,6 +4026,11 @@ module Aws::Rekognition
     #   resp.unrecognized_faces[0].pose.pitch #=> Float
     #   resp.unrecognized_faces[0].quality.brightness #=> Float
     #   resp.unrecognized_faces[0].quality.sharpness #=> Float
+    #   resp.unrecognized_faces[0].emotions #=> Array
+    #   resp.unrecognized_faces[0].emotions[0].type #=> String, one of "HAPPY", "SAD", "ANGRY", "CONFUSED", "DISGUSTED", "SURPRISED", "CALM", "UNKNOWN", "FEAR"
+    #   resp.unrecognized_faces[0].emotions[0].confidence #=> Float
+    #   resp.unrecognized_faces[0].smile.value #=> Boolean
+    #   resp.unrecognized_faces[0].smile.confidence #=> Float
     #   resp.orientation_correction #=> String, one of "ROTATE_0", "ROTATE_90", "ROTATE_180", "ROTATE_270"
     #
     # @overload recognize_celebrities(params = {})
@@ -4325,7 +4390,9 @@ module Aws::Rekognition
     # @option params [Types::NotificationChannel] :notification_channel
     #   The Amazon SNS topic ARN that you want Amazon Rekognition Video to
     #   publish the completion status of the celebrity recognition analysis
-    #   to.
+    #   to. The Amazon SNS topic must have a topic name that begins with
+    #   *AmazonRekognition* if you are using the AmazonRekognitionServiceRole
+    #   permissions policy.
     #
     # @option params [String] :job_tag
     #   An identifier you specify that's returned in the completion
@@ -4366,27 +4433,33 @@ module Aws::Rekognition
       req.send_request(options)
     end
 
-    # Starts asynchronous detection of unsafe content in a stored video.
+    # Starts asynchronous detection of inappropriate, unwanted, or offensive
+    # content in a stored video. For a list of moderation labels in Amazon
+    # Rekognition, see [Using the image and video moderation APIs][1].
     #
     # Amazon Rekognition Video can moderate content in a video stored in an
     # Amazon S3 bucket. Use Video to specify the bucket name and the
     # filename of the video. `StartContentModeration` returns a job
     # identifier (`JobId`) which you use to get the results of the analysis.
-    # When unsafe content analysis is finished, Amazon Rekognition Video
-    # publishes a completion status to the Amazon Simple Notification
-    # Service topic that you specify in `NotificationChannel`.
+    # When content analysis is finished, Amazon Rekognition Video publishes
+    # a completion status to the Amazon Simple Notification Service topic
+    # that you specify in `NotificationChannel`.
     #
-    # To get the results of the unsafe content analysis, first check that
-    # the status value published to the Amazon SNS topic is `SUCCEEDED`. If
-    # so, call GetContentModeration and pass the job identifier (`JobId`)
-    # from the initial call to `StartContentModeration`.
+    # To get the results of the content analysis, first check that the
+    # status value published to the Amazon SNS topic is `SUCCEEDED`. If so,
+    # call GetContentModeration and pass the job identifier (`JobId`) from
+    # the initial call to `StartContentModeration`.
+    #
+    # For more information, see Content moderation in the Amazon Rekognition
+    # Developer Guide.
     #
-    # For more information, see Detecting Unsafe Content in the Amazon
-    # Rekognition Developer Guide.
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/rekognition/latest/dg/moderation.html#moderation-api
     #
     # @option params [required, Types::Video] :video
-    #   The video in which you want to detect unsafe content. The video must
-    #   be stored in an Amazon S3 bucket.
+    #   The video in which you want to detect inappropriate, unwanted, or
+    #   offensive content. The video must be stored in an Amazon S3 bucket.
     #
     # @option params [Float] :min_confidence
     #   Specifies the minimum confidence that Amazon Rekognition must have in
@@ -4406,7 +4479,10 @@ module Aws::Rekognition
     #
     # @option params [Types::NotificationChannel] :notification_channel
     #   The Amazon SNS topic ARN that you want Amazon Rekognition Video to
-    #   publish the completion status of the unsafe content analysis to.
+    #   publish the completion status of the content analysis to. The Amazon
+    #   SNS topic must have a topic name that begins with *AmazonRekognition*
+    #   if you are using the AmazonRekognitionServiceRole permissions policy
+    #   to access the topic.
     #
     # @option params [String] :job_tag
     #   An identifier you specify that's returned in the completion
@@ -4478,7 +4554,9 @@ module Aws::Rekognition
     # @option params [Types::NotificationChannel] :notification_channel
     #   The ARN of the Amazon SNS topic to which you want Amazon Rekognition
     #   Video to publish the completion status of the face detection
-    #   operation.
+    #   operation. The Amazon SNS topic must have a topic name that begins
+    #   with *AmazonRekognition* if you are using the
+    #   AmazonRekognitionServiceRole permissions policy.
     #
     # @option params [String] :face_attributes
     #   The face attributes you want returned.
@@ -4563,7 +4641,10 @@ module Aws::Rekognition
     #
     # @option params [Types::NotificationChannel] :notification_channel
     #   The ARN of the Amazon SNS topic to which you want Amazon Rekognition
-    #   Video to publish the completion status of the search.
+    #   Video to publish the completion status of the search. The Amazon SNS
+    #   topic must have a topic name that begins with *AmazonRekognition* if
+    #   you are using the AmazonRekognitionServiceRole permissions policy to
+    #   access the topic.
     #
     # @option params [String] :job_tag
     #   An identifier you specify that's returned in the completion
@@ -4649,7 +4730,9 @@ module Aws::Rekognition
     #
     # @option params [Types::NotificationChannel] :notification_channel
     #   The Amazon SNS topic ARN you want Amazon Rekognition Video to publish
-    #   the completion status of the label detection operation to.
+    #   the completion status of the label detection operation to. The Amazon
+    #   SNS topic must have a topic name that begins with *AmazonRekognition*
+    #   if you are using the AmazonRekognitionServiceRole permissions policy.
     #
     # @option params [String] :job_tag
     #   An identifier you specify that's returned in the completion
@@ -4719,7 +4802,9 @@ module Aws::Rekognition
     #
     # @option params [Types::NotificationChannel] :notification_channel
     #   The Amazon SNS topic ARN you want Amazon Rekognition Video to publish
-    #   the completion status of the people detection operation to.
+    #   the completion status of the people detection operation to. The Amazon
+    #   SNS topic must have a topic name that begins with *AmazonRekognition*
+    #   if you are using the AmazonRekognitionServiceRole permissions policy.
     #
     # @option params [String] :job_tag
     #   An identifier you specify that's returned in the completion
@@ -4848,7 +4933,9 @@ module Aws::Rekognition
     # @option params [Types::NotificationChannel] :notification_channel
     #   The ARN of the Amazon SNS topic to which you want Amazon Rekognition
     #   Video to publish the completion status of the segment detection
-    #   operation.
+    #   operation. Note that the Amazon SNS topic must have a topic name that
+    #   begins with *AmazonRekognition* if you are using the
+    #   AmazonRekognitionServiceRole permissions policy to access the topic.
     #
     # @option params [String] :job_tag
     #   An identifier you specify that's returned in the completion
@@ -4886,6 +4973,10 @@ module Aws::Rekognition
     #     filters: {
     #       technical_cue_filter: {
     #         min_segment_confidence: 1.0,
+    #         black_frame: {
+    #           max_pixel_threshold: 1.0,
+    #           min_coverage_percentage: 1.0,
+    #         },
     #       },
     #       shot_filter: {
     #         min_segment_confidence: 1.0,
@@ -4958,7 +5049,15 @@ module Aws::Rekognition
     # @option params [Types::NotificationChannel] :notification_channel
     #   The Amazon Simple Notification Service topic to which Amazon
     #   Rekognition publishes the completion status of a video analysis
-    #   operation. For more information, see api-video.
+    #   operation. For more information, see api-video. Note that the Amazon
+    #   SNS topic must have a topic name that begins with *AmazonRekognition*
+    #   if you are using the AmazonRekognitionServiceRole permissions policy
+    #   to access the topic. For more information, see [Giving access to
+    #   multiple Amazon SNS topics][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/rekognition/latest/dg/api-video-roles.html#api-video-roles-all-topics
     #
     # @option params [String] :job_tag
     #   An identifier returned in the completion status published by your
@@ -5150,7 +5249,7 @@ module Aws::Rekognition
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-rekognition'
-      context[:gem_version] = '1.51.0'
+      context[:gem_version] = '1.55.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -22,6 +22,7 @@ module Aws::Rekognition
     AudioMetadata = Shapes::StructureShape.new(name: 'AudioMetadata')
     AudioMetadataList = Shapes::ListShape.new(name: 'AudioMetadataList')
     Beard = Shapes::StructureShape.new(name: 'Beard')
+    BlackFrame = Shapes::StructureShape.new(name: 'BlackFrame')
     BodyPart = Shapes::StringShape.new(name: 'BodyPart')
     BodyParts = Shapes::ListShape.new(name: 'BodyParts')
     Boolean = Shapes::BooleanShape.new(name: 'Boolean')
@@ -177,6 +178,8 @@ module Aws::Rekognition
     KinesisVideoArn = Shapes::StringShape.new(name: 'KinesisVideoArn')
     KinesisVideoStream = Shapes::StructureShape.new(name: 'KinesisVideoStream')
     KmsKeyId = Shapes::StringShape.new(name: 'KmsKeyId')
+    KnownGender = Shapes::StructureShape.new(name: 'KnownGender')
+    KnownGenderType = Shapes::StringShape.new(name: 'KnownGenderType')
     Label = Shapes::StructureShape.new(name: 'Label')
     LabelDetection = Shapes::StructureShape.new(name: 'LabelDetection')
     LabelDetectionSortBy = Shapes::StringShape.new(name: 'LabelDetectionSortBy')
@@ -196,7 +199,9 @@ module Aws::Rekognition
     ListTagsForResourceResponse = Shapes::StructureShape.new(name: 'ListTagsForResourceResponse')
     MaxFaces = Shapes::IntegerShape.new(name: 'MaxFaces')
     MaxFacesToIndex = Shapes::IntegerShape.new(name: 'MaxFacesToIndex')
+    MaxPixelThreshold = Shapes::FloatShape.new(name: 'MaxPixelThreshold')
     MaxResults = Shapes::IntegerShape.new(name: 'MaxResults')
+    MinCoveragePercentage = Shapes::FloatShape.new(name: 'MinCoveragePercentage')
     ModerationLabel = Shapes::StructureShape.new(name: 'ModerationLabel')
     ModerationLabels = Shapes::ListShape.new(name: 'ModerationLabels')
     MouthOpen = Shapes::StructureShape.new(name: 'MouthOpen')
@@ -345,6 +350,7 @@ module Aws::Rekognition
     VersionName = Shapes::StringShape.new(name: 'VersionName')
     VersionNames = Shapes::ListShape.new(name: 'VersionNames')
     Video = Shapes::StructureShape.new(name: 'Video')
+    VideoColorRange = Shapes::StringShape.new(name: 'VideoColorRange')
     VideoJobStatus = Shapes::StringShape.new(name: 'VideoJobStatus')
     VideoMetadata = Shapes::StructureShape.new(name: 'VideoMetadata')
     VideoMetadataList = Shapes::ListShape.new(name: 'VideoMetadataList')
@@ -375,6 +381,10 @@ module Aws::Rekognition
     Beard.add_member(:confidence, Shapes::ShapeRef.new(shape: Percent, location_name: "Confidence"))
     Beard.struct_class = Types::Beard
 
+    BlackFrame.add_member(:max_pixel_threshold, Shapes::ShapeRef.new(shape: MaxPixelThreshold, location_name: "MaxPixelThreshold"))
+    BlackFrame.add_member(:min_coverage_percentage, Shapes::ShapeRef.new(shape: MinCoveragePercentage, location_name: "MinCoveragePercentage"))
+    BlackFrame.struct_class = Types::BlackFrame
+
     BodyParts.member = Shapes::ShapeRef.new(shape: ProtectiveEquipmentBodyPart)
 
     BoundingBox.add_member(:width, Shapes::ShapeRef.new(shape: Float, location_name: "Width"))
@@ -388,6 +398,7 @@ module Aws::Rekognition
     Celebrity.add_member(:id, Shapes::ShapeRef.new(shape: RekognitionUniqueId, location_name: "Id"))
     Celebrity.add_member(:face, Shapes::ShapeRef.new(shape: ComparedFace, location_name: "Face"))
     Celebrity.add_member(:match_confidence, Shapes::ShapeRef.new(shape: Percent, location_name: "MatchConfidence"))
+    Celebrity.add_member(:known_gender, Shapes::ShapeRef.new(shape: KnownGender, location_name: "KnownGender"))
     Celebrity.struct_class = Types::Celebrity
 
     CelebrityDetail.add_member(:urls, Shapes::ShapeRef.new(shape: Urls, location_name: "Urls"))
@@ -434,6 +445,8 @@ module Aws::Rekognition
     ComparedFace.add_member(:landmarks, Shapes::ShapeRef.new(shape: Landmarks, location_name: "Landmarks"))
     ComparedFace.add_member(:pose, Shapes::ShapeRef.new(shape: Pose, location_name: "Pose"))
     ComparedFace.add_member(:quality, Shapes::ShapeRef.new(shape: ImageQuality, location_name: "Quality"))
+    ComparedFace.add_member(:emotions, Shapes::ShapeRef.new(shape: Emotions, location_name: "Emotions"))
+    ComparedFace.add_member(:smile, Shapes::ShapeRef.new(shape: Smile, location_name: "Smile"))
     ComparedFace.struct_class = Types::ComparedFace
 
     ComparedFaceList.member = Shapes::ShapeRef.new(shape: ComparedFace)
@@ -727,6 +740,7 @@ module Aws::Rekognition
 
     GetCelebrityInfoResponse.add_member(:urls, Shapes::ShapeRef.new(shape: Urls, location_name: "Urls"))
     GetCelebrityInfoResponse.add_member(:name, Shapes::ShapeRef.new(shape: String, location_name: "Name"))
+    GetCelebrityInfoResponse.add_member(:known_gender, Shapes::ShapeRef.new(shape: KnownGender, location_name: "KnownGender"))
     GetCelebrityInfoResponse.struct_class = Types::GetCelebrityInfoResponse
 
     GetCelebrityRecognitionRequest.add_member(:job_id, Shapes::ShapeRef.new(shape: JobId, required: true, location_name: "JobId"))
@@ -906,6 +920,9 @@ module Aws::Rekognition
     KinesisVideoStream.add_member(:arn, Shapes::ShapeRef.new(shape: KinesisVideoArn, location_name: "Arn"))
     KinesisVideoStream.struct_class = Types::KinesisVideoStream
 
+    KnownGender.add_member(:type, Shapes::ShapeRef.new(shape: KnownGenderType, location_name: "Type"))
+    KnownGender.struct_class = Types::KnownGender
+
     Label.add_member(:name, Shapes::ShapeRef.new(shape: String, location_name: "Name"))
     Label.add_member(:confidence, Shapes::ShapeRef.new(shape: Percent, location_name: "Confidence"))
     Label.add_member(:instances, Shapes::ShapeRef.new(shape: Instances, location_name: "Instances"))
@@ -1132,6 +1149,9 @@ module Aws::Rekognition
     SegmentDetection.add_member(:duration_smpte, Shapes::ShapeRef.new(shape: Timecode, location_name: "DurationSMPTE"))
     SegmentDetection.add_member(:technical_cue_segment, Shapes::ShapeRef.new(shape: TechnicalCueSegment, location_name: "TechnicalCueSegment"))
     SegmentDetection.add_member(:shot_segment, Shapes::ShapeRef.new(shape: ShotSegment, location_name: "ShotSegment"))
+    SegmentDetection.add_member(:start_frame_number, Shapes::ShapeRef.new(shape: ULong, location_name: "StartFrameNumber"))
+    SegmentDetection.add_member(:end_frame_number, Shapes::ShapeRef.new(shape: ULong, location_name: "EndFrameNumber"))
+    SegmentDetection.add_member(:duration_frames, Shapes::ShapeRef.new(shape: ULong, location_name: "DurationFrames"))
     SegmentDetection.struct_class = Types::SegmentDetection
 
     SegmentDetections.member = Shapes::ShapeRef.new(shape: SegmentDetection)
@@ -1244,6 +1264,7 @@ module Aws::Rekognition
     StartStreamProcessorResponse.struct_class = Types::StartStreamProcessorResponse
 
     StartTechnicalCueDetectionFilter.add_member(:min_segment_confidence, Shapes::ShapeRef.new(shape: SegmentConfidence, location_name: "MinSegmentConfidence"))
+    StartTechnicalCueDetectionFilter.add_member(:black_frame, Shapes::ShapeRef.new(shape: BlackFrame, location_name: "BlackFrame"))
     StartTechnicalCueDetectionFilter.struct_class = Types::StartTechnicalCueDetectionFilter
 
     StartTextDetectionFilters.add_member(:word_filter, Shapes::ShapeRef.new(shape: DetectionFilter, location_name: "WordFilter"))
@@ -1371,6 +1392,7 @@ module Aws::Rekognition
     VideoMetadata.add_member(:frame_rate, Shapes::ShapeRef.new(shape: Float, location_name: "FrameRate"))
     VideoMetadata.add_member(:frame_height, Shapes::ShapeRef.new(shape: ULong, location_name: "FrameHeight"))
     VideoMetadata.add_member(:frame_width, Shapes::ShapeRef.new(shape: ULong, location_name: "FrameWidth"))
+    VideoMetadata.add_member(:color_range, Shapes::ShapeRef.new(shape: VideoColorRange, location_name: "ColorRange"))
     VideoMetadata.struct_class = Types::VideoMetadata
 
     VideoMetadataList.member = Shapes::ShapeRef.new(shape: VideoMetadata)

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

@@ -111,6 +111,55 @@ module Aws::Rekognition
       include Aws::Structure
     end
 
+    # A filter that allows you to control the black frame detection by
+    # specifying the black levels and pixel coverage of black pixels in a
+    # frame. As videos can come from multiple sources, formats, and time
+    # periods, they may contain different standards and varying noise levels
+    # for black frames that need to be accounted for. For more information,
+    # see StartSegmentDetection.
+    #
+    # @note When making an API call, you may pass BlackFrame
+    #   data as a hash:
+    #
+    #       {
+    #         max_pixel_threshold: 1.0,
+    #         min_coverage_percentage: 1.0,
+    #       }
+    #
+    # @!attribute [rw] max_pixel_threshold
+    #   A threshold used to determine the maximum luminance value for a
+    #   pixel to be considered black. In a full color range video, luminance
+    #   values range from 0-255. A pixel value of 0 is pure black, and the
+    #   most strict filter. The maximum black pixel value is computed as
+    #   follows: max\_black\_pixel\_value = minimum\_luminance +
+    #   MaxPixelThreshold *luminance\_range.
+    #
+    #   For example, for a full range video with BlackPixelThreshold = 0.1,
+    #   max\_black\_pixel\_value is 0 + 0.1 * (255-0) = 25.5.
+    #
+    #   The default value of MaxPixelThreshold is 0.2, which maps to a
+    #   max\_black\_pixel\_value of 51 for a full range video. You can lower
+    #   this threshold to be more strict on black levels.
+    #   @return [Float]
+    #
+    # @!attribute [rw] min_coverage_percentage
+    #   The minimum percentage of pixels in a frame that need to have a
+    #   luminance below the max\_black\_pixel\_value for a frame to be
+    #   considered a black frame. Luminance is calculated using the BT.709
+    #   matrix.
+    #
+    #   The default value is 99, which means at least 99% of all pixels in
+    #   the frame are black pixels as per the `MaxPixelThreshold` set. You
+    #   can reduce this value to allow more noise on the black frame.
+    #   @return [Float]
+    #
+    class BlackFrame < Struct.new(
+      :max_pixel_threshold,
+      :min_coverage_percentage)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Identifies the bounding box around the label, face, text or personal
     # protective equipment. The `left` (x-coordinate) and `top`
     # (y-coordinate) are coordinates representing the top and left sides of
@@ -201,12 +250,18 @@ module Aws::Rekognition
     #   recognized face is the celebrity.
     #   @return [Float]
     #
+    # @!attribute [rw] known_gender
+    #   The known gender identity for the celebrity that matches the
+    #   provided ID.
+    #   @return [Types::KnownGender]
+    #
     class Celebrity < Struct.new(
       :urls,
       :name,
       :id,
       :face,
-      :match_confidence)
+      :match_confidence,
+      :known_gender)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -452,12 +507,26 @@ module Aws::Rekognition
     #   Identifies face image brightness and sharpness.
     #   @return [Types::ImageQuality]
     #
+    # @!attribute [rw] emotions
+    #   The emotions that appear to be expressed on the face, and the
+    #   confidence level in the determination. Valid values include
+    #   "Happy", "Sad", "Angry", "Confused", "Disgusted",
+    #   "Surprised", "Calm", "Unknown", and "Fear".
+    #   @return [Array<Types::Emotion>]
+    #
+    # @!attribute [rw] smile
+    #   Indicates whether or not the face is smiling, and the confidence
+    #   level in the determination.
+    #   @return [Types::Smile]
+    #
     class ComparedFace < Struct.new(
       :bounding_box,
       :confidence,
       :landmarks,
       :pose,
-      :quality)
+      :quality,
+      :emotions,
+      :smile)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -483,15 +552,16 @@ module Aws::Rekognition
       include Aws::Structure
     end
 
-    # Information about an unsafe content label detection in a stored video.
+    # Information about an inappropriate, unwanted, or offensive content
+    # label detection in a stored video.
     #
     # @!attribute [rw] timestamp
     #   Time, in milliseconds from the beginning of the video, that the
-    #   unsafe content label was detected.
+    #   content moderation label was detected.
     #   @return [Integer]
     #
     # @!attribute [rw] moderation_label
-    #   The unsafe content label detected by in the stored video.
+    #   The content moderation label detected by in the stored video.
     #   @return [Types::ModerationLabel]
     #
     class ContentModerationDetection < Struct.new(
@@ -649,7 +719,9 @@ module Aws::Rekognition
     #   @return [String]
     #
     # @!attribute [rw] output_config
-    #   The Amazon S3 location to store the results of training.
+    #   The Amazon S3 bucket location to store the results of training. The
+    #   S3 bucket can be in any AWS account as long as the caller has
+    #   `s3:PutObject` permissions on the S3 bucket.
     #   @return [Types::OutputConfig]
     #
     # @!attribute [rw] training_data
@@ -668,11 +740,23 @@ module Aws::Rekognition
     # @!attribute [rw] kms_key_id
     #   The identifier for your AWS Key Management Service (AWS KMS)
     #   customer master key (CMK). You can supply the Amazon Resource Name
-    #   (ARN) of your CMK, the ID of your CMK, or an alias for your CMK. The
-    #   key is used to encrypt training and test images copied into the
-    #   service for model training. Your source images are unaffected. The
-    #   key is also used to encrypt training results and manifest files
-    #   written to the output Amazon S3 bucket (`OutputConfig`).
+    #   (ARN) of your CMK, the ID of your CMK, an alias for your CMK, or an
+    #   alias ARN. The key is used to encrypt training and test images
+    #   copied into the service for model training. Your source images are
+    #   unaffected. The key is also used to encrypt training results and
+    #   manifest files written to the output Amazon S3 bucket
+    #   (`OutputConfig`).
+    #
+    #   If you choose to use your own CMK, you need the following
+    #   permissions on the CMK.
+    #
+    #   * kms:CreateGrant
+    #
+    #   * kms:DescribeKey
+    #
+    #   * kms:GenerateDataKey
+    #
+    #   * kms:Decrypt
     #
     #   If you don't specify a value for `KmsKeyId`, images copied into the
     #   service are encrypted using a key that AWS owns and manages.
@@ -1246,10 +1330,12 @@ module Aws::Rekognition
     #
     # @!attribute [rw] min_confidence
     #   Specifies the minimum confidence level for the labels to return.
-    #   Amazon Rekognition doesn't return any labels with a confidence
-    #   lower than this specified value. If you specify a value of 0, all
-    #   labels are return, regardless of the default thresholds that the
-    #   model version applies.
+    #   `DetectCustomLabels` doesn't return any labels with a confidence
+    #   value that's lower than this specified value. If you specify a
+    #   value of 0, `DetectCustomLabels` returns all labels, regardless of
+    #   the assumed threshold applied to each label. If you don't specify a
+    #   value for `MinConfidence`, `DetectCustomLabels` returns labels based
+    #   on the assumed threshold of each label.
     #   @return [Float]
     #
     class DetectCustomLabelsRequest < Struct.new(
@@ -2153,9 +2239,14 @@ module Aws::Rekognition
     #   The name of the celebrity.
     #   @return [String]
     #
+    # @!attribute [rw] known_gender
+    #   Retrieves the known gender for the celebrity.
+    #   @return [Types::KnownGender]
+    #
     class GetCelebrityInfoResponse < Struct.new(
       :urls,
-      :name)
+      :name,
+      :known_gender)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2251,8 +2342,9 @@ module Aws::Rekognition
     #       }
     #
     # @!attribute [rw] job_id
-    #   The identifier for the unsafe content job. Use `JobId` to identify
-    #   the job in a subsequent call to `GetContentModeration`.
+    #   The identifier for the inappropriate, unwanted, or offensive content
+    #   moderation job. Use `JobId` to identify the job in a subsequent call
+    #   to `GetContentModeration`.
     #   @return [String]
     #
     # @!attribute [rw] max_results
@@ -2266,7 +2358,7 @@ module Aws::Rekognition
     #   If the previous response was incomplete (because there is more data
     #   to retrieve), Amazon Rekognition returns a pagination token in the
     #   response. You can use this pagination token to retrieve the next set
-    #   of unsafe content labels.
+    #   of content moderation labels.
     #   @return [String]
     #
     # @!attribute [rw] sort_by
@@ -2287,7 +2379,7 @@ module Aws::Rekognition
     end
 
     # @!attribute [rw] job_status
-    #   The current status of the unsafe content analysis job.
+    #   The current status of the content moderation analysis job.
     #   @return [String]
     #
     # @!attribute [rw] status_message
@@ -2302,19 +2394,19 @@ module Aws::Rekognition
     #   @return [Types::VideoMetadata]
     #
     # @!attribute [rw] moderation_labels
-    #   The detected unsafe content labels and the time(s) they were
-    #   detected.
+    #   The detected inappropriate, unwanted, or offensive content
+    #   moderation labels and the time(s) they were detected.
     #   @return [Array<Types::ContentModerationDetection>]
     #
     # @!attribute [rw] next_token
     #   If the response is truncated, Amazon Rekognition Video returns this
     #   token that you can use in the subsequent request to retrieve the
-    #   next set of unsafe content labels.
+    #   next set of content moderation labels.
     #   @return [String]
     #
     # @!attribute [rw] moderation_model_version
     #   Version number of the moderation detection model that was used to
-    #   detect unsafe content.
+    #   detect inappropriate, unwanted, or offensive content.
     #   @return [String]
     #
     class GetContentModerationResponse < Struct.new(
@@ -3303,6 +3395,19 @@ module Aws::Rekognition
       include Aws::Structure
     end
 
+    # The known gender identity for the celebrity that matches the provided
+    # ID.
+    #
+    # @!attribute [rw] type
+    #   A string value of the KnownGender info about the Celebrity.
+    #   @return [String]
+    #
+    class KnownGender < Struct.new(
+      :type)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Structure containing details about the detected label, including the
     # name, detected instances, parent labels, and level of confidence.
     #
@@ -3566,10 +3671,11 @@ module Aws::Rekognition
       include Aws::Structure
     end
 
-    # Provides information about a single type of unsafe content found in an
-    # image or video. Each type of moderated content has a label within a
-    # hierarchical taxonomy. For more information, see Detecting Unsafe
-    # Content in the Amazon Rekognition Developer Guide.
+    # Provides information about a single type of inappropriate, unwanted,
+    # or offensive content found in an image or video. Each type of
+    # moderated content has a label within a hierarchical taxonomy. For more
+    # information, see Content moderation in the Amazon Rekognition
+    # Developer Guide.
     #
     # @!attribute [rw] confidence
     #   Specifies the confidence that Amazon Rekognition has that the label
@@ -3636,7 +3742,15 @@ module Aws::Rekognition
 
     # The Amazon Simple Notification Service topic to which Amazon
     # Rekognition publishes the completion status of a video analysis
-    # operation. For more information, see api-video.
+    # operation. For more information, see api-video. Note that the Amazon
+    # SNS topic must have a topic name that begins with *AmazonRekognition*
+    # if you are using the AmazonRekognitionServiceRole permissions policy
+    # to access the topic. For more information, see [Giving access to
+    # multiple Amazon SNS topics][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/rekognition/latest/dg/api-video-roles.html#api-video-roles-all-topics
     #
     # @note When making an API call, you may pass NotificationChannel
     #   data as a hash:
@@ -4115,7 +4229,10 @@ module Aws::Rekognition
 
     # @!attribute [rw] celebrity_faces
     #   Details about each celebrity found in the image. Amazon Rekognition
-    #   can detect a maximum of 64 celebrities in an image.
+    #   can detect a maximum of 64 celebrities in an image. Each celebrity
+    #   object includes the following attributes: `Face`, `Confidence`,
+    #   `Emotions`, `Landmarks`, `Pose`, `Quality`, `Smile`, `Id`,
+    #   `KnownGender`, `MatchConfidence`, `Name`, `Urls`.
     #   @return [Array<Types::Celebrity>]
     #
     # @!attribute [rw] unrecognized_faces
@@ -4123,6 +4240,13 @@ module Aws::Rekognition
     #   @return [Array<Types::ComparedFace>]
     #
     # @!attribute [rw] orientation_correction
+    #   <note markdown="1"> Support for estimating image orientation using the the
+    #   OrientationCorrection field has ceased as of August 2021. Any
+    #   returned values for this field included in an API response will
+    #   always be NULL.
+    #
+    #    </note>
+    #
     #   The orientation of the input image (counterclockwise direction). If
     #   your application displays the image, you can use this value to
     #   correct the orientation. The bounding box coordinates returned in
@@ -4447,6 +4571,20 @@ module Aws::Rekognition
     #   shot detection.
     #   @return [Types::ShotSegment]
     #
+    # @!attribute [rw] start_frame_number
+    #   The frame number of the start of a video segment, using a frame
+    #   index that starts with 0.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] end_frame_number
+    #   The frame number at the end of a video segment, using a frame index
+    #   that starts with 0.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] duration_frames
+    #   The duration of a video segment, expressed in frames.
+    #   @return [Integer]
+    #
     class SegmentDetection < Struct.new(
       :type,
       :start_timestamp_millis,
@@ -4456,7 +4594,10 @@ module Aws::Rekognition
       :end_timecode_smpte,
       :duration_smpte,
       :technical_cue_segment,
-      :shot_segment)
+      :shot_segment,
+      :start_frame_number,
+      :end_frame_number,
+      :duration_frames)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -4557,7 +4698,9 @@ module Aws::Rekognition
     # @!attribute [rw] notification_channel
     #   The Amazon SNS topic ARN that you want Amazon Rekognition Video to
     #   publish the completion status of the celebrity recognition analysis
-    #   to.
+    #   to. The Amazon SNS topic must have a topic name that begins with
+    #   *AmazonRekognition* if you are using the
+    #   AmazonRekognitionServiceRole permissions policy.
     #   @return [Types::NotificationChannel]
     #
     # @!attribute [rw] job_tag
@@ -4609,8 +4752,8 @@ module Aws::Rekognition
     #       }
     #
     # @!attribute [rw] video
-    #   The video in which you want to detect unsafe content. The video must
-    #   be stored in an Amazon S3 bucket.
+    #   The video in which you want to detect inappropriate, unwanted, or
+    #   offensive content. The video must be stored in an Amazon S3 bucket.
     #   @return [Types::Video]
     #
     # @!attribute [rw] min_confidence
@@ -4633,7 +4776,10 @@ module Aws::Rekognition
     #
     # @!attribute [rw] notification_channel
     #   The Amazon SNS topic ARN that you want Amazon Rekognition Video to
-    #   publish the completion status of the unsafe content analysis to.
+    #   publish the completion status of the content analysis to. The Amazon
+    #   SNS topic must have a topic name that begins with
+    #   *AmazonRekognition* if you are using the
+    #   AmazonRekognitionServiceRole permissions policy to access the topic.
     #   @return [Types::NotificationChannel]
     #
     # @!attribute [rw] job_tag
@@ -4654,8 +4800,8 @@ module Aws::Rekognition
     end
 
     # @!attribute [rw] job_id
-    #   The identifier for the unsafe content analysis job. Use `JobId` to
-    #   identify the job in a subsequent call to `GetContentModeration`.
+    #   The identifier for the content analysis job. Use `JobId` to identify
+    #   the job in a subsequent call to `GetContentModeration`.
     #   @return [String]
     #
     class StartContentModerationResponse < Struct.new(
@@ -4699,7 +4845,9 @@ module Aws::Rekognition
     # @!attribute [rw] notification_channel
     #   The ARN of the Amazon SNS topic to which you want Amazon Rekognition
     #   Video to publish the completion status of the face detection
-    #   operation.
+    #   operation. The Amazon SNS topic must have a topic name that begins
+    #   with *AmazonRekognition* if you are using the
+    #   AmazonRekognitionServiceRole permissions policy.
     #   @return [Types::NotificationChannel]
     #
     # @!attribute [rw] face_attributes
@@ -4784,7 +4932,10 @@ module Aws::Rekognition
     #
     # @!attribute [rw] notification_channel
     #   The ARN of the Amazon SNS topic to which you want Amazon Rekognition
-    #   Video to publish the completion status of the search.
+    #   Video to publish the completion status of the search. The Amazon SNS
+    #   topic must have a topic name that begins with *AmazonRekognition* if
+    #   you are using the AmazonRekognitionServiceRole permissions policy to
+    #   access the topic.
     #   @return [Types::NotificationChannel]
     #
     # @!attribute [rw] job_tag
@@ -4863,6 +5014,9 @@ module Aws::Rekognition
     # @!attribute [rw] notification_channel
     #   The Amazon SNS topic ARN you want Amazon Rekognition Video to
     #   publish the completion status of the label detection operation to.
+    #   The Amazon SNS topic must have a topic name that begins with
+    #   *AmazonRekognition* if you are using the
+    #   AmazonRekognitionServiceRole permissions policy.
     #   @return [Types::NotificationChannel]
     #
     # @!attribute [rw] job_tag
@@ -4927,6 +5081,9 @@ module Aws::Rekognition
     # @!attribute [rw] notification_channel
     #   The Amazon SNS topic ARN you want Amazon Rekognition Video to
     #   publish the completion status of the people detection operation to.
+    #   The Amazon SNS topic must have a topic name that begins with
+    #   *AmazonRekognition* if you are using the
+    #   AmazonRekognitionServiceRole permissions policy.
     #   @return [Types::NotificationChannel]
     #
     # @!attribute [rw] job_tag
@@ -5003,6 +5160,10 @@ module Aws::Rekognition
     #       {
     #         technical_cue_filter: {
     #           min_segment_confidence: 1.0,
+    #           black_frame: {
+    #             max_pixel_threshold: 1.0,
+    #             min_coverage_percentage: 1.0,
+    #           },
     #         },
     #         shot_filter: {
     #           min_segment_confidence: 1.0,
@@ -5044,6 +5205,10 @@ module Aws::Rekognition
     #         filters: {
     #           technical_cue_filter: {
     #             min_segment_confidence: 1.0,
+    #             black_frame: {
+    #               max_pixel_threshold: 1.0,
+    #               min_coverage_percentage: 1.0,
+    #             },
     #           },
     #           shot_filter: {
     #             min_segment_confidence: 1.0,
@@ -5069,7 +5234,9 @@ module Aws::Rekognition
     # @!attribute [rw] notification_channel
     #   The ARN of the Amazon SNS topic to which you want Amazon Rekognition
     #   Video to publish the completion status of the segment detection
-    #   operation.
+    #   operation. Note that the Amazon SNS topic must have a topic name
+    #   that begins with *AmazonRekognition* if you are using the
+    #   AmazonRekognitionServiceRole permissions policy to access the topic.
     #   @return [Types::NotificationChannel]
     #
     # @!attribute [rw] job_tag
@@ -5167,6 +5334,10 @@ module Aws::Rekognition
     #
     #       {
     #         min_segment_confidence: 1.0,
+    #         black_frame: {
+    #           max_pixel_threshold: 1.0,
+    #           min_coverage_percentage: 1.0,
+    #         },
     #       }
     #
     # @!attribute [rw] min_segment_confidence
@@ -5182,8 +5353,17 @@ module Aws::Rekognition
     #   percent.
     #   @return [Float]
     #
+    # @!attribute [rw] black_frame
+    #   A filter that allows you to control the black frame detection by
+    #   specifying the black levels and pixel coverage of black pixels in a
+    #   frame. Videos can come from multiple sources, formats, and time
+    #   periods, with different standards and varying noise levels for black
+    #   frames that need to be accounted for.
+    #   @return [Types::BlackFrame]
+    #
     class StartTechnicalCueDetectionFilter < Struct.new(
-      :min_segment_confidence)
+      :min_segment_confidence,
+      :black_frame)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -5284,7 +5464,16 @@ module Aws::Rekognition
     # @!attribute [rw] notification_channel
     #   The Amazon Simple Notification Service topic to which Amazon
     #   Rekognition publishes the completion status of a video analysis
-    #   operation. For more information, see api-video.
+    #   operation. For more information, see api-video. Note that the Amazon
+    #   SNS topic must have a topic name that begins with
+    #   *AmazonRekognition* if you are using the
+    #   AmazonRekognitionServiceRole permissions policy to access the topic.
+    #   For more information, see [Giving access to multiple Amazon SNS
+    #   topics][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/rekognition/latest/dg/api-video-roles.html#api-video-roles-all-topics
     #   @return [Types::NotificationChannel]
     #
     # @!attribute [rw] job_tag
@@ -5892,13 +6081,19 @@ module Aws::Rekognition
     #   Horizontal pixel dimension of the video.
     #   @return [Integer]
     #
+    # @!attribute [rw] color_range
+    #   A description of the range of luminance values in a video, either
+    #   LIMITED (16 to 235) or FULL (0 to 255).
+    #   @return [String]
+    #
     class VideoMetadata < Struct.new(
       :codec,
       :duration_millis,
       :format,
       :frame_rate,
       :frame_height,
-      :frame_width)
+      :frame_width,
+      :color_range)
       SENSITIVE = []
       include Aws::Structure
     end

data/lib/aws-sdk-rekognition.rb

@@ -49,6 +49,6 @@ require_relative 'aws-sdk-rekognition/customizations'
 # @!group service
 module Aws::Rekognition
 
-  GEM_VERSION = '1.51.0'
+  GEM_VERSION = '1.55.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-rekognition
 version: !ruby/object:Gem::Version
-  version: 1.51.0
+  version: 1.55.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-05-19 00:00:00.000000000 Z
+date: 2021-08-26 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.112.0
+        version: 3.119.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.112.0
+        version: 3.119.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement