aws-sdk-rekognition 1.10.0 → 1.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 2d3fa98f7cf90ae98ab69e6a5ff00cd0f761fa77
-  data.tar.gz: 56ab01ad98223353ce59a4d9aff1a9a2be4f495f
+  metadata.gz: d6dfe87f1bcc7424a61682b5f56ea02b0cba2fb8
+  data.tar.gz: dc3fc7bf664cbf8966646907869131d2f93eb018
 SHA512:
-  metadata.gz: 36053a204711eb24d5f0197ebead895c1d55a1f6e3bcd6ac2b758837fcb5683934a9af26c9880ddf5b49ca4f7f506d61abd455efa55d28186df567419fdf7ebd
-  data.tar.gz: c53dcd5b2a2e70d02977007b159155bb653eaca964c239b48c6f76fc1b6179700401aee098ead40258ef9050042d2c25432b5d8cf58813d690db502974710220
+  metadata.gz: 1875e75835c3aed614d5b4f625352a3a7555bb3104ccc0aefa2fcf41e577db06b1ff5e73220a08be988d37df35dbb7dc3bd5c671e222836dfbe644a1468ea25f
+  data.tar.gz: 53e3821805a71d2801596badb958b76c890622b917abfc1e884f37eee4f552f53f5662896c5848a1ab6edffd2921b586010c3a318dcacd5bba0041cb0afa04d4

data/lib/aws-sdk-rekognition.rb

@@ -42,6 +42,6 @@ require_relative 'aws-sdk-rekognition/customizations'
 # @service
 module Aws::Rekognition
 
-  GEM_VERSION = '1.10.0'
+  GEM_VERSION = '1.11.0'
 
 end

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

@@ -196,10 +196,9 @@ module Aws::Rekognition
     #  </note>
     #
     # You pass the input and target images either as base64-encoded image
-    # bytes or as a references to images in an Amazon S3 bucket. If you use
-    # the Amazon CLI to call Amazon Rekognition operations, passing image
-    # bytes is not supported. The image must be either a PNG or JPEG
-    # formatted file.
+    # bytes or as references to images in an Amazon S3 bucket. If you use
+    # the AWS CLI to call Amazon Rekognition operations, passing image bytes
+    # isn't supported. The image must be formatted as a PNG or JPEG file.
     #
     # In response, the operation returns an array of face matches ordered by
     # similarity score in descending order. For each face match, the
@@ -727,19 +726,19 @@ module Aws::Rekognition
     # Detects faces within an image that is provided as input.
     #
     # `DetectFaces` detects the 100 largest faces in the image. For each
-    # face detected, the operation returns face details including a bounding
-    # box of the face, a confidence value (that the bounding box contains a
-    # face), and a fixed set of attributes such as facial landmarks (for
-    # example, coordinates of eye and mouth), gender, presence of beard,
-    # sunglasses, etc.
+    # face detected, the operation returns face details. These details
+    # include a bounding box of the face, a confidence value (that the
+    # bounding box contains a face), and a fixed set of attributes such as
+    # facial landmarks (for example, coordinates of eye and mouth), gender,
+    # presence of beard, sunglasses, and so on.
     #
     # The face-detection algorithm is most effective on frontal faces. For
-    # non-frontal or obscured faces, the algorithm may not detect the faces
-    # or might detect faces with lower confidence.
+    # non-frontal or obscured faces, the algorithm might not detect the
+    # faces or might detect faces with lower confidence.
     #
     # You pass the input image either as base64-encoded image bytes or as a
-    # reference to an image in an Amazon S3 bucket. If you use the Amazon
-    # CLI to call Amazon Rekognition operations, passing image bytes is not
+    # 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.
     #
     # <note markdown="1"> This is a stateless API operation. That is, the operation does not
@@ -760,9 +759,9 @@ module Aws::Rekognition
     #   default list of attributes or all attributes. If you don't specify a
     #   value for `Attributes` or if you specify `["DEFAULT"]`, the API
     #   returns the following subset of facial attributes: `BoundingBox`,
-    #   `Confidence`, `Pose`, `Quality` and `Landmarks`. If you provide
-    #   `["ALL"]`, all facial attributes are returned but the operation will
-    #   take longer to complete.
+    #   `Confidence`, `Pose`, `Quality`, and `Landmarks`. If you provide
+    #   `["ALL"]`, all facial attributes are returned, but the operation takes
+    #   longer to complete.
     #
     #   If you provide both, `["ALL", "DEFAULT"]`, the service uses a logical
     #   AND operator to determine which attributes to return (in this case,
