Skip to content

/AWS1/CL_REK=>LISTFACES()

About ListFaces

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.

Method Signature

IMPORTING

Required arguments:

IV_COLLECTIONID TYPE /AWS1/REKCOLLECTIONID /AWS1/REKCOLLECTIONID

ID of the collection from which to list the faces.

Optional arguments:

IV_NEXTTOKEN TYPE /AWS1/REKPAGINATIONTOKEN /AWS1/REKPAGINATIONTOKEN

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.

IV_MAXRESULTS TYPE /AWS1/REKPAGESIZE /AWS1/REKPAGESIZE

Maximum number of faces to return.

IV_USERID TYPE /AWS1/REKUSERID /AWS1/REKUSERID

An array of user IDs to filter results with when listing faces in a collection.

IT_FACEIDS TYPE /AWS1/CL_REKFACEIDLIST_W=>TT_FACEIDLIST TT_FACEIDLIST

An array of face IDs to filter results with when listing faces in a collection.

RETURNING

OO_OUTPUT TYPE REF TO /AWS1/CL_REKLISTFACESRESPONSE /AWS1/CL_REKLISTFACESRESPONSE