You are viewing documentation for version 2 of the AWS SDK for Ruby. Version 3 documentation can be found here.

Class: Aws::Rekognition::Types::IndexFacesRequest

Inherits:
Struct
  • Object
show all
Defined in:
(unknown)

Overview

Note:

When passing IndexFacesRequest as input to an Aws::Client method, you can use a vanilla Hash:

{
  collection_id: "CollectionId", # required
  image: { # required
    bytes: "data",
    s3_object: {
      bucket: "S3Bucket",
      name: "S3ObjectName",
      version: "S3ObjectVersion",
    },
  },
  external_image_id: "ExternalImageId",
  detection_attributes: ["DEFAULT"], # accepts DEFAULT, ALL
}

Instance Attribute Summary collapse

Instance Attribute Details

#collection_idString

The ID of an existing collection to which you want to add the faces that are detected in the input images.

Returns:

  • (String)

    The ID of an existing collection to which you want to add the faces that are detected in the input images.

#detection_attributesArray<String>

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.

If you provide both, ["ALL", "DEFAULT"], the service uses a logical AND operator to determine which attributes to return (in this case, all attributes).

Returns:

  • (Array<String>)

    An array of facial attributes that you want to be returned.

#external_image_idString

ID you want to assign to all the faces detected in the image.

Returns:

  • (String)

    ID you want to assign to all the faces detected in the image.

#imageTypes::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.

Returns:

  • (Types::Image)

    The input image as base64-encoded bytes or an S3 object.