@@ -916,15 +915,15 @@ module Aws::Rekognition
     #  </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 Amazon
-    # CLI to call Amazon Rekognition operations, passing image bytes is not
+    # 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.
     #
     # 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
-    # will include all three labels, one for each object.
+    # includes all three labels, one for each object.
     #
     # `\{Name: lighthouse, Confidence: 98.4629\}`
     #
@@ -1059,8 +1058,8 @@ module Aws::Rekognition
     # in the Amazon Rekognition Developer Guide.
     #
     # You pass the input image either as base64-encoded image bytes or as a
-    # reference to an image in an Amazon S3 bucket. If you use the Amazon
-    # CLI to call Amazon Rekognition operations, passing image bytes is not
+    # 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.
     #
     # @option params [required, Types::Image] :image
@@ -1191,9 +1190,9 @@ module Aws::Rekognition
     end
 
     # Gets the name and additional information about a celebrity based on
-    # his or her Rekognition ID. The additional information is returned as
-    # an array of URLs. If there is no additional information about the
-    # celebrity, this list is empty.
+    # his or her Amazon Rekognition ID. The additional information is
+    # returned as an array of URLs. If there is no additional information
+    # about the celebrity, this list is empty.
     #
     # For more information, see Recognizing Celebrities in an Image in the
     # Amazon Rekognition Developer Guide.
@@ -1971,21 +1970,24 @@ module Aws::Rekognition
     # Detects faces in the input image and adds them to the specified
     # collection.
     #
-    # Amazon Rekognition does not save the actual faces detected. Instead,
-    # the underlying detection algorithm first detects the faces in the
-    # input image, and for each face extracts facial features into a feature
-    # vector, and stores it in the back-end database. Amazon Rekognition
-    # uses feature vectors when performing face match and search operations
-    # using the and operations.
+    # Amazon Rekognition doesn't save the actual faces that are detected.
+    # Instead, the underlying detection algorithm first detects the faces in
+    # the input image. For each face, the algorithm extracts facial features
+    # into a feature vector, and stores it in the backend database. Amazon
+    # Rekognition uses feature vectors when it performs face match and
+    # search operations using the and operations.
+    #
+    # For more information, see Adding Faces to a Collection in the Amazon
+    # Rekognition Developer Guide.
     #
     # To get the number of faces in a collection, call .
     #
-    # If you are using version 1.0 of the face detection model, `IndexFaces`
+    # If you're using version 1.0 of the face detection model, `IndexFaces`
     # indexes the 15 largest faces in the input image. Later versions of the
     # face detection model index the 100 largest faces in the input image.
-    # To determine which version of the model you are using, call and supply
-    # the collection ID. You also get the model version from the value of
-    # `FaceModelVersion` in the response from `IndexFaces`.
+    # To determine which version of the model you're using, call and supply
+    # the collection ID. You can also get the model version from the value
+    # of `FaceModelVersion` in the response from `IndexFaces`.
     #
     # For more information, see Model Versioning in the Amazon Rekognition
     # Developer Guide.
@@ -1999,58 +2001,65 @@ module Aws::Rekognition
     #
     # You can specify the maximum number of faces to index with the
     # `MaxFaces` input parameter. This is useful when you want to index the
-    # largest faces in an image, and you don't want to index other faces
-    # detected in the image.
+    # largest faces in an image and don't want to index smaller faces, such
+    # as those belonging to people standing in the background.
     #
     # The `QualityFilter` input parameter allows you to filter out detected
     # faces that don’t meet the required quality bar chosen by Amazon
     # Rekognition. The quality bar is based on a variety of common use
-    # cases.
-    #
-    # In response, the operation returns an array of metadata for all
-    # detected faces, `FaceRecords`. This includes:
+    # cases. By default, `IndexFaces` filters detected faces. You can also
+    # explicitly filter detected faces by specifying `AUTO` for the value of
+    # `QualityFilter`. If you do not want to filter detected faces, specify
+    # `NONE`.
     #
-    # * The bounding box, `BoundingBox`, of the detected face.
-    #
-    # * A confidence value, `Confidence`, indicating the confidence that the
-    #   bounding box contains a face.
-    #
-    # * A face ID, `faceId`, assigned by the service for each face that is
-    #   detected and stored.
+    # <note markdown="1"> To use quality filtering, you need a collection associated with
+    # version 3 of the face model. To get the version of the face model
+    # associated with a collection, call .
     #
