{-# 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.QLDB.ListLedgers -- Copyright : (c) 2013-2023 Brendan Hay -- License : Mozilla Public License, v. 2.0. -- Maintainer : Brendan Hay -- Stability : auto-generated -- Portability : non-portable (GHC extensions) -- -- Returns an array of ledger summaries that are associated with the -- current Amazon Web Services account and Region. -- -- This action returns a maximum of 100 items and is paginated so that you -- can retrieve all the items by calling @ListLedgers@ multiple times. module Amazonka.QLDB.ListLedgers ( -- * Creating a Request ListLedgers (..), newListLedgers, -- * Request Lenses listLedgers_maxResults, listLedgers_nextToken, -- * Destructuring the Response ListLedgersResponse (..), newListLedgersResponse, -- * Response Lenses listLedgersResponse_ledgers, listLedgersResponse_nextToken, listLedgersResponse_httpStatus, ) where import qualified Amazonka.Core as Core import qualified Amazonka.Core.Lens.Internal as Lens import qualified Amazonka.Data as Data import qualified Amazonka.Prelude as Prelude import Amazonka.QLDB.Types import qualified Amazonka.Request as Request import qualified Amazonka.Response as Response -- | /See:/ 'newListLedgers' smart constructor. data ListLedgers = ListLedgers' { -- | The maximum number of results to return in a single @ListLedgers@ -- request. (The actual number of results returned might be fewer.) maxResults :: Prelude.Maybe Prelude.Natural, -- | A pagination token, indicating that you want to retrieve the next page -- of results. If you received a value for @NextToken@ in the response from -- a previous @ListLedgers@ call, then you should use that value as input -- here. nextToken :: Prelude.Maybe Prelude.Text } deriving (Prelude.Eq, Prelude.Read, Prelude.Show, Prelude.Generic) -- | -- Create a value of 'ListLedgers' with all optional fields omitted. -- -- Use or to modify other optional fields. -- -- The following record fields are available, with the corresponding lenses provided -- for backwards compatibility: -- -- 'maxResults', 'listLedgers_maxResults' - The maximum number of results to return in a single @ListLedgers@ -- request. (The actual number of results returned might be fewer.) -- -- 'nextToken', 'listLedgers_nextToken' - A pagination token, indicating that you want to retrieve the next page -- of results. If you received a value for @NextToken@ in the response from -- a previous @ListLedgers@ call, then you should use that value as input -- here. newListLedgers :: ListLedgers newListLedgers = ListLedgers' { maxResults = Prelude.Nothing, nextToken = Prelude.Nothing } -- | The maximum number of results to return in a single @ListLedgers@ -- request. (The actual number of results returned might be fewer.) listLedgers_maxResults :: Lens.Lens' ListLedgers (Prelude.Maybe Prelude.Natural) listLedgers_maxResults = Lens.lens (\ListLedgers' {maxResults} -> maxResults) (\s@ListLedgers' {} a -> s {maxResults = a} :: ListLedgers) -- | A pagination token, indicating that you want to retrieve the next page -- of results. If you received a value for @NextToken@ in the response from -- a previous @ListLedgers@ call, then you should use that value as input -- here. listLedgers_nextToken :: Lens.Lens' ListLedgers (Prelude.Maybe Prelude.Text) listLedgers_nextToken = Lens.lens (\ListLedgers' {nextToken} -> nextToken) (\s@ListLedgers' {} a -> s {nextToken = a} :: ListLedgers) instance Core.AWSRequest ListLedgers where type AWSResponse ListLedgers = ListLedgersResponse request overrides = Request.get (overrides defaultService) response = Response.receiveJSON ( \s h x -> ListLedgersResponse' Prelude.<$> (x Data..?> "Ledgers" Core..!@ Prelude.mempty) Prelude.<*> (x Data..?> "NextToken") Prelude.<*> (Prelude.pure (Prelude.fromEnum s)) ) instance Prelude.Hashable ListLedgers where hashWithSalt _salt ListLedgers' {..} = _salt `Prelude.hashWithSalt` maxResults `Prelude.hashWithSalt` nextToken instance Prelude.NFData ListLedgers where rnf ListLedgers' {..} = Prelude.rnf maxResults `Prelude.seq` Prelude.rnf nextToken instance Data.ToHeaders ListLedgers where toHeaders = Prelude.const ( Prelude.mconcat [ "Content-Type" Data.=# ( "application/x-amz-json-1.0" :: Prelude.ByteString ) ] ) instance Data.ToPath ListLedgers where toPath = Prelude.const "/ledgers" instance Data.ToQuery ListLedgers where toQuery ListLedgers' {..} = Prelude.mconcat [ "max_results" Data.=: maxResults, "next_token" Data.=: nextToken ] -- | /See:/ 'newListLedgersResponse' smart constructor. data ListLedgersResponse = ListLedgersResponse' { -- | The array of ledger summaries that are associated with the current -- Amazon Web Services account and Region. ledgers :: Prelude.Maybe [LedgerSummary], -- | A pagination token, indicating whether there are more results available: -- -- - If @NextToken@ is empty, then the last page of results has been -- processed and there are no more results to be retrieved. -- -- - If @NextToken@ is /not/ empty, then there are more results -- available. To retrieve the next page of results, use the value of -- @NextToken@ in a subsequent @ListLedgers@ call. nextToken :: Prelude.Maybe Prelude.Text, -- | The response's http status code. httpStatus :: Prelude.Int } deriving (Prelude.Eq, Prelude.Read, Prelude.Show, Prelude.Generic) -- | -- Create a value of 'ListLedgersResponse' with all optional fields omitted. -- -- Use or to modify other optional fields. -- -- The following record fields are available, with the corresponding lenses provided -- for backwards compatibility: -- -- 'ledgers', 'listLedgersResponse_ledgers' - The array of ledger summaries that are associated with the current -- Amazon Web Services account and Region. -- -- 'nextToken', 'listLedgersResponse_nextToken' - A pagination token, indicating whether there are more results available: -- -- - If @NextToken@ is empty, then the last page of results has been -- processed and there are no more results to be retrieved. -- -- - If @NextToken@ is /not/ empty, then there are more results -- available. To retrieve the next page of results, use the value of -- @NextToken@ in a subsequent @ListLedgers@ call. -- -- 'httpStatus', 'listLedgersResponse_httpStatus' - The response's http status code. newListLedgersResponse :: -- | 'httpStatus' Prelude.Int -> ListLedgersResponse newListLedgersResponse pHttpStatus_ = ListLedgersResponse' { ledgers = Prelude.Nothing, nextToken = Prelude.Nothing, httpStatus = pHttpStatus_ } -- | The array of ledger summaries that are associated with the current -- Amazon Web Services account and Region. listLedgersResponse_ledgers :: Lens.Lens' ListLedgersResponse (Prelude.Maybe [LedgerSummary]) listLedgersResponse_ledgers = Lens.lens (\ListLedgersResponse' {ledgers} -> ledgers) (\s@ListLedgersResponse' {} a -> s {ledgers = a} :: ListLedgersResponse) Prelude.. Lens.mapping Lens.coerced -- | A pagination token, indicating whether there are more results available: -- -- - If @NextToken@ is empty, then the last page of results has been -- processed and there are no more results to be retrieved. -- -- - If @NextToken@ is /not/ empty, then there are more results -- available. To retrieve the next page of results, use the value of -- @NextToken@ in a subsequent @ListLedgers@ call. listLedgersResponse_nextToken :: Lens.Lens' ListLedgersResponse (Prelude.Maybe Prelude.Text) listLedgersResponse_nextToken = Lens.lens (\ListLedgersResponse' {nextToken} -> nextToken) (\s@ListLedgersResponse' {} a -> s {nextToken = a} :: ListLedgersResponse) -- | The response's http status code. listLedgersResponse_httpStatus :: Lens.Lens' ListLedgersResponse Prelude.Int listLedgersResponse_httpStatus = Lens.lens (\ListLedgersResponse' {httpStatus} -> httpStatus) (\s@ListLedgersResponse' {} a -> s {httpStatus = a} :: ListLedgersResponse) instance Prelude.NFData ListLedgersResponse where rnf ListLedgersResponse' {..} = Prelude.rnf ledgers `Prelude.seq` Prelude.rnf nextToken `Prelude.seq` Prelude.rnf httpStatus