NAME

Paws::Rekognition::DetectFaces - Arguments for method DetectFaces on Paws::Rekognition

DESCRIPTION

This class represents the parameters used for calling the method DetectFaces on the Amazon Rekognition service. Use the attributes of this class as arguments to method DetectFaces.

You shouldn't make instances of this class. Each attribute should be used as a named argument in the call to DetectFaces.

SYNOPSIS

    my $rekognition = Paws->service('Rekognition');
    # To detect faces in an image
    # This operation detects faces in an image stored in an AWS S3 bucket.
    my $DetectFacesResponse = $rekognition->DetectFaces(
      'Image' => {
        'S3Object' => {
          'Bucket' => 'mybucket',
          'Name'   => 'myphoto'
        }
      }
    );
    # Results:
    my $FaceDetails           = $DetectFacesResponse->FaceDetails;
    my $OrientationCorrection = $DetectFacesResponse->OrientationCorrection;
    # Returns a L<Paws::Rekognition::DetectFacesResponse> object.

Values for attributes that are native types (Int, String, Float, etc) can passed as-is (scalar values). Values for complex Types (objects) can be passed as a HashRef. The keys and values of the hashref will be used to instance the underlying object. For the AWS API documentation, see <https://docs.aws.amazon.com/goto/WebAPI/rekognition/DetectFaces>

ATTRIBUTES

Attributes => ArrayRef[Str|Undef]

An array of facial attributes 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 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, all attributes).

REQUIRED Image => Paws::Rekognition::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.

If you are using an AWS SDK to call Amazon Rekognition, you might not need to base64-encode image bytes passed using the "Bytes" field. For more information, see Images in the Amazon Rekognition developer guide.

BUGS and CONTRIBUTIONS

The source code is located here: <https://github.com/pplu/aws-sdk-perl>

Please report bugs to: <https://github.com/pplu/aws-sdk-perl/issues>