-    # * An image ID, `ImageId`, assigned by the service for the input image.
-    #
-    # If you request all facial attributes (using the `detectionAttributes`
-    # parameter), Amazon Rekognition returns detailed facial attributes such
-    # as facial landmarks (for example, location of eye and mouth) and other
-    # facial attributes such gender. If you provide the same image, specify
-    # the same collection, and use the same external ID in the `IndexFaces`
-    # operation, Amazon Rekognition doesn't save duplicate face metadata.
+    #  </note>
     #
     # Information about faces detected in an image, but not indexed, is
-    # returned in an array of objects, `UnindexedFaces`. Faces are not
+    # returned in an array of objects, `UnindexedFaces`. Faces aren't
     # indexed for reasons such as:
     #
+    # * The number of faces detected exceeds the value of the `MaxFaces`
+    #   request parameter.
+    #
+    # * The face is too small compared to the image dimensions.
+    #
     # * The face is too blurry.
     #
     # * The image is too dark.
     #
     # * The face has an extreme pose.
     #
-    # * The face is too small.
+    # In response, the `IndexFaces` operation returns an array of metadata
+    # for all detected faces, `FaceRecords`. This includes:
     #
-    # * The number of faces detected exceeds the value of the `MaxFaces`
-    #   request parameter.
+    # * The bounding box, `BoundingBox`, of the detected face.
     #
+    # * A confidence value, `Confidence`, which indicates the confidence
+    #   that the bounding box contains a face.
     #
+    # * A face ID, `faceId`, assigned by the service for each face that's
+    #   detected and stored.
     #
-    # For more information, see Adding Faces to a Collection in the Amazon
-    # Rekognition Developer Guide.
+    # * An image ID, `ImageId`, assigned by the service for the input image.
     #
-    # The input image is passed either as base64-encoded image bytes or as a
-    # reference to an image in an Amazon S3 bucket. If you use the Amazon
-    # CLI to call Amazon Rekognition operations, passing image bytes is not
-    # supported. The image must be either a PNG or JPEG formatted file.
+    # If you request all facial attributes (by using the
+    # `detectionAttributes` parameter), Amazon Rekognition returns detailed
+    # facial attributes, such as facial landmarks (for example, location of
+    # eye and mouth) and other facial attributes like gender. If you provide
+    # the same image, specify the same collection, and use the same external
+    # ID in the `IndexFaces` operation, Amazon Rekognition doesn't save
+    # duplicate face metadata.
+    #
+    #
+    #
+    # The input image is passed either 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 isn't
+    # supported. The image must be formatted as a PNG or JPEG file.
     #
     # This operation requires permissions to perform the
     # `rekognition:IndexFaces` action.
@@ -2062,19 +2071,19 @@ module Aws::Rekognition
     # @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
-    #   base64-encoded image bytes is not supported.
+    #   base64-encoded image bytes isn't supported.
     #
     # @option params [String] :external_image_id
-    #   ID you want to assign to all the faces detected in the image.
+    #   The ID you want to assign to all the faces detected in the image.
     #
     # @option params [Array<String>] :detection_attributes
     #   An array of facial attributes that you want to be returned. This can
     #   be the default list of attributes or all attributes. If you don't
     #   specify a value for `Attributes` or if you specify `["DEFAULT"]`, the
     #   API returns the following subset of facial attributes: `BoundingBox`,
-    #   `Confidence`, `Pose`, `Quality` and `Landmarks`. If you provide
-    #   `["ALL"]`, all facial attributes are returned but the operation will
-    #   take longer to complete.
+    #   `Confidence`, `Pose`, `Quality`, and `Landmarks`. If you provide
+    #   `["ALL"]`, all facial attributes are returned, but the operation takes
+    #   longer to complete.
     #
     #   If you provide both, `["ALL", "DEFAULT"]`, the service uses a logical
     #   AND operator to determine which attributes to return (in this case,
@@ -2082,30 +2091,36 @@ module Aws::Rekognition
     #
     # @option params [Integer] :max_faces
     #   The maximum number of faces to index. The value of `MaxFaces` must be
-    #   greater than or equal to 1. `IndexFaces` returns no more that 100
+    #   greater than or equal to 1. `IndexFaces` returns no more than 100
     #   detected faces in an image, even if you specify a larger value for
     #   `MaxFaces`.
     #
     #   If `IndexFaces` detects more faces than the value of `MaxFaces`, the
     #   faces with the lowest quality are filtered out first. If there are
     #   still more faces than the value of `MaxFaces`, the faces with the
