aws-sdk-rekognition 1.71.0 → 1.72.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 905750bbefaa5fa1c3911030a8c24e9e373f87cf5a4f38f0538f84df5c63e3f5
-  data.tar.gz: 3ab5a14ff6b83ce0ba0e653531d5bfa784db068aae320298d5417e6ecc6bf8c6
+  metadata.gz: 59e3c384ad0740cd57cc26b976cfc30f0b0ed8651a37b8100489e8ce2faedabc
+  data.tar.gz: 240fc9c7d44843b9c4e2829931f467a6b3a1328352ca6b65453a98cec036094b
 SHA512:
-  metadata.gz: 5596e290509cace40198994218271e9f9de737d4c0f1fc1d8741f4c07d2faf3e094630e383919617706b129a79463e96cf1da121147fd134c8f8c8cccfcf71f0
-  data.tar.gz: feb2605c0dc3ca1c0070a9e55f01fe147266b7a3b932fc7344c95e944d3f6846eb13539533c9f2128021bab665a6fa5c3ad0b56f8c42a36c89daa7cc13e90200
+  metadata.gz: 417c29e0ef8da4ce0cbe2745a25cf49591719cbbd07aa0f8c2f7bf6eeaed28c06edf1e865af40bf9210525bb7f00c8be63052e87c0aad42e42ede10f63e498f4
+  data.tar.gz: 78802af11d77ace741a2cce11f5c4673d9a00ea92c5844593f4f9af04cc6d1e61e093a6503a4088ba425aa74b9ba72545fb407ec34a2734a807021a3d2559190

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.72.0 (2022-11-11)
+------------------
+
+* Feature - Adding support for ImageProperties feature to detect dominant colors and image brightness, sharpness, and contrast, inclusion and exclusion filters for labels and label categories, new fields to the API response, "aliases" and "categories"
+
 1.71.0 (2022-10-25)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.71.0
+1.72.0

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

@@ -2177,23 +2177,85 @@ module Aws::Rekognition
     # For an example, see Analyzing images stored in an Amazon S3 bucket in
     # the Amazon Rekognition Developer Guide.
     #
-    # <note markdown="1"> `DetectLabels` does not support the detection of activities. However,
-    # activity detection is supported for label detection in videos. For
-    # more information, see StartLabelDetection in the Amazon Rekognition
-    # Developer Guide.
-    #
-    #  </note>
-    #
     # You pass the input image as base64-encoded image bytes or as a
     # reference to an image in an Amazon S3 bucket. If you use the AWS CLI
     # to call Amazon Rekognition operations, passing image bytes is not
     # supported. The image must be either a PNG or JPEG formatted file.
     #
+    # **Optional Parameters**
+    #
+    # You can specify one or both of the `GENERAL_LABELS` and
+    # `IMAGE_PROPERTIES` feature types when calling the DetectLabels API.
+    # Including `GENERAL_LABELS` will ensure the response includes the
+    # labels detected in the input image, while including `IMAGE_PROPERTIES
+    # `will ensure the response includes information about the image quality
+    # and color.
+    #
+    # When using `GENERAL_LABELS` and/or `IMAGE_PROPERTIES` you can provide
+    # filtering criteria to the Settings parameter. You can filter with sets
+    # of individual labels or with label categories. You can specify
+    # inclusive filters, exclusive filters, or a combination of inclusive
+    # and exclusive filters. For more information on filtering see
+    # [Detecting Labels in an Image][1].
+    #
+    # You can specify `MinConfidence` to control the confidence threshold
+    # for the labels returned. The default is 55%. You can also add the
+    # `MaxLabels` parameter to limit the number of labels returned. The
+    # default and upper limit is 1000 labels.
+    #
+    # **Response Elements**
+    #
     # For each object, scene, and concept the API returns one or more
-    # labels. Each label provides the object name, and the level of
-    # confidence that the image contains the object. For example, suppose
-    # the input image has a lighthouse, the sea, and a rock. The response
-    # includes all three labels, one for each object.
+    # labels. The API returns the following types of information regarding
+    # labels:
+    #
+    # * Name - The name of the detected label.
+    #
+    # * Confidence - The level of confidence in the label assigned to a
+    #   detected object.
+    #
+    # * Parents - The ancestor labels for a detected label. DetectLabels
+    #   returns a hierarchical taxonomy of detected labels. For example, a
+    #   detected car might be assigned the label car. The label car has two
+    #   parent labels: Vehicle (its parent) and Transportation (its
+    #   grandparent). The response includes the all ancestors for a label,
+    #   where every ancestor is a unique label. In the previous example,
+    #   Car, Vehicle, and Transportation are returned as unique labels in
+    #   the response.
+    #
+    # * Aliases - Possible Aliases for the label.
+    #
+    # * Categories - The label categories that the detected label belongs
+    #   to. A given label can belong to more than one category.
+    #
+    # * BoundingBox — Bounding boxes are described for all instances of
+    #   detected common object labels, returned in an array of Instance
+    #   objects. An Instance object contains a BoundingBox object,
+    #   describing the location of the label on the input image. It also
+    #   includes the confidence for the accuracy of the detected bounding
+    #   box.
+    #
+    # The API returns the following information regarding the image, as part
+    # of the ImageProperties structure:
+    #
+    # * Quality - Information about the Sharpness, Brightness, and Contrast
+    #   of the input image, scored between 0 to 100. Image quality is
+    #   returned for the entire image, as well as the background and the
+    #   foreground.
+    #
+    # * Dominant Color - An array of the dominant colors in the image.
+    #
+    # * Foreground - Information about the Sharpness and Brightness of the
+    #   input image’s foreground.
+    #
+    # * Background - Information about the Sharpness and Brightness of the
+    #   input image’s background.
+    #
+    # The list of returned labels will include at least one label for every
+    # detected object, along with information about that label. In the
+    # following example, suppose the input image has a lighthouse, the sea,
+    # and a rock. The response includes all three labels, one for each
+    # object, as well as the confidence in the label:
     #
     # `\{Name: lighthouse, Confidence: 98.4629\}`
     #
@@ -2201,11 +2263,9 @@ module Aws::Rekognition
     #
     # ` \{Name: sea,Confidence: 75.061\}`
     #
-    # In the preceding example, the operation returns one label for each of
-    # the three objects. The operation can also return multiple labels for
-    # the same object in the image. For example, if the input image shows a
-    # flower (for example, a tulip), the operation might return the
-    # following three labels.
+    # The list of labels can include multiple labels for the same object.
+    # For example, if the input image shows a flower (for example, a tulip),
+    # the operation might return the following three labels.
     #
     # `\{Name: flower,Confidence: 99.0562\}`
     #
