{-# 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.OpenSearch.GetUpgradeHistory -- Copyright : (c) 2013-2023 Brendan Hay -- License : Mozilla Public License, v. 2.0. -- Maintainer : Brendan Hay -- Stability : auto-generated -- Portability : non-portable (GHC extensions) -- -- Retrieves the complete history of the last 10 upgrades performed on an -- Amazon OpenSearch Service domain. module Amazonka.OpenSearch.GetUpgradeHistory ( -- * Creating a Request GetUpgradeHistory (..), newGetUpgradeHistory, -- * Request Lenses getUpgradeHistory_maxResults, getUpgradeHistory_nextToken, getUpgradeHistory_domainName, -- * Destructuring the Response GetUpgradeHistoryResponse (..), newGetUpgradeHistoryResponse, -- * Response Lenses getUpgradeHistoryResponse_nextToken, getUpgradeHistoryResponse_upgradeHistories, getUpgradeHistoryResponse_httpStatus, ) where import qualified Amazonka.Core as Core import qualified Amazonka.Core.Lens.Internal as Lens import qualified Amazonka.Data as Data import Amazonka.OpenSearch.Types import qualified Amazonka.Prelude as Prelude import qualified Amazonka.Request as Request import qualified Amazonka.Response as Response -- | Container for the request parameters to the @GetUpgradeHistory@ -- operation. -- -- /See:/ 'newGetUpgradeHistory' smart constructor. data GetUpgradeHistory = GetUpgradeHistory' { -- | An optional parameter that specifies the maximum number of results to -- return. You can use @nextToken@ to get the next page of results. maxResults :: Prelude.Maybe Prelude.Int, -- | If your initial @GetUpgradeHistory@ operation returns a @nextToken@, you -- can include the returned @nextToken@ in subsequent @GetUpgradeHistory@ -- operations, which returns results in the next page. nextToken :: Prelude.Maybe Prelude.Text, -- | The name of an existing domain. domainName :: Prelude.Text } deriving (Prelude.Eq, Prelude.Read, Prelude.Show, Prelude.Generic) -- | -- Create a value of 'GetUpgradeHistory' 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', 'getUpgradeHistory_maxResults' - An optional parameter that specifies the maximum number of results to -- return. You can use @nextToken@ to get the next page of results. -- -- 'nextToken', 'getUpgradeHistory_nextToken' - If your initial @GetUpgradeHistory@ operation returns a @nextToken@, you -- can include the returned @nextToken@ in subsequent @GetUpgradeHistory@ -- operations, which returns results in the next page. -- -- 'domainName', 'getUpgradeHistory_domainName' - The name of an existing domain. newGetUpgradeHistory :: -- | 'domainName' Prelude.Text -> GetUpgradeHistory newGetUpgradeHistory pDomainName_ = GetUpgradeHistory' { maxResults = Prelude.Nothing, nextToken = Prelude.Nothing, domainName = pDomainName_ } -- | An optional parameter that specifies the maximum number of results to -- return. You can use @nextToken@ to get the next page of results. getUpgradeHistory_maxResults :: Lens.Lens' GetUpgradeHistory (Prelude.Maybe Prelude.Int) getUpgradeHistory_maxResults = Lens.lens (\GetUpgradeHistory' {maxResults} -> maxResults) (\s@GetUpgradeHistory' {} a -> s {maxResults = a} :: GetUpgradeHistory) -- | If your initial @GetUpgradeHistory@ operation returns a @nextToken@, you -- can include the returned @nextToken@ in subsequent @GetUpgradeHistory@ -- operations, which returns results in the next page. getUpgradeHistory_nextToken :: Lens.Lens' GetUpgradeHistory (Prelude.Maybe Prelude.Text) getUpgradeHistory_nextToken = Lens.lens (\GetUpgradeHistory' {nextToken} -> nextToken) (\s@GetUpgradeHistory' {} a -> s {nextToken = a} :: GetUpgradeHistory) -- | The name of an existing domain. getUpgradeHistory_domainName :: Lens.Lens' GetUpgradeHistory Prelude.Text getUpgradeHistory_domainName = Lens.lens (\GetUpgradeHistory' {domainName} -> domainName) (\s@GetUpgradeHistory' {} a -> s {domainName = a} :: GetUpgradeHistory) instance Core.AWSRequest GetUpgradeHistory where type AWSResponse GetUpgradeHistory = GetUpgradeHistoryResponse request overrides = Request.get (overrides defaultService) response = Response.receiveJSON ( \s h x -> GetUpgradeHistoryResponse' Prelude.<$> (x Data..?> "NextToken") Prelude.<*> ( x Data..?> "UpgradeHistories" Core..!@ Prelude.mempty ) Prelude.<*> (Prelude.pure (Prelude.fromEnum s)) ) instance Prelude.Hashable GetUpgradeHistory where hashWithSalt _salt GetUpgradeHistory' {..} = _salt `Prelude.hashWithSalt` maxResults `Prelude.hashWithSalt` nextToken `Prelude.hashWithSalt` domainName instance Prelude.NFData GetUpgradeHistory where rnf GetUpgradeHistory' {..} = Prelude.rnf maxResults `Prelude.seq` Prelude.rnf nextToken `Prelude.seq` Prelude.rnf domainName instance Data.ToHeaders GetUpgradeHistory where toHeaders = Prelude.const Prelude.mempty instance Data.ToPath GetUpgradeHistory where toPath GetUpgradeHistory' {..} = Prelude.mconcat [ "/2021-01-01/opensearch/upgradeDomain/", Data.toBS domainName, "/history" ] instance Data.ToQuery GetUpgradeHistory where toQuery GetUpgradeHistory' {..} = Prelude.mconcat [ "maxResults" Data.=: maxResults, "nextToken" Data.=: nextToken ] -- | Container for the response returned by the @GetUpgradeHistory@ -- operation. -- -- /See:/ 'newGetUpgradeHistoryResponse' smart constructor. data GetUpgradeHistoryResponse = GetUpgradeHistoryResponse' { -- | When @nextToken@ is returned, there are more results available. The -- value of @nextToken@ is a unique pagination token for each page. Make -- the call again using the returned token to retrieve the next page. nextToken :: Prelude.Maybe Prelude.Text, -- | A list of objects corresponding to each upgrade or upgrade eligibility -- check performed on a domain. upgradeHistories :: Prelude.Maybe [UpgradeHistory], -- | The response's http status code. httpStatus :: Prelude.Int } deriving (Prelude.Eq, Prelude.Read, Prelude.Show, Prelude.Generic) -- | -- Create a value of 'GetUpgradeHistoryResponse' 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: -- -- 'nextToken', 'getUpgradeHistoryResponse_nextToken' - When @nextToken@ is returned, there are more results available. The -- value of @nextToken@ is a unique pagination token for each page. Make -- the call again using the returned token to retrieve the next page. -- -- 'upgradeHistories', 'getUpgradeHistoryResponse_upgradeHistories' - A list of objects corresponding to each upgrade or upgrade eligibility -- check performed on a domain. -- -- 'httpStatus', 'getUpgradeHistoryResponse_httpStatus' - The response's http status code. newGetUpgradeHistoryResponse :: -- | 'httpStatus' Prelude.Int -> GetUpgradeHistoryResponse newGetUpgradeHistoryResponse pHttpStatus_ = GetUpgradeHistoryResponse' { nextToken = Prelude.Nothing, upgradeHistories = Prelude.Nothing, httpStatus = pHttpStatus_ } -- | When @nextToken@ is returned, there are more results available. The -- value of @nextToken@ is a unique pagination token for each page. Make -- the call again using the returned token to retrieve the next page. getUpgradeHistoryResponse_nextToken :: Lens.Lens' GetUpgradeHistoryResponse (Prelude.Maybe Prelude.Text) getUpgradeHistoryResponse_nextToken = Lens.lens (\GetUpgradeHistoryResponse' {nextToken} -> nextToken) (\s@GetUpgradeHistoryResponse' {} a -> s {nextToken = a} :: GetUpgradeHistoryResponse) -- | A list of objects corresponding to each upgrade or upgrade eligibility -- check performed on a domain. getUpgradeHistoryResponse_upgradeHistories :: Lens.Lens' GetUpgradeHistoryResponse (Prelude.Maybe [UpgradeHistory]) getUpgradeHistoryResponse_upgradeHistories = Lens.lens (\GetUpgradeHistoryResponse' {upgradeHistories} -> upgradeHistories) (\s@GetUpgradeHistoryResponse' {} a -> s {upgradeHistories = a} :: GetUpgradeHistoryResponse) Prelude.. Lens.mapping Lens.coerced -- | The response's http status code. getUpgradeHistoryResponse_httpStatus :: Lens.Lens' GetUpgradeHistoryResponse Prelude.Int getUpgradeHistoryResponse_httpStatus = Lens.lens (\GetUpgradeHistoryResponse' {httpStatus} -> httpStatus) (\s@GetUpgradeHistoryResponse' {} a -> s {httpStatus = a} :: GetUpgradeHistoryResponse) instance Prelude.NFData GetUpgradeHistoryResponse where rnf GetUpgradeHistoryResponse' {..} = Prelude.rnf nextToken `Prelude.seq` Prelude.rnf upgradeHistories `Prelude.seq` Prelude.rnf httpStatus