-    #   smallest bounding boxes are filtered out (up to the number needed to
-    #   satisfy the value of `MaxFaces`). Information about the unindexed
-    #   faces is available in the `UnindexedFaces` array.
+    #   smallest bounding boxes are filtered out (up to the number that's
+    #   needed to satisfy the value of `MaxFaces`). Information about the
+    #   unindexed faces is available in the `UnindexedFaces` array.
+    #
+    #   The faces that are returned by `IndexFaces` are sorted by the largest
+    #   face bounding box size to the smallest size, in descending order.
     #
-    #   The faces returned by `IndexFaces` are sorted, in descending order, by
-    #   the largest face bounding box size, to the smallest.
+    #   `MaxFaces` can be used with a collection associated with any version
+    #   of the face model.
     #
     # @option params [String] :quality_filter
-    #   Specifies how much filtering is done to identify faces detected with
-    #   low quality. Filtered faces are not indexed. If you specify `AUTO`,
-    #   filtering prioritizes the identification of faces that don’t meet the
-    #   required quality bar chosen by Amazon Rekognition. The quality bar is
-    #   based on a variety of common use cases. Low quality detections can
-    #   arise for a number of reasons. For example, an object misidentified as
-    #   a face, a face that is too blurry, or a face with a pose that is too
-    #   extreme to use. If you specify `NONE`, no filtering is performed. The
-    #   default value is NONE.
+    #   A filter that specifies how much filtering is done to identify faces
+    #   that are detected with low quality. Filtered faces aren't indexed. If
+    #   you specify `AUTO`, filtering prioritizes the identification of faces
+    #   that don’t meet the required quality bar chosen by Amazon Rekognition.
+    #   The quality bar is based on a variety of common use cases. Low-quality
+    #   detections can occur for a number of reasons. Some examples are an
+    #   object that's misidentified as a face, a face that's too blurry, or
+    #   a face with a pose that's too extreme to use. If you specify `NONE`,
+    #   no filtering is performed. The default value is AUTO.
+    #
+    #   To use quality filtering, the collection you are using must be
+    #   associated with version 3 of the face model.
     #
     # @return [Types::IndexFacesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2664,25 +2679,25 @@ module Aws::Rekognition
     # `RecognizeCelebrities` returns the 100 largest faces in the image. It
     # lists recognized celebrities in the `CelebrityFaces` array and
     # unrecognized faces in the `UnrecognizedFaces` array.
-    # `RecognizeCelebrities` doesn't return celebrities whose faces are not
-    # amongst the largest 100 faces in the image.
+    # `RecognizeCelebrities` doesn't return celebrities whose faces aren't
+    # among the largest 100 faces in the image.
     #
-    # For each celebrity recognized, the `RecognizeCelebrities` returns a
+    # For each celebrity recognized, `RecognizeCelebrities` returns a
     # `Celebrity` object. The `Celebrity` object contains the celebrity
     # name, ID, URL links to additional information, match confidence, and a
     # `ComparedFace` object that you can use to locate the celebrity's face
     # on the image.
     #
-    # Rekognition does not retain information about which images a celebrity
-    # has been recognized in. Your application must store this information
-    # and use the `Celebrity` ID property as a unique identifier for the
-    # celebrity. If you don't store the celebrity name or additional
-    # information URLs returned by `RecognizeCelebrities`, you will need the
-    # ID to identify the celebrity in a call to the operation.
+    # Amazon Rekognition doesn't retain information about which images a
+    # celebrity has been recognized in. Your application must store this
+    # information and use the `Celebrity` ID property as a unique identifier
+    # for the celebrity. If you don't store the celebrity name or
+    # additional information URLs returned by `RecognizeCelebrities`, you
+    # will need the ID to identify the celebrity in a call to the operation.
     #
-    # You pass the imput image either as base64-encoded image bytes or as a
-    # reference to an image in an Amazon S3 bucket. If you use the Amazon
-    # CLI to call Amazon Rekognition operations, passing image bytes is not
+    # You pass the input image either 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.
     #
     # For an example, see Recognizing Celebrities in an Image in the Amazon
@@ -2914,8 +2929,8 @@ module Aws::Rekognition
     #  </note>
     #
     # You pass the input image either as base64-encoded image bytes or as a
-    # reference to an image in an Amazon S3 bucket. If you use the Amazon
-    # CLI to call Amazon Rekognition operations, passing image bytes is not
+    # 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.
     #
     # The response returns an array of faces that match, ordered by