@@ -2216,36 +2276,21 @@ module Aws::Rekognition
     # In this example, the detection algorithm more precisely identifies the
     # flower as a tulip.
     #
-    # In response, the API returns an array of labels. In addition, the
-    # response also includes the orientation correction. Optionally, you can
-    # specify `MinConfidence` to control the confidence threshold for the
-    # labels returned. The default is 55%. You can also add the `MaxLabels`
-    # parameter to limit the number of labels returned.
-    #
     # <note markdown="1"> If the object detected is a person, the operation doesn't provide the
     # same facial details that the DetectFaces operation provides.
     #
     #  </note>
     #
-    # `DetectLabels` returns bounding boxes for instances of common object
-    # labels in an array of Instance objects. An `Instance` object contains
-    # a BoundingBox object, for the location of the label on the image. It
-    # also includes the confidence by which the bounding box was detected.
-    #
-    # `DetectLabels` also returns a hierarchical taxonomy of detected
-    # labels. For example, a detected car might be assigned the label *car*.
-    # The label *car* has two parent labels: *Vehicle* (its parent) and
-    # *Transportation* (its grandparent). The response returns the entire
-    # list of ancestors for a label. Each ancestor is a unique label in the
-    # response. In the previous example, *Car*, *Vehicle*, and
-    # *Transportation* are returned as unique labels in the response.
-    #
     # This is a stateless API operation. That is, the operation does not
     # persist any data.
     #
     # This operation requires permissions to perform the
     # `rekognition:DetectLabels` action.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/rekognition/latest/dg/labels-detect-labels-image.html
+    #
     # @option params [required, Types::Image] :image
     #   The input image as base64-encoded bytes or an S3 object. If you use
     #   the AWS CLI to call Amazon Rekognition operations, passing image bytes
@@ -2270,11 +2315,26 @@ module Aws::Rekognition
     #   If `MinConfidence` is not specified, the operation returns labels with
     #   a confidence values greater than or equal to 55 percent.
     #
+    # @option params [Array<String>] :features
+    #   A list of the types of analysis to perform. Specifying GENERAL\_LABELS
+    #   uses the label detection feature, while specifying IMAGE\_PROPERTIES
+    #   returns information regarding image color and quality. If no option is
+    #   specified GENERAL\_LABELS is used by default.
+    #
+    # @option params [Types::DetectLabelsSettings] :settings
+    #   A list of the filters to be applied to returned detected labels and
+    #   image properties. Specified filters can be inclusive, exclusive, or a
+    #   combination of both. Filters can be used for individual labels or
+    #   label categories. The exact label names or label categories must be
+    #   supplied. For a full list of labels and label categories, see LINK
+    #   HERE.
+    #
     # @return [Types::DetectLabelsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::DetectLabelsResponse#labels #labels} => Array&lt;Types::Label&gt;
     #   * {Types::DetectLabelsResponse#orientation_correction #orientation_correction} => String
     #   * {Types::DetectLabelsResponse#label_model_version #label_model_version} => String
+    #   * {Types::DetectLabelsResponse#image_properties #image_properties} => Types::DetectLabelsImageProperties
     #
     #
     # @example Example: To detect labels
@@ -2319,6 +2379,18 @@ module Aws::Rekognition
     #     },
     #     max_labels: 1,
     #     min_confidence: 1.0,
+    #     features: ["GENERAL_LABELS"], # accepts GENERAL_LABELS, IMAGE_PROPERTIES
+    #     settings: {
+    #       general_labels: {
+    #         label_inclusion_filters: ["GeneralLabelsFilterValue"],
+    #         label_exclusion_filters: ["GeneralLabelsFilterValue"],
+    #         label_category_inclusion_filters: ["GeneralLabelsFilterValue"],
+    #         label_category_exclusion_filters: ["GeneralLabelsFilterValue"],
+    #       },
+    #       image_properties: {
+    #         max_dominant_colors: 1,
+    #       },
+    #     },
     #   })
     #
     # @example Response structure
@@ -2332,10 +2404,55 @@ module Aws::Rekognition
     #   resp.labels[0].instances[0].bounding_box.left #=> Float
     #   resp.labels[0].instances[0].bounding_box.top #=> Float
     #   resp.labels[0].instances[0].confidence #=> Float
+    #   resp.labels[0].instances[0].dominant_colors #=> Array
+    #   resp.labels[0].instances[0].dominant_colors[0].red #=> Integer
+    #   resp.labels[0].instances[0].dominant_colors[0].blue #=> Integer
+    #   resp.labels[0].instances[0].dominant_colors[0].green #=> Integer
+    #   resp.labels[0].instances[0].dominant_colors[0].hex_code #=> String
+    #   resp.labels[0].instances[0].dominant_colors[0].css_color #=> String
+    #   resp.labels[0].instances[0].dominant_colors[0].simplified_color #=> String
+    #   resp.labels[0].instances[0].dominant_colors[0].pixel_percent #=> Float
     #   resp.labels[0].parents #=> Array
     #   resp.labels[0].parents[0].name #=> String
+    #   resp.labels[0].aliases #=> Array
+    #   resp.labels[0].aliases[0].name #=> String
+    #   resp.labels[0].categories #=> Array
+    #   resp.labels[0].categories[0].name #=> String
     #   resp.orientation_correction #=> String, one of "ROTATE_0", "ROTATE_90", "ROTATE_180", "ROTATE_270"
     #   resp.label_model_version #=> String
