{-# 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.Config.GetComplianceDetailsByConfigRule -- 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 the evaluation results for the specified Config rule. The -- results indicate which Amazon Web Services resources were evaluated by -- the rule, when each resource was last evaluated, and whether each -- resource complies with the rule. -- -- This operation returns paginated results. module Amazonka.Config.GetComplianceDetailsByConfigRule ( -- * Creating a Request GetComplianceDetailsByConfigRule (..), newGetComplianceDetailsByConfigRule, -- * Request Lenses getComplianceDetailsByConfigRule_complianceTypes, getComplianceDetailsByConfigRule_limit, getComplianceDetailsByConfigRule_nextToken, getComplianceDetailsByConfigRule_configRuleName, -- * Destructuring the Response GetComplianceDetailsByConfigRuleResponse (..), newGetComplianceDetailsByConfigRuleResponse, -- * Response Lenses getComplianceDetailsByConfigRuleResponse_evaluationResults, getComplianceDetailsByConfigRuleResponse_nextToken, getComplianceDetailsByConfigRuleResponse_httpStatus, ) where import Amazonka.Config.Types 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 qualified Amazonka.Request as Request import qualified Amazonka.Response as Response -- | -- -- /See:/ 'newGetComplianceDetailsByConfigRule' smart constructor. data GetComplianceDetailsByConfigRule = GetComplianceDetailsByConfigRule' { -- | Filters the results by compliance. -- -- The allowed values are @COMPLIANT@, @NON_COMPLIANT@, and -- @NOT_APPLICABLE@. complianceTypes :: Prelude.Maybe [ComplianceType], -- | The maximum number of evaluation results returned on each page. The -- default is 10. You cannot specify a number greater than 100. If you -- specify 0, Config uses the default. limit :: Prelude.Maybe Prelude.Natural, -- | The @nextToken@ string returned on a previous page that you use to get -- the next page of results in a paginated response. nextToken :: Prelude.Maybe Prelude.Text, -- | The name of the Config rule for which you want compliance information. configRuleName :: Prelude.Text } deriving (Prelude.Eq, Prelude.Read, Prelude.Show, Prelude.Generic) -- | -- Create a value of 'GetComplianceDetailsByConfigRule' 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: -- -- 'complianceTypes', 'getComplianceDetailsByConfigRule_complianceTypes' - Filters the results by compliance. -- -- The allowed values are @COMPLIANT@, @NON_COMPLIANT@, and -- @NOT_APPLICABLE@. -- -- 'limit', 'getComplianceDetailsByConfigRule_limit' - The maximum number of evaluation results returned on each page. The -- default is 10. You cannot specify a number greater than 100. If you -- specify 0, Config uses the default. -- -- 'nextToken', 'getComplianceDetailsByConfigRule_nextToken' - The @nextToken@ string returned on a previous page that you use to get -- the next page of results in a paginated response. -- -- 'configRuleName', 'getComplianceDetailsByConfigRule_configRuleName' - The name of the Config rule for which you want compliance information. newGetComplianceDetailsByConfigRule :: -- | 'configRuleName' Prelude.Text -> GetComplianceDetailsByConfigRule newGetComplianceDetailsByConfigRule pConfigRuleName_ = GetComplianceDetailsByConfigRule' { complianceTypes = Prelude.Nothing, limit = Prelude.Nothing, nextToken = Prelude.Nothing, configRuleName = pConfigRuleName_ } -- | Filters the results by compliance. -- -- The allowed values are @COMPLIANT@, @NON_COMPLIANT@, and -- @NOT_APPLICABLE@. getComplianceDetailsByConfigRule_complianceTypes :: Lens.Lens' GetComplianceDetailsByConfigRule (Prelude.Maybe [ComplianceType]) getComplianceDetailsByConfigRule_complianceTypes = Lens.lens (\GetComplianceDetailsByConfigRule' {complianceTypes} -> complianceTypes) (\s@GetComplianceDetailsByConfigRule' {} a -> s {complianceTypes = a} :: GetComplianceDetailsByConfigRule) Prelude.. Lens.mapping Lens.coerced -- | The maximum number of evaluation results returned on each page. The -- default is 10. You cannot specify a number greater than 100. If you -- specify 0, Config uses the default. getComplianceDetailsByConfigRule_limit :: Lens.Lens' GetComplianceDetailsByConfigRule (Prelude.Maybe Prelude.Natural) getComplianceDetailsByConfigRule_limit = Lens.lens (\GetComplianceDetailsByConfigRule' {limit} -> limit) (\s@GetComplianceDetailsByConfigRule' {} a -> s {limit = a} :: GetComplianceDetailsByConfigRule) -- | The @nextToken@ string returned on a previous page that you use to get -- the next page of results in a paginated response. getComplianceDetailsByConfigRule_nextToken :: Lens.Lens' GetComplianceDetailsByConfigRule (Prelude.Maybe Prelude.Text) getComplianceDetailsByConfigRule_nextToken = Lens.lens (\GetComplianceDetailsByConfigRule' {nextToken} -> nextToken) (\s@GetComplianceDetailsByConfigRule' {} a -> s {nextToken = a} :: GetComplianceDetailsByConfigRule) -- | The name of the Config rule for which you want compliance information. getComplianceDetailsByConfigRule_configRuleName :: Lens.Lens' GetComplianceDetailsByConfigRule Prelude.Text getComplianceDetailsByConfigRule_configRuleName = Lens.lens (\GetComplianceDetailsByConfigRule' {configRuleName} -> configRuleName) (\s@GetComplianceDetailsByConfigRule' {} a -> s {configRuleName = a} :: GetComplianceDetailsByConfigRule) instance Core.AWSPager GetComplianceDetailsByConfigRule where page rq rs | Core.stop ( rs Lens.^? getComplianceDetailsByConfigRuleResponse_nextToken Prelude.. Lens._Just ) = Prelude.Nothing | Core.stop ( rs Lens.^? getComplianceDetailsByConfigRuleResponse_evaluationResults Prelude.. Lens._Just ) = Prelude.Nothing | Prelude.otherwise = Prelude.Just Prelude.$ rq Prelude.& getComplianceDetailsByConfigRule_nextToken Lens..~ rs Lens.^? getComplianceDetailsByConfigRuleResponse_nextToken Prelude.. Lens._Just instance Core.AWSRequest GetComplianceDetailsByConfigRule where type AWSResponse GetComplianceDetailsByConfigRule = GetComplianceDetailsByConfigRuleResponse request overrides = Request.postJSON (overrides defaultService) response = Response.receiveJSON ( \s h x -> GetComplianceDetailsByConfigRuleResponse' Prelude.<$> ( x Data..?> "EvaluationResults" Core..!@ Prelude.mempty ) Prelude.<*> (x Data..?> "NextToken") Prelude.<*> (Prelude.pure (Prelude.fromEnum s)) ) instance Prelude.Hashable GetComplianceDetailsByConfigRule where hashWithSalt _salt GetComplianceDetailsByConfigRule' {..} = _salt `Prelude.hashWithSalt` complianceTypes `Prelude.hashWithSalt` limit `Prelude.hashWithSalt` nextToken `Prelude.hashWithSalt` configRuleName instance Prelude.NFData GetComplianceDetailsByConfigRule where rnf GetComplianceDetailsByConfigRule' {..} = Prelude.rnf complianceTypes `Prelude.seq` Prelude.rnf limit `Prelude.seq` Prelude.rnf nextToken `Prelude.seq` Prelude.rnf configRuleName instance Data.ToHeaders GetComplianceDetailsByConfigRule where toHeaders = Prelude.const ( Prelude.mconcat [ "X-Amz-Target" Data.=# ( "StarlingDoveService.GetComplianceDetailsByConfigRule" :: Prelude.ByteString ), "Content-Type" Data.=# ( "application/x-amz-json-1.1" :: Prelude.ByteString ) ] ) instance Data.ToJSON GetComplianceDetailsByConfigRule where toJSON GetComplianceDetailsByConfigRule' {..} = Data.object ( Prelude.catMaybes [ ("ComplianceTypes" Data..=) Prelude.<$> complianceTypes, ("Limit" Data..=) Prelude.<$> limit, ("NextToken" Data..=) Prelude.<$> nextToken, Prelude.Just ("ConfigRuleName" Data..= configRuleName) ] ) instance Data.ToPath GetComplianceDetailsByConfigRule where toPath = Prelude.const "/" instance Data.ToQuery GetComplianceDetailsByConfigRule where toQuery = Prelude.const Prelude.mempty -- | -- -- /See:/ 'newGetComplianceDetailsByConfigRuleResponse' smart constructor. data GetComplianceDetailsByConfigRuleResponse = GetComplianceDetailsByConfigRuleResponse' { -- | Indicates whether the Amazon Web Services resource complies with the -- specified Config rule. evaluationResults :: Prelude.Maybe [EvaluationResult], -- | The string that you use in a subsequent request to get the next page of -- results in a paginated response. 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 'GetComplianceDetailsByConfigRuleResponse' 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: -- -- 'evaluationResults', 'getComplianceDetailsByConfigRuleResponse_evaluationResults' - Indicates whether the Amazon Web Services resource complies with the -- specified Config rule. -- -- 'nextToken', 'getComplianceDetailsByConfigRuleResponse_nextToken' - The string that you use in a subsequent request to get the next page of -- results in a paginated response. -- -- 'httpStatus', 'getComplianceDetailsByConfigRuleResponse_httpStatus' - The response's http status code. newGetComplianceDetailsByConfigRuleResponse :: -- | 'httpStatus' Prelude.Int -> GetComplianceDetailsByConfigRuleResponse newGetComplianceDetailsByConfigRuleResponse pHttpStatus_ = GetComplianceDetailsByConfigRuleResponse' { evaluationResults = Prelude.Nothing, nextToken = Prelude.Nothing, httpStatus = pHttpStatus_ } -- | Indicates whether the Amazon Web Services resource complies with the -- specified Config rule. getComplianceDetailsByConfigRuleResponse_evaluationResults :: Lens.Lens' GetComplianceDetailsByConfigRuleResponse (Prelude.Maybe [EvaluationResult]) getComplianceDetailsByConfigRuleResponse_evaluationResults = Lens.lens (\GetComplianceDetailsByConfigRuleResponse' {evaluationResults} -> evaluationResults) (\s@GetComplianceDetailsByConfigRuleResponse' {} a -> s {evaluationResults = a} :: GetComplianceDetailsByConfigRuleResponse) Prelude.. Lens.mapping Lens.coerced -- | The string that you use in a subsequent request to get the next page of -- results in a paginated response. getComplianceDetailsByConfigRuleResponse_nextToken :: Lens.Lens' GetComplianceDetailsByConfigRuleResponse (Prelude.Maybe Prelude.Text) getComplianceDetailsByConfigRuleResponse_nextToken = Lens.lens (\GetComplianceDetailsByConfigRuleResponse' {nextToken} -> nextToken) (\s@GetComplianceDetailsByConfigRuleResponse' {} a -> s {nextToken = a} :: GetComplianceDetailsByConfigRuleResponse) -- | The response's http status code. getComplianceDetailsByConfigRuleResponse_httpStatus :: Lens.Lens' GetComplianceDetailsByConfigRuleResponse Prelude.Int getComplianceDetailsByConfigRuleResponse_httpStatus = Lens.lens (\GetComplianceDetailsByConfigRuleResponse' {httpStatus} -> httpStatus) (\s@GetComplianceDetailsByConfigRuleResponse' {} a -> s {httpStatus = a} :: GetComplianceDetailsByConfigRuleResponse) instance Prelude.NFData GetComplianceDetailsByConfigRuleResponse where rnf GetComplianceDetailsByConfigRuleResponse' {..} = Prelude.rnf evaluationResults `Prelude.seq` Prelude.rnf nextToken `Prelude.seq` Prelude.rnf httpStatus