@@ -3549,7 +3564,7 @@ module Aws::Rekognition
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-rekognition'
-      context[:gem_version] = '1.10.0'
+      context[:gem_version] = '1.11.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -10,10 +10,10 @@ module Aws::Rekognition
 
     # Structure containing the estimated age range, in years, for a face.
     #
-    # Rekognition estimates an age-range for faces detected in the input
-    # image. Estimated age ranges can overlap; a face of a 5 year old may
-    # have an estimated range of 4-6 whilst the face of a 6 year old may
-    # have an estimated range of 4-8.
+    # Amazon Rekognition estimates an age range for faces detected in the
+    # input image. Estimated age ranges can overlap. A face of a 5-year-old
+    # might have an estimated range of 4-6, while the face of a 6-year-old
+    # might have an estimated range of 4-8.
     #
     # @!attribute [rw] low
     #   The lowest estimated age.
@@ -119,7 +119,7 @@ module Aws::Rekognition
     #   @return [Types::ComparedFace]
     #
     # @!attribute [rw] match_confidence
-    #   The confidence, in percentage, that Rekognition has that the
+    #   The confidence, in percentage, that Amazon Rekognition has that the
     #   recognized face is the celebrity.
     #   @return [Float]
     #
@@ -189,7 +189,7 @@ module Aws::Rekognition
     end
 
     # Provides information about a face in a target image that matches the
-    # source image face analysed by `CompareFaces`. The `Face` property
+    # source image face analyzed by `CompareFaces`. The `Face` property
     # contains the bounding box of the face in the target image. The
     # `Similarity` property is the confidence that the source image face
     # matches the face in the bounding box.
@@ -283,10 +283,10 @@ module Aws::Rekognition
     #   <note markdown="1"> If the source image is in .jpeg format, it might contain
     #   exchangeable image (Exif) metadata that includes the image's
     #   orientation. If the Exif metadata for the source image populates the
-    #   orientation field, the value of `OrientationCorrection` is null and
-    #   the `SourceImageFace` bounding box coordinates represent the
-    #   location of the face after Exif metadata is used to correct the
-    #   orientation. Images in .png format don't contain Exif metadata.
+    #   orientation field, the value of `OrientationCorrection` is null. The
+    #   `SourceImageFace` bounding box coordinates represent the location of
+    #   the face after Exif metadata is used to correct the orientation.
+    #   Images in .png format don't contain Exif metadata.
     #
     #    </note>
     #   @return [String]
@@ -301,7 +301,7 @@ module Aws::Rekognition
     #   <note markdown="1"> If the target image is in .jpg format, it might contain Exif
     #   metadata that includes the orientation of the image. If the Exif
     #   metadata for the target image populates the orientation field, the
-    #   value of `OrientationCorrection` is null and the bounding box
+    #   value of `OrientationCorrection` is null. The bounding box
     #   coordinates in `FaceMatches` and `UnmatchedFaces` represent the
     #   location of the face after Exif metadata is used to correct the
     #   orientation. Images in .png format don't contain Exif metadata.
@@ -318,7 +318,7 @@ module Aws::Rekognition
       include Aws::Structure
     end
 
-    # Provides face metadata for target image faces that are analysed by
+    # Provides face metadata for target image faces that are analyzed by
     # `CompareFaces` and `RecognizeCelebrities`.
     #
     # @!attribute [rw] bounding_box
@@ -717,9 +717,9 @@ module Aws::Rekognition
     #   the default list of attributes or all attributes. If you don't
     #   specify a value for `Attributes` or if you specify `["DEFAULT"]`,
     #   the API returns the following subset of facial attributes:
-    #   `BoundingBox`, `Confidence`, `Pose`, `Quality` and `Landmarks`. If
-    #   you provide `["ALL"]`, all facial attributes are returned but the
-    #   operation will take longer to complete.
+    #   `BoundingBox`, `Confidence`, `Pose`, `Quality`, and `Landmarks`. If
+    #   you provide `["ALL"]`, all facial attributes are returned, but the
+    #   operation takes longer to complete.
     #
     #   If you provide both, `["ALL", "DEFAULT"]`, the service uses a
     #   logical AND operator to determine which attributes to return (in
@@ -746,7 +746,7 @@ module Aws::Rekognition
     #   <note markdown="1"> If the input image is in .jpeg format, it might contain exchangeable
     #   image (Exif) metadata that includes the image's orientation. If so,
     #   and the Exif metadata for the input image populates the orientation