+    #   resp.image_properties.quality.brightness #=> Float
+    #   resp.image_properties.quality.sharpness #=> Float
+    #   resp.image_properties.quality.contrast #=> Float
+    #   resp.image_properties.dominant_colors #=> Array
+    #   resp.image_properties.dominant_colors[0].red #=> Integer
+    #   resp.image_properties.dominant_colors[0].blue #=> Integer
+    #   resp.image_properties.dominant_colors[0].green #=> Integer
+    #   resp.image_properties.dominant_colors[0].hex_code #=> String
+    #   resp.image_properties.dominant_colors[0].css_color #=> String
+    #   resp.image_properties.dominant_colors[0].simplified_color #=> String
+    #   resp.image_properties.dominant_colors[0].pixel_percent #=> Float
+    #   resp.image_properties.foreground.quality.brightness #=> Float
+    #   resp.image_properties.foreground.quality.sharpness #=> Float
+    #   resp.image_properties.foreground.quality.contrast #=> Float
+    #   resp.image_properties.foreground.dominant_colors #=> Array
+    #   resp.image_properties.foreground.dominant_colors[0].red #=> Integer
+    #   resp.image_properties.foreground.dominant_colors[0].blue #=> Integer
+    #   resp.image_properties.foreground.dominant_colors[0].green #=> Integer
+    #   resp.image_properties.foreground.dominant_colors[0].hex_code #=> String
+    #   resp.image_properties.foreground.dominant_colors[0].css_color #=> String
+    #   resp.image_properties.foreground.dominant_colors[0].simplified_color #=> String
+    #   resp.image_properties.foreground.dominant_colors[0].pixel_percent #=> Float
+    #   resp.image_properties.background.quality.brightness #=> Float
+    #   resp.image_properties.background.quality.sharpness #=> Float
+    #   resp.image_properties.background.quality.contrast #=> Float
+    #   resp.image_properties.background.dominant_colors #=> Array
+    #   resp.image_properties.background.dominant_colors[0].red #=> Integer
+    #   resp.image_properties.background.dominant_colors[0].blue #=> Integer
+    #   resp.image_properties.background.dominant_colors[0].green #=> Integer
+    #   resp.image_properties.background.dominant_colors[0].hex_code #=> String
+    #   resp.image_properties.background.dominant_colors[0].css_color #=> String
+    #   resp.image_properties.background.dominant_colors[0].simplified_color #=> String
+    #   resp.image_properties.background.dominant_colors[0].pixel_percent #=> Float
     #
     # @overload detect_labels(params = {})
     # @param [Hash] params ({})
@@ -3378,8 +3495,20 @@ module Aws::Rekognition
     #   resp.labels[0].label.instances[0].bounding_box.left #=> Float
     #   resp.labels[0].label.instances[0].bounding_box.top #=> Float
     #   resp.labels[0].label.instances[0].confidence #=> Float
+    #   resp.labels[0].label.instances[0].dominant_colors #=> Array
+    #   resp.labels[0].label.instances[0].dominant_colors[0].red #=> Integer
+    #   resp.labels[0].label.instances[0].dominant_colors[0].blue #=> Integer
+    #   resp.labels[0].label.instances[0].dominant_colors[0].green #=> Integer
+    #   resp.labels[0].label.instances[0].dominant_colors[0].hex_code #=> String
+    #   resp.labels[0].label.instances[0].dominant_colors[0].css_color #=> String
+    #   resp.labels[0].label.instances[0].dominant_colors[0].simplified_color #=> String
+    #   resp.labels[0].label.instances[0].dominant_colors[0].pixel_percent #=> Float
     #   resp.labels[0].label.parents #=> Array
     #   resp.labels[0].label.parents[0].name #=> String
+    #   resp.labels[0].label.aliases #=> Array
+    #   resp.labels[0].label.aliases[0].name #=> String
+    #   resp.labels[0].label.categories #=> Array
+    #   resp.labels[0].label.categories[0].name #=> String
     #   resp.label_model_version #=> String
     #
     # @overload get_label_detection(params = {})
@@ -5933,7 +6062,9 @@ module Aws::Rekognition
     # @option params [Types::StreamProcessingStartSelector] :start_selector
     #   Specifies the starting point in the Kinesis stream to start
     #   processing. You can use the producer timestamp or the fragment number.
-    #   For more information, see [Fragment][1].
+    #   If you use the producer timestamp, you must put the time in
+    #   milliseconds. For more information about fragment numbers, see
+    #   [Fragment][1].
     #
     #   This is a required parameter for label detection stream processors and
     #   should not be used to start a face search stream processor.
@@ -6338,7 +6469,7 @@ module Aws::Rekognition
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-rekognition'
-      context[:gem_version] = '1.71.0'
+      context[:gem_version] = '1.72.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -117,8 +117,17 @@ module Aws::Rekognition
     DetectCustomLabelsResponse = Shapes::StructureShape.new(name: 'DetectCustomLabelsResponse')
     DetectFacesRequest = Shapes::StructureShape.new(name: 'DetectFacesRequest')
     DetectFacesResponse = Shapes::StructureShape.new(name: 'DetectFacesResponse')
+    DetectLabelsFeatureList = Shapes::ListShape.new(name: 'DetectLabelsFeatureList')
+    DetectLabelsFeatureName = Shapes::StringShape.new(name: 'DetectLabelsFeatureName')
+    DetectLabelsImageBackground = Shapes::StructureShape.new(name: 'DetectLabelsImageBackground')
+    DetectLabelsImageForeground = Shapes::StructureShape.new(name: 'DetectLabelsImageForeground')
+    DetectLabelsImageProperties = Shapes::StructureShape.new(name: 'DetectLabelsImageProperties')
+    DetectLabelsImagePropertiesSettings = Shapes::StructureShape.new(name: 'DetectLabelsImagePropertiesSettings')
+    DetectLabelsImageQuality = Shapes::StructureShape.new(name: 'DetectLabelsImageQuality')
+    DetectLabelsMaxDominantColors = Shapes::IntegerShape.new(name: 'DetectLabelsMaxDominantColors')
     DetectLabelsRequest = Shapes::StructureShape.new(name: 'DetectLabelsRequest')
     DetectLabelsResponse = Shapes::StructureShape.new(name: 'DetectLabelsResponse')
+    DetectLabelsSettings = Shapes::StructureShape.new(name: 'DetectLabelsSettings')
     DetectModerationLabelsRequest = Shapes::StructureShape.new(name: 'DetectModerationLabelsRequest')
     DetectModerationLabelsResponse = Shapes::StructureShape.new(name: 'DetectModerationLabelsResponse')
     DetectProtectiveEquipmentRequest = Shapes::StructureShape.new(name: 'DetectProtectiveEquipmentRequest')
@@ -131,6 +140,8 @@ module Aws::Rekognition
     DistributeDatasetEntriesRequest = Shapes::StructureShape.new(name: 'DistributeDatasetEntriesRequest')
     DistributeDatasetEntriesResponse = Shapes::StructureShape.new(name: 'DistributeDatasetEntriesResponse')
     DistributeDatasetMetadataList = Shapes::ListShape.new(name: 'DistributeDatasetMetadataList')
+    DominantColor = Shapes::StructureShape.new(name: 'DominantColor')
+    DominantColors = Shapes::ListShape.new(name: 'DominantColors')
     Emotion = Shapes::StructureShape.new(name: 'Emotion')
     EmotionName = Shapes::StringShape.new(name: 'EmotionName')
     Emotions = Shapes::ListShape.new(name: 'Emotions')
@@ -161,6 +172,9 @@ module Aws::Rekognition
     FlowDefinitionArn = Shapes::StringShape.new(name: 'FlowDefinitionArn')
     Gender = Shapes::StructureShape.new(name: 'Gender')
     GenderType = Shapes::StringShape.new(name: 'GenderType')
