{-# LANGUAGE DeriveGeneric #-}
{-# LANGUAGE DuplicateRecordFields #-}
{-# LANGUAGE NamedFieldPuns #-}
{-# LANGUAGE OverloadedStrings #-}
{-# LANGUAGE RecordWildCards #-}
{-# LANGUAGE StrictData #-}
{-# LANGUAGE TypeFamilies #-}
{-# LANGUAGE NoImplicitPrelude #-}
{-# OPTIONS_GHC -fno-warn-unused-binds #-}
{-# OPTIONS_GHC -fno-warn-unused-imports #-}
{-# OPTIONS_GHC -fno-warn-unused-matches #-}

-- Derived from AWS service descriptions, licensed under Apache 2.0.

-- |
-- Module      : Amazonka.Rekognition.ListFaces
-- Copyright   : (c) 2013-2021 Brendan Hay
-- License     : Mozilla Public License, v. 2.0.
-- Maintainer  : Brendan Hay <brendan.g.hay+amazonka@gmail.com>
-- Stability   : auto-generated
-- Portability : non-portable (GHC extensions)
--
-- 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.
--
-- This operation returns paginated results.
module Amazonka.Rekognition.ListFaces
  ( -- * Creating a Request
    ListFaces (..),
    newListFaces,

    -- * Request Lenses
    listFaces_nextToken,
    listFaces_maxResults,
    listFaces_collectionId,

    -- * Destructuring the Response
    ListFacesResponse (..),
    newListFacesResponse,

    -- * Response Lenses
    listFacesResponse_faceModelVersion,
    listFacesResponse_nextToken,
    listFacesResponse_faces,
    listFacesResponse_httpStatus,
  )
where

import qualified Amazonka.Core as Core
import qualified Amazonka.Lens as Lens
import qualified Amazonka.Prelude as Prelude
import Amazonka.Rekognition.Types
import qualified Amazonka.Request as Request
import qualified Amazonka.Response as Response

-- | /See:/ 'newListFaces' smart constructor.
data ListFaces = ListFaces'
  { -- | 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.
    ListFaces -> Maybe Text
nextToken :: Prelude.Maybe Prelude.Text,
    -- | Maximum number of faces to return.
    ListFaces -> Maybe Natural
maxResults :: Prelude.Maybe Prelude.Natural,
    -- | ID of the collection from which to list the faces.
    ListFaces -> Text
collectionId :: Prelude.Text
  }
  deriving (ListFaces -> ListFaces -> Bool
(ListFaces -> ListFaces -> Bool)
-> (ListFaces -> ListFaces -> Bool) -> Eq ListFaces
forall a. (a -> a -> Bool) -> (a -> a -> Bool) -> Eq a
/= :: ListFaces -> ListFaces -> Bool
$c/= :: ListFaces -> ListFaces -> Bool
== :: ListFaces -> ListFaces -> Bool
$c== :: ListFaces -> ListFaces -> Bool
Prelude.Eq, ReadPrec [ListFaces]
ReadPrec ListFaces
Int -> ReadS ListFaces
ReadS [ListFaces]
(Int -> ReadS ListFaces)
-> ReadS [ListFaces]
-> ReadPrec ListFaces
-> ReadPrec [ListFaces]
-> Read ListFaces
forall a.
(Int -> ReadS a)
-> ReadS [a] -> ReadPrec a -> ReadPrec [a] -> Read a
readListPrec :: ReadPrec [ListFaces]
$creadListPrec :: ReadPrec [ListFaces]
readPrec :: ReadPrec ListFaces
$creadPrec :: ReadPrec ListFaces
readList :: ReadS [ListFaces]
$creadList :: ReadS [ListFaces]
readsPrec :: Int -> ReadS ListFaces
$creadsPrec :: Int -> ReadS ListFaces
Prelude.Read, Int -> ListFaces -> ShowS
[ListFaces] -> ShowS
ListFaces -> String
(Int -> ListFaces -> ShowS)
-> (ListFaces -> String)
-> ([ListFaces] -> ShowS)
-> Show ListFaces
forall a.
(Int -> a -> ShowS) -> (a -> String) -> ([a] -> ShowS) -> Show a
showList :: [ListFaces] -> ShowS
$cshowList :: [ListFaces] -> ShowS
show :: ListFaces -> String
$cshow :: ListFaces -> String
showsPrec :: Int -> ListFaces -> ShowS
$cshowsPrec :: Int -> ListFaces -> ShowS
Prelude.Show, (forall x. ListFaces -> Rep ListFaces x)
-> (forall x. Rep ListFaces x -> ListFaces) -> Generic ListFaces
forall x. Rep ListFaces x -> ListFaces
forall x. ListFaces -> Rep ListFaces x
forall a.
(forall x. a -> Rep a x) -> (forall x. Rep a x -> a) -> Generic a
$cto :: forall x. Rep ListFaces x -> ListFaces
$cfrom :: forall x. ListFaces -> Rep ListFaces x
Prelude.Generic)

-- |
-- Create a value of 'ListFaces' with all optional fields omitted.
--
-- Use <https://hackage.haskell.org/package/generic-lens generic-lens> or <https://hackage.haskell.org/package/optics optics> to modify other optional fields.
--
-- The following record fields are available, with the corresponding lenses provided
-- for backwards compatibility:
--
-- 'nextToken', 'listFaces_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', 'listFaces_maxResults' - Maximum number of faces to return.
--
-- 'collectionId', 'listFaces_collectionId' - ID of the collection from which to list the faces.
newListFaces ::
  -- | 'collectionId'
  Prelude.Text ->
  ListFaces
newListFaces :: Text -> ListFaces
newListFaces Text
pCollectionId_ =
  ListFaces' :: Maybe Text -> Maybe Natural -> Text -> ListFaces
ListFaces'
    { $sel:nextToken:ListFaces' :: Maybe Text
nextToken = Maybe Text
forall a. Maybe a
Prelude.Nothing,
      $sel:maxResults:ListFaces' :: Maybe Natural
maxResults = Maybe Natural
forall a. Maybe a
Prelude.Nothing,
      $sel:collectionId:ListFaces' :: Text
collectionId = Text
pCollectionId_
    }

-- | 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.
listFaces_nextToken :: Lens.Lens' ListFaces (Prelude.Maybe Prelude.Text)
listFaces_nextToken :: (Maybe Text -> f (Maybe Text)) -> ListFaces -> f ListFaces
listFaces_nextToken = (ListFaces -> Maybe Text)
-> (ListFaces -> Maybe Text -> ListFaces)
-> Lens ListFaces ListFaces (Maybe Text) (Maybe Text)
forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\ListFaces' {Maybe Text
nextToken :: Maybe Text
$sel:nextToken:ListFaces' :: ListFaces -> Maybe Text
nextToken} -> Maybe Text
nextToken) (\s :: ListFaces
s@ListFaces' {} Maybe Text
a -> ListFaces
s {$sel:nextToken:ListFaces' :: Maybe Text
nextToken = Maybe Text
a} :: ListFaces)

-- | Maximum number of faces to return.
listFaces_maxResults :: Lens.Lens' ListFaces (Prelude.Maybe Prelude.Natural)
listFaces_maxResults :: (Maybe Natural -> f (Maybe Natural)) -> ListFaces -> f ListFaces
listFaces_maxResults = (ListFaces -> Maybe Natural)
-> (ListFaces -> Maybe Natural -> ListFaces)
-> Lens ListFaces ListFaces (Maybe Natural) (Maybe Natural)
forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\ListFaces' {Maybe Natural
maxResults :: Maybe Natural
$sel:maxResults:ListFaces' :: ListFaces -> Maybe Natural
maxResults} -> Maybe Natural
maxResults) (\s :: ListFaces
s@ListFaces' {} Maybe Natural
a -> ListFaces
s {$sel:maxResults:ListFaces' :: Maybe Natural
maxResults = Maybe Natural
a} :: ListFaces)

-- | ID of the collection from which to list the faces.
listFaces_collectionId :: Lens.Lens' ListFaces Prelude.Text
listFaces_collectionId :: (Text -> f Text) -> ListFaces -> f ListFaces
listFaces_collectionId = (ListFaces -> Text)
-> (ListFaces -> Text -> ListFaces)
-> Lens ListFaces ListFaces Text Text
forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\ListFaces' {Text
collectionId :: Text
$sel:collectionId:ListFaces' :: ListFaces -> Text
collectionId} -> Text
collectionId) (\s :: ListFaces
s@ListFaces' {} Text
a -> ListFaces
s {$sel:collectionId:ListFaces' :: Text
collectionId = Text
a} :: ListFaces)

instance Core.AWSPager ListFaces where
  page :: ListFaces -> AWSResponse ListFaces -> Maybe ListFaces
page ListFaces
rq AWSResponse ListFaces
rs
    | Maybe Text -> Bool
forall a. AWSTruncated a => a -> Bool
Core.stop
        ( AWSResponse ListFaces
ListFacesResponse
rs
            ListFacesResponse
-> Getting (First Text) ListFacesResponse Text -> Maybe Text
forall s a. s -> Getting (First a) s a -> Maybe a
Lens.^? (Maybe Text -> Const (First Text) (Maybe Text))
-> ListFacesResponse -> Const (First Text) ListFacesResponse
Lens' ListFacesResponse (Maybe Text)
listFacesResponse_nextToken ((Maybe Text -> Const (First Text) (Maybe Text))
 -> ListFacesResponse -> Const (First Text) ListFacesResponse)
-> ((Text -> Const (First Text) Text)
    -> Maybe Text -> Const (First Text) (Maybe Text))
-> Getting (First Text) ListFacesResponse Text
forall b c a. (b -> c) -> (a -> b) -> a -> c
Prelude.. (Text -> Const (First Text) Text)
-> Maybe Text -> Const (First Text) (Maybe Text)
forall a b. Prism (Maybe a) (Maybe b) a b
Lens._Just
        ) =
      Maybe ListFaces
forall a. Maybe a
Prelude.Nothing
    | Maybe [Face] -> Bool
forall a. AWSTruncated a => a -> Bool
Core.stop
        ( AWSResponse ListFaces
ListFacesResponse
rs
            ListFacesResponse
-> Getting (First [Face]) ListFacesResponse [Face] -> Maybe [Face]
forall s a. s -> Getting (First a) s a -> Maybe a
Lens.^? (Maybe [Face] -> Const (First [Face]) (Maybe [Face]))
-> ListFacesResponse -> Const (First [Face]) ListFacesResponse
Lens' ListFacesResponse (Maybe [Face])
listFacesResponse_faces ((Maybe [Face] -> Const (First [Face]) (Maybe [Face]))
 -> ListFacesResponse -> Const (First [Face]) ListFacesResponse)
-> (([Face] -> Const (First [Face]) [Face])
    -> Maybe [Face] -> Const (First [Face]) (Maybe [Face]))
-> Getting (First [Face]) ListFacesResponse [Face]
forall b c a. (b -> c) -> (a -> b) -> a -> c
Prelude.. ([Face] -> Const (First [Face]) [Face])
-> Maybe [Face] -> Const (First [Face]) (Maybe [Face])
forall a b. Prism (Maybe a) (Maybe b) a b
Lens._Just
        ) =
      Maybe ListFaces
forall a. Maybe a
Prelude.Nothing
    | Bool
Prelude.otherwise =
      ListFaces -> Maybe ListFaces
forall a. a -> Maybe a
Prelude.Just (ListFaces -> Maybe ListFaces) -> ListFaces -> Maybe ListFaces
forall a b. (a -> b) -> a -> b
Prelude.$
        ListFaces
rq
          ListFaces -> (ListFaces -> ListFaces) -> ListFaces
forall a b. a -> (a -> b) -> b
Prelude.& (Maybe Text -> Identity (Maybe Text))
-> ListFaces -> Identity ListFaces
Lens ListFaces ListFaces (Maybe Text) (Maybe Text)
listFaces_nextToken
          ((Maybe Text -> Identity (Maybe Text))
 -> ListFaces -> Identity ListFaces)
-> Maybe Text -> ListFaces -> ListFaces
forall s t a b. ASetter s t a b -> b -> s -> t
Lens..~ AWSResponse ListFaces
ListFacesResponse
rs
          ListFacesResponse
-> Getting (First Text) ListFacesResponse Text -> Maybe Text
forall s a. s -> Getting (First a) s a -> Maybe a
Lens.^? (Maybe Text -> Const (First Text) (Maybe Text))
-> ListFacesResponse -> Const (First Text) ListFacesResponse
Lens' ListFacesResponse (Maybe Text)
listFacesResponse_nextToken ((Maybe Text -> Const (First Text) (Maybe Text))
 -> ListFacesResponse -> Const (First Text) ListFacesResponse)
-> ((Text -> Const (First Text) Text)
    -> Maybe Text -> Const (First Text) (Maybe Text))
-> Getting (First Text) ListFacesResponse Text
forall b c a. (b -> c) -> (a -> b) -> a -> c
Prelude.. (Text -> Const (First Text) Text)
-> Maybe Text -> Const (First Text) (Maybe Text)
forall a b. Prism (Maybe a) (Maybe b) a b
Lens._Just

instance Core.AWSRequest ListFaces where
  type AWSResponse ListFaces = ListFacesResponse
  request :: ListFaces -> Request ListFaces
request = Service -> ListFaces -> Request ListFaces
forall a. (ToRequest a, ToJSON a) => Service -> a -> Request a
Request.postJSON Service
defaultService
  response :: Logger
-> Service
-> Proxy ListFaces
-> ClientResponse ClientBody
-> m (Either Error (ClientResponse (AWSResponse ListFaces)))
response =
    (Int
 -> ResponseHeaders
 -> Object
 -> Either String (AWSResponse ListFaces))
-> Logger
-> Service
-> Proxy ListFaces
-> ClientResponse ClientBody
-> m (Either Error (ClientResponse (AWSResponse ListFaces)))
forall (m :: * -> *) a.
MonadResource m =>
(Int -> ResponseHeaders -> Object -> Either String (AWSResponse a))
-> Logger
-> Service
-> Proxy a
-> ClientResponse ClientBody
-> m (Either Error (ClientResponse (AWSResponse a)))
Response.receiveJSON
      ( \Int
s ResponseHeaders
h Object
x ->
          Maybe Text
-> Maybe Text -> Maybe [Face] -> Int -> ListFacesResponse
ListFacesResponse'
            (Maybe Text
 -> Maybe Text -> Maybe [Face] -> Int -> ListFacesResponse)
-> Either String (Maybe Text)
-> Either
     String (Maybe Text -> Maybe [Face] -> Int -> ListFacesResponse)
forall (f :: * -> *) a b. Functor f => (a -> b) -> f a -> f b
Prelude.<$> (Object
x Object -> Text -> Either String (Maybe Text)
forall a. FromJSON a => Object -> Text -> Either String (Maybe a)
Core..?> Text
"FaceModelVersion")
            Either
  String (Maybe Text -> Maybe [Face] -> Int -> ListFacesResponse)
-> Either String (Maybe Text)
-> Either String (Maybe [Face] -> Int -> ListFacesResponse)
forall (f :: * -> *) a b. Applicative f => f (a -> b) -> f a -> f b
Prelude.<*> (Object
x Object -> Text -> Either String (Maybe Text)
forall a. FromJSON a => Object -> Text -> Either String (Maybe a)
Core..?> Text
"NextToken")
            Either String (Maybe [Face] -> Int -> ListFacesResponse)
-> Either String (Maybe [Face])
-> Either String (Int -> ListFacesResponse)
forall (f :: * -> *) a b. Applicative f => f (a -> b) -> f a -> f b
Prelude.<*> (Object
x Object -> Text -> Either String (Maybe (Maybe [Face]))
forall a. FromJSON a => Object -> Text -> Either String (Maybe a)
Core..?> Text
"Faces" Either String (Maybe (Maybe [Face]))
-> Maybe [Face] -> Either String (Maybe [Face])
forall (f :: * -> *) a. Functor f => f (Maybe a) -> a -> f a
Core..!@ Maybe [Face]
forall a. Monoid a => a
Prelude.mempty)
            Either String (Int -> ListFacesResponse)
-> Either String Int -> Either String ListFacesResponse
forall (f :: * -> *) a b. Applicative f => f (a -> b) -> f a -> f b
Prelude.<*> (Int -> Either String Int
forall (f :: * -> *) a. Applicative f => a -> f a
Prelude.pure (Int -> Int
forall a. Enum a => a -> Int
Prelude.fromEnum Int
s))
      )

instance Prelude.Hashable ListFaces

instance Prelude.NFData ListFaces

instance Core.ToHeaders ListFaces where
  toHeaders :: ListFaces -> ResponseHeaders
toHeaders =
    ResponseHeaders -> ListFaces -> ResponseHeaders
forall a b. a -> b -> a
Prelude.const
      ( [ResponseHeaders] -> ResponseHeaders
forall a. Monoid a => [a] -> a
Prelude.mconcat
          [ HeaderName
"X-Amz-Target"
              HeaderName -> ByteString -> ResponseHeaders
forall a. ToHeader a => HeaderName -> a -> ResponseHeaders
Core.=# ( ByteString
"RekognitionService.ListFaces" ::
                          Prelude.ByteString
                      ),
            HeaderName
"Content-Type"
              HeaderName -> ByteString -> ResponseHeaders
forall a. ToHeader a => HeaderName -> a -> ResponseHeaders
Core.=# ( ByteString
"application/x-amz-json-1.1" ::
                          Prelude.ByteString
                      )
          ]
      )

instance Core.ToJSON ListFaces where
  toJSON :: ListFaces -> Value
toJSON ListFaces' {Maybe Natural
Maybe Text
Text
collectionId :: Text
maxResults :: Maybe Natural
nextToken :: Maybe Text
$sel:collectionId:ListFaces' :: ListFaces -> Text
$sel:maxResults:ListFaces' :: ListFaces -> Maybe Natural
$sel:nextToken:ListFaces' :: ListFaces -> Maybe Text
..} =
    [Pair] -> Value
Core.object
      ( [Maybe Pair] -> [Pair]
forall a. [Maybe a] -> [a]
Prelude.catMaybes
          [ (Text
"NextToken" Text -> Text -> Pair
forall kv v. (KeyValue kv, ToJSON v) => Text -> v -> kv
Core..=) (Text -> Pair) -> Maybe Text -> Maybe Pair
forall (f :: * -> *) a b. Functor f => (a -> b) -> f a -> f b
Prelude.<$> Maybe Text
nextToken,
            (Text
"MaxResults" Text -> Natural -> Pair
forall kv v. (KeyValue kv, ToJSON v) => Text -> v -> kv
Core..=) (Natural -> Pair) -> Maybe Natural -> Maybe Pair
forall (f :: * -> *) a b. Functor f => (a -> b) -> f a -> f b
Prelude.<$> Maybe Natural
maxResults,
            Pair -> Maybe Pair
forall a. a -> Maybe a
Prelude.Just (Text
"CollectionId" Text -> Text -> Pair
forall kv v. (KeyValue kv, ToJSON v) => Text -> v -> kv
Core..= Text
collectionId)
          ]
      )

instance Core.ToPath ListFaces where
  toPath :: ListFaces -> ByteString
toPath = ByteString -> ListFaces -> ByteString
forall a b. a -> b -> a
Prelude.const ByteString
"/"

instance Core.ToQuery ListFaces where
  toQuery :: ListFaces -> QueryString
toQuery = QueryString -> ListFaces -> QueryString
forall a b. a -> b -> a
Prelude.const QueryString
forall a. Monoid a => a
Prelude.mempty

-- | /See:/ 'newListFacesResponse' smart constructor.
data ListFacesResponse = ListFacesResponse'
  { -- | Version number of the face detection model associated with the input
    -- collection (@CollectionId@).
    ListFacesResponse -> Maybe Text
faceModelVersion :: Prelude.Maybe Prelude.Text,
    -- | If the response is truncated, Amazon Rekognition returns this token that
    -- you can use in the subsequent request to retrieve the next set of faces.
    ListFacesResponse -> Maybe Text
nextToken :: Prelude.Maybe Prelude.Text,
    -- | An array of @Face@ objects.
    ListFacesResponse -> Maybe [Face]
faces :: Prelude.Maybe [Face],
    -- | The response's http status code.
    ListFacesResponse -> Int
httpStatus :: Prelude.Int
  }
  deriving (ListFacesResponse -> ListFacesResponse -> Bool
(ListFacesResponse -> ListFacesResponse -> Bool)
-> (ListFacesResponse -> ListFacesResponse -> Bool)
-> Eq ListFacesResponse
forall a. (a -> a -> Bool) -> (a -> a -> Bool) -> Eq a
/= :: ListFacesResponse -> ListFacesResponse -> Bool
$c/= :: ListFacesResponse -> ListFacesResponse -> Bool
== :: ListFacesResponse -> ListFacesResponse -> Bool
$c== :: ListFacesResponse -> ListFacesResponse -> Bool
Prelude.Eq, ReadPrec [ListFacesResponse]
ReadPrec ListFacesResponse
Int -> ReadS ListFacesResponse
ReadS [ListFacesResponse]
(Int -> ReadS ListFacesResponse)
-> ReadS [ListFacesResponse]
-> ReadPrec ListFacesResponse
-> ReadPrec [ListFacesResponse]
-> Read ListFacesResponse
forall a.
(Int -> ReadS a)
-> ReadS [a] -> ReadPrec a -> ReadPrec [a] -> Read a
readListPrec :: ReadPrec [ListFacesResponse]
$creadListPrec :: ReadPrec [ListFacesResponse]
readPrec :: ReadPrec ListFacesResponse
$creadPrec :: ReadPrec ListFacesResponse
readList :: ReadS [ListFacesResponse]
$creadList :: ReadS [ListFacesResponse]
readsPrec :: Int -> ReadS ListFacesResponse
$creadsPrec :: Int -> ReadS ListFacesResponse
Prelude.Read, Int -> ListFacesResponse -> ShowS
[ListFacesResponse] -> ShowS
ListFacesResponse -> String
(Int -> ListFacesResponse -> ShowS)
-> (ListFacesResponse -> String)
-> ([ListFacesResponse] -> ShowS)
-> Show ListFacesResponse
forall a.
(Int -> a -> ShowS) -> (a -> String) -> ([a] -> ShowS) -> Show a
showList :: [ListFacesResponse] -> ShowS
$cshowList :: [ListFacesResponse] -> ShowS
show :: ListFacesResponse -> String
$cshow :: ListFacesResponse -> String
showsPrec :: Int -> ListFacesResponse -> ShowS
$cshowsPrec :: Int -> ListFacesResponse -> ShowS
Prelude.Show, (forall x. ListFacesResponse -> Rep ListFacesResponse x)
-> (forall x. Rep ListFacesResponse x -> ListFacesResponse)
-> Generic ListFacesResponse
forall x. Rep ListFacesResponse x -> ListFacesResponse
forall x. ListFacesResponse -> Rep ListFacesResponse x
forall a.
(forall x. a -> Rep a x) -> (forall x. Rep a x -> a) -> Generic a
$cto :: forall x. Rep ListFacesResponse x -> ListFacesResponse
$cfrom :: forall x. ListFacesResponse -> Rep ListFacesResponse x
Prelude.Generic)

-- |
-- Create a value of 'ListFacesResponse' with all optional fields omitted.
--
-- Use <https://hackage.haskell.org/package/generic-lens generic-lens> or <https://hackage.haskell.org/package/optics optics> to modify other optional fields.
--
-- The following record fields are available, with the corresponding lenses provided
-- for backwards compatibility:
--
-- 'faceModelVersion', 'listFacesResponse_faceModelVersion' - Version number of the face detection model associated with the input
-- collection (@CollectionId@).
--
-- 'nextToken', 'listFacesResponse_nextToken' - If the response is truncated, Amazon Rekognition returns this token that
-- you can use in the subsequent request to retrieve the next set of faces.
--
-- 'faces', 'listFacesResponse_faces' - An array of @Face@ objects.
--
-- 'httpStatus', 'listFacesResponse_httpStatus' - The response's http status code.
newListFacesResponse ::
  -- | 'httpStatus'
  Prelude.Int ->
  ListFacesResponse
newListFacesResponse :: Int -> ListFacesResponse
newListFacesResponse Int
pHttpStatus_ =
  ListFacesResponse' :: Maybe Text
-> Maybe Text -> Maybe [Face] -> Int -> ListFacesResponse
ListFacesResponse'
    { $sel:faceModelVersion:ListFacesResponse' :: Maybe Text
faceModelVersion =
        Maybe Text
forall a. Maybe a
Prelude.Nothing,
      $sel:nextToken:ListFacesResponse' :: Maybe Text
nextToken = Maybe Text
forall a. Maybe a
Prelude.Nothing,
      $sel:faces:ListFacesResponse' :: Maybe [Face]
faces = Maybe [Face]
forall a. Maybe a
Prelude.Nothing,
      $sel:httpStatus:ListFacesResponse' :: Int
httpStatus = Int
pHttpStatus_
    }

-- | Version number of the face detection model associated with the input
-- collection (@CollectionId@).
listFacesResponse_faceModelVersion :: Lens.Lens' ListFacesResponse (Prelude.Maybe Prelude.Text)
listFacesResponse_faceModelVersion :: (Maybe Text -> f (Maybe Text))
-> ListFacesResponse -> f ListFacesResponse
listFacesResponse_faceModelVersion = (ListFacesResponse -> Maybe Text)
-> (ListFacesResponse -> Maybe Text -> ListFacesResponse)
-> Lens' ListFacesResponse (Maybe Text)
forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\ListFacesResponse' {Maybe Text
faceModelVersion :: Maybe Text
$sel:faceModelVersion:ListFacesResponse' :: ListFacesResponse -> Maybe Text
faceModelVersion} -> Maybe Text
faceModelVersion) (\s :: ListFacesResponse
s@ListFacesResponse' {} Maybe Text
a -> ListFacesResponse
s {$sel:faceModelVersion:ListFacesResponse' :: Maybe Text
faceModelVersion = Maybe Text
a} :: ListFacesResponse)