-    #   field, the value of `OrientationCorrection` is null and the
+    #   field, the value of `OrientationCorrection` is null. The
     #   `FaceDetails` bounding box coordinates represent face locations
     #   after Exif metadata is used to correct the image orientation. Images
     #   in .png format don't contain Exif metadata.
@@ -1146,8 +1146,8 @@ module Aws::Rekognition
       include Aws::Structure
     end
 
-    # Object containing both the face metadata (stored in the back-end
-    # database) and facial attributes that are detected but aren't stored
+    # Object containing both the face metadata (stored in the backend
+    # database), and facial attributes that are detected but aren't stored
     # in the database.
     #
     # @!attribute [rw] face
@@ -1736,27 +1736,27 @@ module Aws::Rekognition
 
     # Provides the input image either as bytes or an S3 object.
     #
-    # You pass image bytes to a Rekognition API operation by using the
-    # `Bytes` property. For example, you would use the `Bytes` property to
-    # pass an image loaded from a local file system. Image bytes passed by
-    # using the `Bytes` property must be base64-encoded. Your code may not
-    # need to encode image bytes if you are using an AWS SDK to call
-    # Rekognition API operations.
+    # You pass image bytes to an Amazon Rekognition API operation by using
+    # the `Bytes` property. For example, you would use the `Bytes` property
+    # to pass an image loaded from a local file system. Image bytes passed
+    # by using the `Bytes` property must be base64-encoded. Your code may
+    # not need to encode image bytes if you are using an AWS SDK to call
+    # Amazon Rekognition API operations.
     #
     # For more information, see Analyzing an Image Loaded from a Local File
     # System in the Amazon Rekognition Developer Guide.
     #
-    # You pass images stored in an S3 bucket to a Rekognition API operation
-    # by using the `S3Object` property. Images stored in an S3 bucket do not
-    # need to be base64-encoded.
+    # You pass images stored in an S3 bucket to an Amazon Rekognition API
+    # operation by using the `S3Object` property. Images stored in an S3
+    # bucket do not need to be base64-encoded.
     #
     # The region for the S3 bucket containing the S3 object must match the
     # region you use for Amazon Rekognition operations.
     #
-    # If you use the Amazon CLI to call Amazon Rekognition operations,
-    # passing image bytes using the Bytes property is not supported. You
-    # must first upload the image to an Amazon S3 bucket and then call the
-    # operation using the S3Object property.
+    # If you use the AWS CLI to call Amazon Rekognition operations, passing
+    # image bytes using the Bytes property is not supported. You must first
+    # upload the image to an Amazon S3 bucket and then call the operation
+    # using the S3Object property.
     #
     # For Amazon Rekognition to process an S3 object, the user must have
     # permission to access the S3 object. For more information, see Resource
@@ -1835,11 +1835,11 @@ module Aws::Rekognition
     # @!attribute [rw] image
     #   The input image as base64-encoded bytes or an S3 object. If you use
     #   the AWS CLI to call Amazon Rekognition operations, passing
-    #   base64-encoded image bytes is not supported.
+    #   base64-encoded image bytes isn't supported.
     #   @return [Types::Image]
     #
     # @!attribute [rw] external_image_id
-    #   ID you want to assign to all the faces detected in the image.
+    #   The ID you want to assign to all the faces detected in the image.
     #   @return [String]
     #
     # @!attribute [rw] detection_attributes
@@ -1847,9 +1847,9 @@ module Aws::Rekognition
     #   be the default list of attributes or all attributes. If you don't
     #   specify a value for `Attributes` or if you specify `["DEFAULT"]`,
     #   the API returns the following subset of facial attributes:
-    #   `BoundingBox`, `Confidence`, `Pose`, `Quality` and `Landmarks`. If
-    #   you provide `["ALL"]`, all facial attributes are returned but the
-    #   operation will take longer to complete.
+    #   `BoundingBox`, `Confidence`, `Pose`, `Quality`, and `Landmarks`. If
+    #   you provide `["ALL"]`, all facial attributes are returned, but the
+    #   operation takes longer to complete.
     #
     #   If you provide both, `["ALL", "DEFAULT"]`, the service uses a
     #   logical AND operator to determine which attributes to return (in
@@ -1858,31 +1858,39 @@ module Aws::Rekognition
     #
     # @!attribute [rw] max_faces
     #   The maximum number of faces to index. The value of `MaxFaces` must
