Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!
Get Started for Free

rekognition_list_faces

Returns metadata for faces in the specified collection


Description

Returns metadata for faces in the specified collection. This metadata includes information such as the bounding box coordinates, the confidence (that the bounding box contains a face), and face ID. For an example, see Listing Faces in a Collection in the Amazon Rekognition Developer Guide.

This operation requires permissions to perform the rekognition:ListFaces action.

Usage

rekognition_list_faces(CollectionId, NextToken, MaxResults)

Arguments

CollectionId

[required] ID of the collection from which to list the faces.

NextToken

If the previous response was incomplete (because there is more data to retrieve), Amazon Rekognition returns a pagination token in the response. You can use this pagination token to retrieve the next set of faces.

MaxResults

Maximum number of faces to return.

Value

A list with the following syntax:

list(
  Faces = list(
    list(
      FaceId = "string",
      BoundingBox = list(
        Width = 123.0,
        Height = 123.0,
        Left = 123.0,
        Top = 123.0
      ),
      ImageId = "string",
      ExternalImageId = "string",
      Confidence = 123.0
    )
  ),
  NextToken = "string",
  FaceModelVersion = "string"
)

Request syntax

svc$list_faces(
  CollectionId = "string",
  NextToken = "string",
  MaxResults = 123
)

Examples

## Not run: 
# This operation lists the faces in a Rekognition collection.
svc$list_faces(
  CollectionId = "myphotos",
  MaxResults = 20L
)

## End(Not run)

paws.machine.learning

Amazon Web Services Machine Learning Services

v0.1.11
Apache License (>= 2.0)
Authors
David Kretch [aut, cre], Adam Banker [aut], Amazon.com, Inc. [cph]
Initial release

We don't support your browser anymore

Please choose more modern alternatives, such as Google Chrome or Mozilla Firefox.