+    GeneralLabelsFilterList = Shapes::ListShape.new(name: 'GeneralLabelsFilterList')
+    GeneralLabelsFilterValue = Shapes::StringShape.new(name: 'GeneralLabelsFilterValue')
+    GeneralLabelsSettings = Shapes::StructureShape.new(name: 'GeneralLabelsSettings')
     Geometry = Shapes::StructureShape.new(name: 'Geometry')
     GetCelebrityInfoRequest = Shapes::StructureShape.new(name: 'GetCelebrityInfoRequest')
     GetCelebrityInfoResponse = Shapes::StructureShape.new(name: 'GetCelebrityInfoResponse')
@@ -223,6 +237,10 @@ module Aws::Rekognition
     KnownGender = Shapes::StructureShape.new(name: 'KnownGender')
     KnownGenderType = Shapes::StringShape.new(name: 'KnownGenderType')
     Label = Shapes::StructureShape.new(name: 'Label')
+    LabelAlias = Shapes::StructureShape.new(name: 'LabelAlias')
+    LabelAliases = Shapes::ListShape.new(name: 'LabelAliases')
+    LabelCategories = Shapes::ListShape.new(name: 'LabelCategories')
+    LabelCategory = Shapes::StructureShape.new(name: 'LabelCategory')
     LabelDetection = Shapes::StructureShape.new(name: 'LabelDetection')
     LabelDetectionSortBy = Shapes::StringShape.new(name: 'LabelDetectionSortBy')
     LabelDetections = Shapes::ListShape.new(name: 'LabelDetections')
@@ -779,16 +797,47 @@ module Aws::Rekognition
     DetectFacesResponse.add_member(:orientation_correction, Shapes::ShapeRef.new(shape: OrientationCorrection, location_name: "OrientationCorrection"))
     DetectFacesResponse.struct_class = Types::DetectFacesResponse
 
+    DetectLabelsFeatureList.member = Shapes::ShapeRef.new(shape: DetectLabelsFeatureName)
+
+    DetectLabelsImageBackground.add_member(:quality, Shapes::ShapeRef.new(shape: DetectLabelsImageQuality, location_name: "Quality"))
+    DetectLabelsImageBackground.add_member(:dominant_colors, Shapes::ShapeRef.new(shape: DominantColors, location_name: "DominantColors"))
+    DetectLabelsImageBackground.struct_class = Types::DetectLabelsImageBackground
+
+    DetectLabelsImageForeground.add_member(:quality, Shapes::ShapeRef.new(shape: DetectLabelsImageQuality, location_name: "Quality"))
+    DetectLabelsImageForeground.add_member(:dominant_colors, Shapes::ShapeRef.new(shape: DominantColors, location_name: "DominantColors"))
+    DetectLabelsImageForeground.struct_class = Types::DetectLabelsImageForeground
+
+    DetectLabelsImageProperties.add_member(:quality, Shapes::ShapeRef.new(shape: DetectLabelsImageQuality, location_name: "Quality"))
+    DetectLabelsImageProperties.add_member(:dominant_colors, Shapes::ShapeRef.new(shape: DominantColors, location_name: "DominantColors"))
+    DetectLabelsImageProperties.add_member(:foreground, Shapes::ShapeRef.new(shape: DetectLabelsImageForeground, location_name: "Foreground"))
+    DetectLabelsImageProperties.add_member(:background, Shapes::ShapeRef.new(shape: DetectLabelsImageBackground, location_name: "Background"))
+    DetectLabelsImageProperties.struct_class = Types::DetectLabelsImageProperties
+
+    DetectLabelsImagePropertiesSettings.add_member(:max_dominant_colors, Shapes::ShapeRef.new(shape: DetectLabelsMaxDominantColors, location_name: "MaxDominantColors"))
+    DetectLabelsImagePropertiesSettings.struct_class = Types::DetectLabelsImagePropertiesSettings
+
+    DetectLabelsImageQuality.add_member(:brightness, Shapes::ShapeRef.new(shape: Float, location_name: "Brightness"))
+    DetectLabelsImageQuality.add_member(:sharpness, Shapes::ShapeRef.new(shape: Float, location_name: "Sharpness"))
+    DetectLabelsImageQuality.add_member(:contrast, Shapes::ShapeRef.new(shape: Float, location_name: "Contrast"))
+    DetectLabelsImageQuality.struct_class = Types::DetectLabelsImageQuality
+
     DetectLabelsRequest.add_member(:image, Shapes::ShapeRef.new(shape: Image, required: true, location_name: "Image"))
     DetectLabelsRequest.add_member(:max_labels, Shapes::ShapeRef.new(shape: UInteger, location_name: "MaxLabels"))
     DetectLabelsRequest.add_member(:min_confidence, Shapes::ShapeRef.new(shape: Percent, location_name: "MinConfidence"))
+    DetectLabelsRequest.add_member(:features, Shapes::ShapeRef.new(shape: DetectLabelsFeatureList, location_name: "Features"))
+    DetectLabelsRequest.add_member(:settings, Shapes::ShapeRef.new(shape: DetectLabelsSettings, location_name: "Settings"))
     DetectLabelsRequest.struct_class = Types::DetectLabelsRequest
 
     DetectLabelsResponse.add_member(:labels, Shapes::ShapeRef.new(shape: Labels, location_name: "Labels"))
     DetectLabelsResponse.add_member(:orientation_correction, Shapes::ShapeRef.new(shape: OrientationCorrection, location_name: "OrientationCorrection"))
     DetectLabelsResponse.add_member(:label_model_version, Shapes::ShapeRef.new(shape: String, location_name: "LabelModelVersion"))
+    DetectLabelsResponse.add_member(:image_properties, Shapes::ShapeRef.new(shape: DetectLabelsImageProperties, location_name: "ImageProperties"))
     DetectLabelsResponse.struct_class = Types::DetectLabelsResponse
 
+    DetectLabelsSettings.add_member(:general_labels, Shapes::ShapeRef.new(shape: GeneralLabelsSettings, location_name: "GeneralLabels"))
+    DetectLabelsSettings.add_member(:image_properties, Shapes::ShapeRef.new(shape: DetectLabelsImagePropertiesSettings, location_name: "ImageProperties"))
+    DetectLabelsSettings.struct_class = Types::DetectLabelsSettings
+
     DetectModerationLabelsRequest.add_member(:image, Shapes::ShapeRef.new(shape: Image, required: true, location_name: "Image"))
     DetectModerationLabelsRequest.add_member(:min_confidence, Shapes::ShapeRef.new(shape: Percent, location_name: "MinConfidence"))
     DetectModerationLabelsRequest.add_member(:human_loop_config, Shapes::ShapeRef.new(shape: HumanLoopConfig, location_name: "HumanLoopConfig"))
