CmdID / aws / aws rekognition

aws rekognition list-faces

Returns metadata for faces in the specified collection. AWS CLI reference

1 example 5 options Its page in the AWS CLI reference

Examples

from aws-cli, each command read by CmdID

To list the faces in a collection

The following list-faces example lists the faces in the specified collection.

aws rekognition list-faces --collection-id MyCollectionIdentify

--collection-idID of the collection from which to list the faces.

Its output, shortened

{
    "FaceModelVersion": "3.0",
    "Faces": [
        {
            "BoundingBox": {
                "Width": 0.5216310024261475,
                "Top": 0.3256250023841858,
                "Left": 0.13394300639629364,
                "Height": 0.3918749988079071
            },
            "FaceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
            "ExternalImageId": "image1.jpg",
            "Confidence": 100.0,
            "ImageId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
        },
        {
            "BoundingBox": {
                "Width": 0.5074880123138428,
                "Top": 0.3774999976158142,
                "Left": 0.18302799761295319,
                "Height": 0.3812499940395355
            },
            "FaceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333",
            "ExternalImageId": "image2.jpg",
            "Confidence": 99.99930572509766,
            "ImageId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE44444"
        },
        {
            "BoundingBox": {
                "Width": 0.5574039816856384,
… 23 more lines

For more information, see Listing Faces in a Collection in the Amazon Rekognition Developer Guide.

Options

5 in the AWS CLI reference

--collection-idID of the collection from which to list the faces.

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

--max-resultsMaximum number of faces to return.

--next-tokenIf the previous response was incomplete (because there is more data to retrieve), Amazon Rekognition returns a pagination token in the response.

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