aws-sdk-rekognition 1.53.0 → 1.54.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ee84fb06704b864d6e850935c0993d13504308dedc59832df63b554951454aa3
-  data.tar.gz: 573db1696cc9ca01596429f839d5c5c0a07699ac1b07b82e49f9b2ffd877557e
+  metadata.gz: 3be2c5689e792a068c696e416622e79a1ef01e2564a6b77a58bd7f9764cdcce9
+  data.tar.gz: 8275849761b724ea256aeb308d281c254f1a46ae0694b0d9a50a81e6e3552073
 SHA512:
-  metadata.gz: 557d2ad9853c265c10e5b39194e0e22e42405d5d9dfd47198b9234ce9d778c3fa40ae10116f3095e3e436da3cfbddaa75e247b70de2e92c9bfc471ff7d5a94fb
-  data.tar.gz: 732dba155b2df524eb3f6e5cf9b175eaeeadc4b477aa9b4e94a536252dd0f1a62cf0a6778ce9ee57c0743de6e8bf7114a5916361b8a42e33d896f174047d7f74
+  metadata.gz: b53c25a316b0643b6e26034e1f2aa209669fc550799b306e9fe2debc5d824314ac1bb0ec8f5c6663dd14c15203fa8e246504472f8969df8ab8a1fdf42e385e60
+  data.tar.gz: 28041784233e4cea2a86458435fcfb3a5f6c5f313ea202e80458c6580c13705d10b926281ac503987104902f32790be0e6fe12ddd8f25472f3304a5ac19df94b

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+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)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.53.0
+1.54.0

data/lib/aws-sdk-rekognition.rb

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

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

@@ -699,7 +699,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 +715,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.
@@ -1990,7 +2003,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
@@ -2225,6 +2238,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 +2294,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 +2331,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 +2353,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 +2392,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 +2476,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 +2610,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 +2758,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 +2872,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 +3005,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 +3020,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 +3113,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
@@ -4325,7 +4357,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 +4400,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 +4446,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 +4521,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 +4608,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 +4697,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 +4769,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 +4900,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 +4940,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 +5016,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 +5216,7 @@ module Aws::Rekognition
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-rekognition'
-      context[:gem_version] = '1.53.0'
+      context[:gem_version] = '1.54.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')
@@ -196,7 +197,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 +348,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 +379,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"))
@@ -1132,6 +1140,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 +1255,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 +1383,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
@@ -483,15 +532,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 +699,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 +720,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.
@@ -2251,8 +2315,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 +2331,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 +2352,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 +2367,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(
@@ -3566,10 +3631,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 +3702,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:
@@ -4447,6 +4521,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 +4544,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 +4648,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 +4702,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 +4726,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 +4750,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 +4795,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 +4882,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 +4964,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 +5031,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 +5110,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 +5155,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 +5184,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 +5284,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 +5303,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 +5414,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 +6031,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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-rekognition
 version: !ruby/object:Gem::Version
-  version: 1.53.0
+  version: 1.54.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-07-30 00:00:00.000000000 Z
+date: 2021-08-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core