@@ -835,6 +884,17 @@ module Aws::Rekognition
 
     DistributeDatasetMetadataList.member = Shapes::ShapeRef.new(shape: DistributeDataset)
 
+    DominantColor.add_member(:red, Shapes::ShapeRef.new(shape: UInteger, location_name: "Red"))
+    DominantColor.add_member(:blue, Shapes::ShapeRef.new(shape: UInteger, location_name: "Blue"))
+    DominantColor.add_member(:green, Shapes::ShapeRef.new(shape: UInteger, location_name: "Green"))
+    DominantColor.add_member(:hex_code, Shapes::ShapeRef.new(shape: String, location_name: "HexCode"))
+    DominantColor.add_member(:css_color, Shapes::ShapeRef.new(shape: String, location_name: "CSSColor"))
+    DominantColor.add_member(:simplified_color, Shapes::ShapeRef.new(shape: String, location_name: "SimplifiedColor"))
+    DominantColor.add_member(:pixel_percent, Shapes::ShapeRef.new(shape: Percent, location_name: "PixelPercent"))
+    DominantColor.struct_class = Types::DominantColor
+
+    DominantColors.member = Shapes::ShapeRef.new(shape: DominantColor)
+
     Emotion.add_member(:type, Shapes::ShapeRef.new(shape: EmotionName, location_name: "Type"))
     Emotion.add_member(:confidence, Shapes::ShapeRef.new(shape: Percent, location_name: "Confidence"))
     Emotion.struct_class = Types::Emotion
@@ -920,6 +980,14 @@ module Aws::Rekognition
     Gender.add_member(:confidence, Shapes::ShapeRef.new(shape: Percent, location_name: "Confidence"))
     Gender.struct_class = Types::Gender
 
+    GeneralLabelsFilterList.member = Shapes::ShapeRef.new(shape: GeneralLabelsFilterValue)
+
+    GeneralLabelsSettings.add_member(:label_inclusion_filters, Shapes::ShapeRef.new(shape: GeneralLabelsFilterList, location_name: "LabelInclusionFilters"))
+    GeneralLabelsSettings.add_member(:label_exclusion_filters, Shapes::ShapeRef.new(shape: GeneralLabelsFilterList, location_name: "LabelExclusionFilters"))
+    GeneralLabelsSettings.add_member(:label_category_inclusion_filters, Shapes::ShapeRef.new(shape: GeneralLabelsFilterList, location_name: "LabelCategoryInclusionFilters"))
+    GeneralLabelsSettings.add_member(:label_category_exclusion_filters, Shapes::ShapeRef.new(shape: GeneralLabelsFilterList, location_name: "LabelCategoryExclusionFilters"))
+    GeneralLabelsSettings.struct_class = Types::GeneralLabelsSettings
+
     Geometry.add_member(:bounding_box, Shapes::ShapeRef.new(shape: BoundingBox, location_name: "BoundingBox"))
     Geometry.add_member(:polygon, Shapes::ShapeRef.new(shape: Polygon, location_name: "Polygon"))
     Geometry.struct_class = Types::Geometry
@@ -1089,6 +1157,7 @@ module Aws::Rekognition
 
     Instance.add_member(:bounding_box, Shapes::ShapeRef.new(shape: BoundingBox, location_name: "BoundingBox"))
     Instance.add_member(:confidence, Shapes::ShapeRef.new(shape: Percent, location_name: "Confidence"))
+    Instance.add_member(:dominant_colors, Shapes::ShapeRef.new(shape: DominantColors, location_name: "DominantColors"))
     Instance.struct_class = Types::Instance
 
     Instances.member = Shapes::ShapeRef.new(shape: Instance)
@@ -1122,8 +1191,20 @@ module Aws::Rekognition
     Label.add_member(:confidence, Shapes::ShapeRef.new(shape: Percent, location_name: "Confidence"))
     Label.add_member(:instances, Shapes::ShapeRef.new(shape: Instances, location_name: "Instances"))
     Label.add_member(:parents, Shapes::ShapeRef.new(shape: Parents, location_name: "Parents"))
+    Label.add_member(:aliases, Shapes::ShapeRef.new(shape: LabelAliases, location_name: "Aliases"))
+    Label.add_member(:categories, Shapes::ShapeRef.new(shape: LabelCategories, location_name: "Categories"))
     Label.struct_class = Types::Label
 
+    LabelAlias.add_member(:name, Shapes::ShapeRef.new(shape: String, location_name: "Name"))
+    LabelAlias.struct_class = Types::LabelAlias
+
+    LabelAliases.member = Shapes::ShapeRef.new(shape: LabelAlias)
+
+    LabelCategories.member = Shapes::ShapeRef.new(shape: LabelCategory)
+
+    LabelCategory.add_member(:name, Shapes::ShapeRef.new(shape: String, location_name: "Name"))
+    LabelCategory.struct_class = Types::LabelCategory
+
     LabelDetection.add_member(:timestamp, Shapes::ShapeRef.new(shape: Timestamp, location_name: "Timestamp"))
     LabelDetection.add_member(:label, Shapes::ShapeRef.new(shape: Label, location_name: "Label"))
     LabelDetection.struct_class = Types::LabelDetection

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

@@ -91,17 +91,17 @@ ZHBvaW50Ijp7InVybCI6Imh0dHBzOi8vcmVrb2duaXRpb24tZmlwcy5jYS1j
 ZW50cmFsLTEuYW1hem9uYXdzLmNvbSIsInByb3BlcnRpZXMiOnt9LCJoZWFk
 ZXJzIjp7fX0sInR5cGUiOiJlbmRwb2ludCJ9LHsiY29uZGl0aW9ucyI6W3si
 Zm4iOiJzdHJpbmdFcXVhbHMiLCJhcmd2IjpbeyJyZWYiOiJSZWdpb24ifSwi
-cmVrb2duaXRpb24udXMtZWFzdC0yIl19XSwiZW5kcG9pbnQiOnsidXJsIjoi
-aHR0cHM6Ly9yZWtvZ25pdGlvbi1maXBzLnVzLWVhc3QtMi5hbWF6b25hd3Mu
+cmVrb2duaXRpb24udXMtZWFzdC0xIl19XSwiZW5kcG9pbnQiOnsidXJsIjoi
+aHR0cHM6Ly9yZWtvZ25pdGlvbi1maXBzLnVzLWVhc3QtMS5hbWF6b25hd3Mu
 Y29tIiwicHJvcGVydGllcyI6e30sImhlYWRlcnMiOnt9fSwidHlwZSI6ImVu
 ZHBvaW50In0seyJjb25kaXRpb25zIjpbeyJmbiI6InN0cmluZ0VxdWFscyIs