-- | If the response is truncated, Amazon Rekognition returns this token that
-- you can use in the subsequent request to retrieve the next set of faces.
listFacesResponse_nextToken :: Lens.Lens' ListFacesResponse (Prelude.Maybe Prelude.Text)
listFacesResponse_nextToken :: (Maybe Text -> f (Maybe Text))
-> ListFacesResponse -> f ListFacesResponse
listFacesResponse_nextToken = (ListFacesResponse -> Maybe Text)
-> (ListFacesResponse -> Maybe Text -> ListFacesResponse)
-> Lens' ListFacesResponse (Maybe Text)
forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\ListFacesResponse' {Maybe Text
nextToken :: Maybe Text
$sel:nextToken:ListFacesResponse' :: ListFacesResponse -> Maybe Text
nextToken} -> Maybe Text
nextToken) (\s :: ListFacesResponse
s@ListFacesResponse' {} Maybe Text
a -> ListFacesResponse
s {$sel:nextToken:ListFacesResponse' :: Maybe Text
nextToken = Maybe Text
a} :: ListFacesResponse)

-- | An array of @Face@ objects.
listFacesResponse_faces :: Lens.Lens' ListFacesResponse (Prelude.Maybe [Face])
listFacesResponse_faces :: (Maybe [Face] -> f (Maybe [Face]))
-> ListFacesResponse -> f ListFacesResponse
listFacesResponse_faces = (ListFacesResponse -> Maybe [Face])
-> (ListFacesResponse -> Maybe [Face] -> ListFacesResponse)
-> Lens' ListFacesResponse (Maybe [Face])
forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\ListFacesResponse' {Maybe [Face]
faces :: Maybe [Face]
$sel:faces:ListFacesResponse' :: ListFacesResponse -> Maybe [Face]
faces} -> Maybe [Face]
faces) (\s :: ListFacesResponse
s@ListFacesResponse' {} Maybe [Face]
a -> ListFacesResponse
s {$sel:faces:ListFacesResponse' :: Maybe [Face]
faces = Maybe [Face]
a} :: ListFacesResponse) ((Maybe [Face] -> f (Maybe [Face]))
 -> ListFacesResponse -> f ListFacesResponse)