-    #   be greater than or equal to 1. `IndexFaces` returns no more that 100
+    #   be greater than or equal to 1. `IndexFaces` returns no more than 100
     #   detected faces in an image, even if you specify a larger value for
     #   `MaxFaces`.
     #
     #   If `IndexFaces` detects more faces than the value of `MaxFaces`, the
     #   faces with the lowest quality are filtered out first. If there are
     #   still more faces than the value of `MaxFaces`, the faces with the
-    #   smallest bounding boxes are filtered out (up to the number needed to
-    #   satisfy the value of `MaxFaces`). Information about the unindexed
-    #   faces is available in the `UnindexedFaces` array.
+    #   smallest bounding boxes are filtered out (up to the number that's
+    #   needed to satisfy the value of `MaxFaces`). Information about the
+    #   unindexed faces is available in the `UnindexedFaces` array.
     #
-    #   The faces returned by `IndexFaces` are sorted, in descending order,
-    #   by the largest face bounding box size, to the smallest.
+    #   The faces that are returned by `IndexFaces` are sorted by the
+    #   largest face bounding box size to the smallest size, in descending
+    #   order.
+    #
+    #   `MaxFaces` can be used with a collection associated with any version
+    #   of the face model.
     #   @return [Integer]
     #
     # @!attribute [rw] quality_filter