-ImFyZ3YiOlt7InJlZiI6IlJlZ2lvbiJ9LCJyZWtvZ25pdGlvbi51cy13ZXN0
-LTEiXX1dLCJlbmRwb2ludCI6eyJ1cmwiOiJodHRwczovL3Jla29nbml0aW9u
-LWZpcHMudXMtd2VzdC0xLmFtYXpvbmF3cy5jb20iLCJwcm9wZXJ0aWVzIjp7
+ImFyZ3YiOlt7InJlZiI6IlJlZ2lvbiJ9LCJyZWtvZ25pdGlvbi51cy1lYXN0
+LTIiXX1dLCJlbmRwb2ludCI6eyJ1cmwiOiJodHRwczovL3Jla29nbml0aW9u
+LWZpcHMudXMtZWFzdC0yLmFtYXpvbmF3cy5jb20iLCJwcm9wZXJ0aWVzIjp7
 fSwiaGVhZGVycyI6e319LCJ0eXBlIjoiZW5kcG9pbnQifSx7ImNvbmRpdGlv
 bnMiOlt7ImZuIjoic3RyaW5nRXF1YWxzIiwiYXJndiI6W3sicmVmIjoiUmVn
-aW9uIn0sInJla29nbml0aW9uLnVzLWVhc3QtMSJdfV0sImVuZHBvaW50Ijp7
-InVybCI6Imh0dHBzOi8vcmVrb2duaXRpb24tZmlwcy51cy1lYXN0LTEuYW1h
+aW9uIn0sInJla29nbml0aW9uLnVzLXdlc3QtMSJdfV0sImVuZHBvaW50Ijp7
+InVybCI6Imh0dHBzOi8vcmVrb2duaXRpb24tZmlwcy51cy13ZXN0LTEuYW1h
 em9uYXdzLmNvbSIsInByb3BlcnRpZXMiOnt9LCJoZWFkZXJzIjp7fX0sInR5
 cGUiOiJlbmRwb2ludCJ9LHsiY29uZGl0aW9ucyI6W3siZm4iOiJzdHJpbmdF
 cXVhbHMiLCJhcmd2IjpbeyJyZWYiOiJSZWdpb24ifSwicmVrb2duaXRpb24u

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

@@ -316,7 +316,9 @@ module Aws::Rekognition
     #
     # @!attribute [rw] timestamp
     #   The time, in milliseconds from the start of the video, that the
-    #   celebrity was recognized.
+    #   celebrity was recognized. Note that `Timestamp` is not guaranteed to
+    #   be accurate to the individual frame where the celebrity first
+    #   appears.
     #   @return [Integer]
     #
     # @!attribute [rw] celebrity
@@ -629,7 +631,9 @@ module Aws::Rekognition
     #
     # @!attribute [rw] timestamp
     #   Time, in milliseconds from the beginning of the video, that the
-    #   content moderation label was detected.
+    #   content moderation label was detected. Note that `Timestamp` is not
+    #   guaranteed to be accurate to the individual frame where the
+    #   moderated content first appears.
     #   @return [Integer]
     #
     # @!attribute [rw] moderation_label
@@ -2096,6 +2100,131 @@ module Aws::Rekognition
       include Aws::Structure
     end
 
+    # The background of the image with regard to image quality and dominant
+    # colors.
+    #
+    # @!attribute [rw] quality
+    #   The quality of the image background as defined by brightness and
+    #   sharpness.
+    #   @return [Types::DetectLabelsImageQuality]
+    #
+    # @!attribute [rw] dominant_colors
+    #   The dominant colors found in the background of an image, defined
+    #   with RGB values, CSS color name, simplified color name, and
+    #   PixelPercentage (the percentage of image pixels that have a
+    #   particular color).
+    #   @return [Array<Types::DominantColor>]
+    #
+    class DetectLabelsImageBackground < Struct.new(
+      :quality,
+      :dominant_colors)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # The foreground of the image with regard to image quality and dominant
+    # colors.
+    #
+    # @!attribute [rw] quality
+    #   The quality of the image foreground as defined by brightness and
+    #   sharpness.
+    #   @return [Types::DetectLabelsImageQuality]
+    #
+    # @!attribute [rw] dominant_colors
+    #   The dominant colors found in the foreground of an image, defined
+    #   with RGB values, CSS color name, simplified color name, and
+    #   PixelPercentage (the percentage of image pixels that have a
+    #   particular color).
+    #   @return [Array<Types::DominantColor>]
+    #
+    class DetectLabelsImageForeground < Struct.new(
+      :quality,
+      :dominant_colors)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Information about the quality and dominant colors of an input image.
+    # Quality and color information is returned for the entire image,
+    # foreground, and background.
+    #
+    # @!attribute [rw] quality
+    #   Information about the quality of the image foreground as defined by
+    #   brightness, sharpness, and contrast. The higher the value the
+    #   greater the brightness, sharpness, and contrast respectively.
+    #   @return [Types::DetectLabelsImageQuality]
+    #
+    # @!attribute [rw] dominant_colors
+    #   Information about the dominant colors found in an image, described
+    #   with RGB values, CSS color name, simplified color name, and
+    #   PixelPercentage (the percentage of image pixels that have a
+    #   particular color).
+    #   @return [Array<Types::DominantColor>]
+    #
+    # @!attribute [rw] foreground
+    #   Information about the properties of an image’s foreground, including
+    #   the foreground’s quality and dominant colors, including the quality
+    #   and dominant colors of the image.
+    #   @return [Types::DetectLabelsImageForeground]
+    #
+    # @!attribute [rw] background
+    #   Information about the properties of an image’s background, including
+    #   the background’s quality and dominant colors, including the quality
+    #   and dominant colors of the image.
+    #   @return [Types::DetectLabelsImageBackground]
+    #
+    class DetectLabelsImageProperties < Struct.new(
+      :quality,
+      :dominant_colors,
+      :foreground,
+      :background)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Settings for the IMAGE\_PROPERTIES feature type.
+    #
+    # @note When making an API call, you may pass DetectLabelsImagePropertiesSettings
+    #   data as a hash:
+    #
+    #       {
+    #         max_dominant_colors: 1,
+    #       }
+    #
+    # @!attribute [rw] max_dominant_colors
+    #   The maximum number of dominant colors to return when detecting
+    #   labels in an image. The default value is 10.
+    #   @return [Integer]
+    #
+    class DetectLabelsImagePropertiesSettings < Struct.new(
+      :max_dominant_colors)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # The quality of an image provided for label detection, with regard to
+    # brightness, sharpness, and contrast.
+    #
+    # @!attribute [rw] brightness
+    #   The brightness of an image provided for label detection.
+    #   @return [Float]
+    #
+    # @!attribute [rw] sharpness
+    #   The sharpness of an image provided for label detection.
+    #   @return [Float]
+    #
+    # @!attribute [rw] contrast
+    #   The contrast of an image provided for label detection.
+    #   @return [Float]
+    #
+    class DetectLabelsImageQuality < Struct.new(
+      :brightness,
+      :sharpness,
+      :contrast)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass DetectLabelsRequest
     #   data as a hash:
     #