-> ((Maybe [Face] -> f (Maybe [Face]))
    -> Maybe [Face] -> f (Maybe [Face]))
-> (Maybe [Face] -> f (Maybe [Face]))
-> ListFacesResponse
-> f ListFacesResponse
forall b c a. (b -> c) -> (a -> b) -> a -> c
Prelude.. AnIso [Face] [Face] [Face] [Face]
-> Iso (Maybe [Face]) (Maybe [Face]) (Maybe [Face]) (Maybe [Face])
forall (f :: * -> *) (g :: * -> *) s t a b.
(Functor f, Functor g) =>
AnIso s t a b -> Iso (f s) (g t) (f a) (g b)
Lens.mapping AnIso [Face] [Face] [Face] [Face]
forall s t a b. (Coercible s a, Coercible t b) => Iso s t a b
Lens.coerced

-- | The response's http status code.
listFacesResponse_httpStatus :: Lens.Lens' ListFacesResponse Prelude.Int
listFacesResponse_httpStatus :: (Int -> f Int) -> ListFacesResponse -> f ListFacesResponse
listFacesResponse_httpStatus = (ListFacesResponse -> Int)
-> (ListFacesResponse -> Int -> ListFacesResponse)
-> Lens ListFacesResponse ListFacesResponse Int Int
forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\ListFacesResponse' {Int
httpStatus :: Int
$sel:httpStatus:ListFacesResponse' :: ListFacesResponse -> Int
httpStatus} -> Int
httpStatus) (\s :: ListFacesResponse
s@ListFacesResponse' {} Int
a -> ListFacesResponse
s {$sel:httpStatus:ListFacesResponse' :: Int
httpStatus = Int
a} :: ListFacesResponse)

instance Prelude.NFData ListFacesResponse