-    #   Specifies how much filtering is done to identify faces detected with
-    #   low quality. Filtered faces are not indexed. If you specify `AUTO`,
-    #   filtering prioritizes the identification of faces that don’t meet
-    #   the required quality bar chosen by Amazon Rekognition. The quality
-    #   bar is based on a variety of common use cases. Low quality
-    #   detections can arise for a number of reasons. For example, an object
-    #   misidentified as a face, a face that is too blurry, or a face with a
-    #   pose that is too extreme to use. If you specify `NONE`, no filtering
-    #   is performed. The default value is NONE.
+    #   A filter that specifies how much filtering is done to identify faces
+    #   that are detected with low quality. Filtered faces aren't indexed.
+    #   If you specify `AUTO`, filtering prioritizes the identification of
+    #   faces that don’t meet the required quality bar chosen by Amazon
+    #   Rekognition. The quality bar is based on a variety of common use
+    #   cases. Low-quality detections can occur for a number of reasons.
+    #   Some examples are an object that's misidentified as a face, a face
+    #   that's too blurry, or a face with a pose that's too extreme to
+    #   use. If you specify `NONE`, no filtering is performed. The default
+    #   value is AUTO.
+    #
+    #   To use quality filtering, the collection you are using must be
+    #   associated with version 3 of the face model.
     #   @return [String]
     #
     class IndexFacesRequest < Struct.new(
@@ -1910,24 +1918,25 @@ module Aws::Rekognition
     #
     #   <note markdown="1"> If the input image is in jpeg format, it might contain exchangeable
     #   image (Exif) metadata. If so, and the Exif metadata populates the
-    #   orientation field, the value of `OrientationCorrection` is null and
-    #   the bounding box coordinates in `FaceRecords` represent face
-    #   locations after Exif metadata is used to correct the image
-    #   orientation. Images in .png format don't contain Exif metadata.
+    #   orientation field, the value of `OrientationCorrection` is null. The
+    #   bounding box coordinates in `FaceRecords` represent face locations
+    #   after Exif metadata is used to correct the image orientation. Images
+    #   in .png format don't contain Exif metadata.
     #
     #    </note>
     #   @return [String]
     #
     # @!attribute [rw] face_model_version
-    #   Version number of the face detection model associated with the input
-    #   collection (`CollectionId`).
+    #   The version number of the face detection model that's associated
+    #   with the input collection (`CollectionId`).
     #   @return [String]
     #
     # @!attribute [rw] unindexed_faces
-    #   An array of faces that detected in the image but not indexed either
-    #   because the quality filter deemed them to be of low-quality or the
-    #   `MaxFaces` request parameter filtered them out. To use the quality
-    #   filter, you specify the `QualityFilter` request parameter.
+    #   An array of faces that were detected in the image but weren't
+    #   indexed. They weren't indexed because the quality filter identified
+    #   them as low quality, or the `MaxFaces` request parameter filtered
+    #   them out. To use the quality filter, you specify the `QualityFilter`
+    #   request parameter.
     #   @return [Array<Types::UnindexedFace>]
     #
     class IndexFacesResponse < Struct.new(
@@ -2018,20 +2027,20 @@ module Aws::Rekognition
     # Indicates the location of the landmark on the face.
     #
     # @!attribute [rw] type
-    #   Type of the landmark.
+    #   Type of landmark.
     #   @return [String]
     #
     # @!attribute [rw] x
-    #   x-coordinate from the top left of the landmark expressed as the
-    #   ratio of the width of the image. For example, if the images is
-    #   700x200 and the x-coordinate of the landmark is at 350 pixels, this
+    #   The x-coordinate from the top left of the landmark expressed as the
+    #   ratio of the width of the image. For example, if the image is 700 x
+    #   200 and the x-coordinate of the landmark is at 350 pixels, this
     #   value is 0.5.
     #   @return [Float]
     #
     # @!attribute [rw] y
-    #   y-coordinate from the top left of the landmark expressed as the
-    #   ratio of the height of the image. For example, if the images is
-    #   700x200 and the y-coordinate of the landmark is at 100 pixels, this
+    #   The y-coordinate from the top left of the landmark expressed as the
+    #   ratio of the height of the image. For example, if the image is 700 x
+    #   200 and the y-coordinate of the landmark is at 100 pixels, this
     #   value is 0.5.
     #   @return [Float]
     #
@@ -2202,7 +2211,7 @@ module Aws::Rekognition
     #   @return [String]
     #
     # @!attribute [rw] parent_name
-    #   The name for the parent label. Labels at the top-level of the
+    #   The name for the parent label. Labels at the top level of the
     #   hierarchy have the parent label `""`.
     #   @return [String]
     #
@@ -2322,11 +2331,11 @@ module Aws::Rekognition
       include Aws::Structure
     end
 
-    # Information about a person whose face matches a face(s) in a Amazon
+    # Information about a person whose face matches a face(s) in an Amazon
     # Rekognition collection. Includes information about the faces in the
     # Amazon Rekognition collection (), information about the person
-    # (PersonDetail) and the timestamp for when the person was detected in a
-    # video. An array of `PersonMatch` objects is returned by .
+    # (PersonDetail), and the time stamp for when the person was detected in
+    # a video. An array of `PersonMatch` objects is returned by .
     #
     # @!attribute [rw] timestamp
     #   The time, in milliseconds from the beginning of the video, that the
@@ -2438,7 +2447,7 @@ module Aws::Rekognition
     #   <note markdown="1"> If the input image is in .jpeg format, it might contain exchangeable
     #   image (Exif) metadata that includes the image's orientation. If so,
     #   and the Exif metadata for the input image populates the orientation
-    #   field, the value of `OrientationCorrection` is null and the
+    #   field, the value of `OrientationCorrection` is null. The
     #   `CelebrityFaces` and `UnrecognizedFaces` bounding box coordinates
     #   represent face locations after Exif metadata is used to correct the
     #   image orientation. Images in .png format don't contain Exif
@@ -2460,8 +2469,8 @@ module Aws::Rekognition
     # region you use for Amazon Rekognition operations.
     #
     # For Amazon Rekognition to process an S3 object, the user must have
-    # permission to access the S3 object. For more information, see Resource
-    # Based Policies in the Amazon Rekognition Developer Guide.
+    # permission to access the S3 object. For more information, see
+    # Resource-Based Policies in the Amazon Rekognition Developer Guide.
     #
     # @note When making an API call, you may pass S3Object
     #   data as a hash:
@@ -3243,11 +3252,11 @@ module Aws::Rekognition
       include Aws::Structure
     end
 
-    # A face detected by but not indexed. Use the `Reasons` response
-    # attribute to determine why a face is not indexed.
+    # A face that detected, but didn't index. Use the `Reasons` response
+    # attribute to determine why a face wasn't indexed.
     #
     # @!attribute [rw] reasons
-    #   An array of reasons specifying why a face was not indexed.
+    #   An array of reasons that specify why a face wasn't indexed.
     #
     #   * EXTREME\_POSE - The face is at a pose that can't be detected. For
     #     example, the head is turned too far away from the camera.
@@ -3267,8 +3276,8 @@ module Aws::Rekognition
     #   @return [Array<String>]
     #
     # @!attribute [rw] face_detail
-    #   Structure containing attributes of a face that was detected, but not
-    #   indexed, by `IndexFaces`.
+    #   The structure that contains attributes of a face that
+    #   `IndexFaces`detected, but didn't index.
     #   @return [Types::FaceDetail]
     #
     class UnindexedFace < Struct.new(

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-rekognition
 version: !ruby/object:Gem::Version
-  version: 1.10.0
+  version: 1.11.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-09-18 00:00:00.000000000 Z
+date: 2018-10-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core