@@ -2110,6 +2239,18 @@ module Aws::Rekognition
     #         },
     #         max_labels: 1,
     #         min_confidence: 1.0,
+    #         features: ["GENERAL_LABELS"], # accepts GENERAL_LABELS, IMAGE_PROPERTIES
+    #         settings: {
+    #           general_labels: {
+    #             label_inclusion_filters: ["GeneralLabelsFilterValue"],
+    #             label_exclusion_filters: ["GeneralLabelsFilterValue"],
+    #             label_category_inclusion_filters: ["GeneralLabelsFilterValue"],
+    #             label_category_exclusion_filters: ["GeneralLabelsFilterValue"],
+    #           },
+    #           image_properties: {
+    #             max_dominant_colors: 1,
+    #           },
+    #         },
     #       }
     #
     # @!attribute [rw] image
@@ -2139,10 +2280,29 @@ module Aws::Rekognition
     #   with a confidence values greater than or equal to 55 percent.
     #   @return [Float]
     #
+    # @!attribute [rw] features
+    #   A list of the types of analysis to perform. Specifying
+    #   GENERAL\_LABELS uses the label detection feature, while specifying
+    #   IMAGE\_PROPERTIES returns information regarding image color and
+    #   quality. If no option is specified GENERAL\_LABELS is used by
+    #   default.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] settings
+    #   A list of the filters to be applied to returned detected labels and
+    #   image properties. Specified filters can be inclusive, exclusive, or
+    #   a combination of both. Filters can be used for individual labels or
+    #   label categories. The exact label names or label categories must be
+    #   supplied. For a full list of labels and label categories, see LINK
+    #   HERE.
+    #   @return [Types::DetectLabelsSettings]
+    #
     class DetectLabelsRequest < Struct.new(
       :image,
       :max_labels,
-      :min_confidence)
+      :min_confidence,
+      :features,
+      :settings)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2173,10 +2333,52 @@ module Aws::Rekognition
     #   labels.
     #   @return [String]
     #
+    # @!attribute [rw] image_properties
+    #   Information about the properties of the input image, such as
+    #   brightness, sharpness, contrast, and dominant colors.
+    #   @return [Types::DetectLabelsImageProperties]
+    #
     class DetectLabelsResponse < Struct.new(
       :labels,
       :orientation_correction,
-      :label_model_version)
+      :label_model_version,
+      :image_properties)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Settings for the DetectLabels request. Settings can include filters
+    # for both GENERAL\_LABELS and IMAGE\_PROPERTIES. GENERAL\_LABELS
+    # filters can be inclusive or exclusive and applied to individual labels
+    # or label categories. IMAGE\_PROPERTIES filters allow specification of
+    # a maximum number of dominant colors.
+    #
+    # @note When making an API call, you may pass DetectLabelsSettings
+    #   data as a hash:
+    #
+    #       {
+    #         general_labels: {
+    #           label_inclusion_filters: ["GeneralLabelsFilterValue"],
+    #           label_exclusion_filters: ["GeneralLabelsFilterValue"],
+    #           label_category_inclusion_filters: ["GeneralLabelsFilterValue"],
+    #           label_category_exclusion_filters: ["GeneralLabelsFilterValue"],
+    #         },
+    #         image_properties: {
+    #           max_dominant_colors: 1,
+    #         },
+    #       }
+    #
+    # @!attribute [rw] general_labels
+    #   Contains the specified filters for GENERAL\_LABELS.
+    #   @return [Types::GeneralLabelsSettings]
+    #
+    # @!attribute [rw] image_properties
+    #   Contains the chosen number of maximum dominant colors in an image.
+    #   @return [Types::DetectLabelsImagePropertiesSettings]
+    #
+    class DetectLabelsSettings < Struct.new(
+      :general_labels,
+      :image_properties)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2523,6 +2725,48 @@ module Aws::Rekognition
 
     class DistributeDatasetEntriesResponse < Aws::EmptyStructure; end
 
+    # A description of the dominant colors in an image.
+    #
+    # @!attribute [rw] red
+    #   The Red RGB value for a dominant color.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] blue
+    #   The Blue RGB value for a dominant color.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] green
+    #   The Green RGB value for a dominant color.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] hex_code
+    #   The Hex code equivalent of the RGB values for a dominant color.
+    #   @return [String]
+    #
+    # @!attribute [rw] css_color
+    #   The CSS color name of a dominant color.
+    #   @return [String]
+    #
+    # @!attribute [rw] simplified_color
+    #   One of 12 simplified color names applied to a dominant color.
+    #   @return [String]
+    #
+    # @!attribute [rw] pixel_percent
+    #   The percentage of image pixels that have a given dominant color.
+    #   @return [Float]
+    #
+    class DominantColor < Struct.new(
+      :red,
+      :blue,
+      :green,
+      :hex_code,
+      :css_color,
+      :simplified_color,
+      :pixel_percent)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The emotions that appear to be expressed on the face, and the
     # confidence level in the determination. The API is only making a
     # determination of the physical appearance of a person's face. It is
@@ -2799,7 +3043,8 @@ module Aws::Rekognition
     #
     # @!attribute [rw] timestamp
     #   Time, in milliseconds from the start of the video, that the face was
-    #   detected.
+    #   detected. Note that `Timestamp` is not guaranteed to be accurate to
+    #   the individual frame where the face first appears.
     #   @return [Integer]
     #
     # @!attribute [rw] face
@@ -2920,6 +3165,48 @@ module Aws::Rekognition
       include Aws::Structure
     end
 
+    # Contains filters for the object labels returned by DetectLabels.
+    # Filters can be inclusive, exclusive, or a combination of both and can
+    # be applied to individual l abels or entire label categories.
+    #
+    # @note When making an API call, you may pass GeneralLabelsSettings
+    #   data as a hash:
+    #
+    #       {
+    #         label_inclusion_filters: ["GeneralLabelsFilterValue"],
+    #         label_exclusion_filters: ["GeneralLabelsFilterValue"],
+    #         label_category_inclusion_filters: ["GeneralLabelsFilterValue"],
+    #         label_category_exclusion_filters: ["GeneralLabelsFilterValue"],
+    #       }
+    #
+    # @!attribute [rw] label_inclusion_filters
+    #   The labels that should be included in the return from DetectLabels.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] label_exclusion_filters
+    #   The labels that should be excluded from the return from
+    #   DetectLabels.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] label_category_inclusion_filters
+    #   The label categories that should be included in the return from
+    #   DetectLabels.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] label_category_exclusion_filters
+    #   The label categories that should be excluded from the return from
+    #   DetectLabels.
+    #   @return [Array<String>]
+    #
+    class GeneralLabelsSettings < Struct.new(
+      :label_inclusion_filters,
+      :label_exclusion_filters,
+      :label_category_inclusion_filters,
+      :label_category_exclusion_filters)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Information about where an object (DetectCustomLabels) or text
     # (DetectText) is located on an image.
     #
@@ -4052,9 +4339,14 @@ module Aws::Rekognition
     #   bounding box.
     #   @return [Float]
     #
+    # @!attribute [rw] dominant_colors
+    #   The dominant colors found in an individual instance of a label.
+    #   @return [Array<Types::DominantColor>]
+    #
     class Instance < Struct.new(
       :bounding_box,
-      :confidence)
+      :confidence,
+      :dominant_colors)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -4130,8 +4422,10 @@ module Aws::Rekognition
     end
 
     # Specifies the starting point in a Kinesis stream to start processing.
-    # You can use the producer timestamp or the fragment number. For more
-    # information, see [Fragment][1].
+    # You can use the producer timestamp or the fragment number. One of
+    # either producer timestamp or fragment number is required. If you use
+    # the producer timestamp, you must put the time in milliseconds. For
+    # more information about fragment numbers, see [Fragment][1].
     #
     #
     #
@@ -4146,7 +4440,8 @@ module Aws::Rekognition
     #       }
     #
     # @!attribute [rw] producer_timestamp
-    #   The timestamp from the producer corresponding to the fragment.
+    #   The timestamp from the producer corresponding to the fragment, in
+    #   milliseconds, expressed in unix time format.
     #   @return [Integer]
     #
     # @!attribute [rw] fragment_number
@@ -4198,11 +4493,45 @@ module Aws::Rekognition
     #   labels.
     #   @return [Array<Types::Parent>]
     #
+    # @!attribute [rw] aliases
+    #   A list of potential aliases for a given label.
+    #   @return [Array<Types::LabelAlias>]
+    #
+    # @!attribute [rw] categories
+    #   A list of the categories associated with a given label.
+    #   @return [Array<Types::LabelCategory>]
+    #
     class Label < Struct.new(
       :name,
       :confidence,
       :instances,
-      :parents)
+      :parents,
+      :aliases,
+      :categories)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # A potential alias of for a given label.
+    #
+    # @!attribute [rw] name
+    #   The name of an alias for a given label.
+    #   @return [String]
+    #
+    class LabelAlias < Struct.new(
+      :name)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # The category that applies to a given label.
+    #
+    # @!attribute [rw] name
+    #   The name of a category that applies to a given label.
+    #   @return [String]
+    #
+    class LabelCategory < Struct.new(
+      :name)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -4212,7 +4541,8 @@ module Aws::Rekognition
     #
     # @!attribute [rw] timestamp
     #   Time, in milliseconds from the start of the video, that the label
-    #   was detected.
+    #   was detected. Note that `Timestamp` is not guaranteed to be accurate
+    #   to the individual frame where the label first appears.
     #   @return [Integer]
     #
     # @!attribute [rw] label
@@ -4816,7 +5146,9 @@ module Aws::Rekognition
     #
     # @!attribute [rw] timestamp
     #   The time, in milliseconds from the start of the video, that the
-    #   person's path was tracked.
+    #   person's path was tracked. Note that `Timestamp` is not guaranteed
+    #   to be accurate to the individual frame where the person's path
+    #   first appears.
     #   @return [Integer]
     #
     # @!attribute [rw] person
@@ -6487,7 +6819,9 @@ module Aws::Rekognition
     # @!attribute [rw] start_selector
     #   Specifies the starting point in the Kinesis stream to start
     #   processing. You can use the producer timestamp or the fragment
-    #   number. For more information, see [Fragment][1].
+    #   number. If you use the producer timestamp, you must put the time in
+    #   milliseconds. For more information about fragment numbers, see
+    #   [Fragment][1].
     #
     #   This is a required parameter for label detection stream processors
     #   and should not be used to start a face search stream processor.
@@ -6769,6 +7103,9 @@ module Aws::Rekognition
 
     class StopStreamProcessorResponse < Aws::EmptyStructure; end
 
+    # This is a required parameter for label detection stream processors and
+    # should not be used to start a face search stream processor.
+    #
     # @note When making an API call, you may pass StreamProcessingStartSelector
     #   data as a hash:
     #
@@ -6781,8 +7118,8 @@ module Aws::Rekognition
     #
     # @!attribute [rw] kvs_stream_start_selector
     #   Specifies the starting point in the stream to start processing. This
-    #   can be done with a timestamp or a fragment number in a Kinesis
-    #   stream.
+    #   can be done with a producer timestamp or a fragment number in a
+    #   Kinesis stream.
     #   @return [Types::KinesisVideoStreamStartSelector]
     #
     class StreamProcessingStartSelector < Struct.new(
@@ -7235,7 +7572,8 @@ module Aws::Rekognition
     #
     # @!attribute [rw] timestamp
     #   The time, in milliseconds from the start of the video, that the text
-    #   was detected.
+    #   was detected. Note that `Timestamp` is not guaranteed to be accurate
+    #   to the individual frame where the text first appears.
     #   @return [Integer]
     #
     # @!attribute [rw] text_detection

data/lib/aws-sdk-rekognition.rb

@@ -53,6 +53,6 @@ require_relative 'aws-sdk-rekognition/customizations'
 # @!group service
 module Aws::Rekognition
 
-  GEM_VERSION = '1.71.0'
+  GEM_VERSION = '1.72.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-rekognition
 version: !ruby/object:Gem::Version
-  version: 1.71.0
+  version: 1.72.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-10-25 00:00:00.000000000 Z
+date: 2022-11-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core