{-# 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.GetAggregateComplianceDetailsByConfigRule -- 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 for a -- specific resource in a 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. -- -- The results can return an empty result page. But if you have a -- @nextToken@, the results are displayed on the next page. -- -- This operation returns paginated results. module Amazonka.Config.GetAggregateComplianceDetailsByConfigRule ( -- * Creating a Request GetAggregateComplianceDetailsByConfigRule (..), newGetAggregateComplianceDetailsByConfigRule, -- * Request Lenses getAggregateComplianceDetailsByConfigRule_complianceType, getAggregateComplianceDetailsByConfigRule_limit, getAggregateComplianceDetailsByConfigRule_nextToken, getAggregateComplianceDetailsByConfigRule_configurationAggregatorName, getAggregateComplianceDetailsByConfigRule_configRuleName, getAggregateComplianceDetailsByConfigRule_accountId, getAggregateComplianceDetailsByConfigRule_awsRegion, -- * Destructuring the Response GetAggregateComplianceDetailsByConfigRuleResponse (..), newGetAggregateComplianceDetailsByConfigRuleResponse, -- * Response Lenses getAggregateComplianceDetailsByConfigRuleResponse_aggregateEvaluationResults, getAggregateComplianceDetailsByConfigRuleResponse_nextToken, getAggregateComplianceDetailsByConfigRuleResponse_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:/ 'newGetAggregateComplianceDetailsByConfigRule' smart constructor. data GetAggregateComplianceDetailsByConfigRule = GetAggregateComplianceDetailsByConfigRule' { -- | The resource compliance status. -- -- For the @GetAggregateComplianceDetailsByConfigRuleRequest@ data type, -- Config supports only the @COMPLIANT@ and @NON_COMPLIANT@. Config does -- not support the @NOT_APPLICABLE@ and @INSUFFICIENT_DATA@ values. complianceType :: Prelude.Maybe ComplianceType, -- | The maximum number of evaluation results returned on each page. The -- default is 50. 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 configuration aggregator. configurationAggregatorName :: Prelude.Text, -- | The name of the Config rule for which you want compliance information. configRuleName :: Prelude.Text, -- | The 12-digit account ID of the source account. accountId :: Prelude.Text, -- | The source region from where the data is aggregated. awsRegion :: Prelude.Text } deriving (Prelude.Eq, Prelude.Read, Prelude.Show, Prelude.Generic) -- | -- Create a value of 'GetAggregateComplianceDetailsByConfigRule' 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: -- -- 'complianceType', 'getAggregateComplianceDetailsByConfigRule_complianceType' - The resource compliance status. -- -- For the @GetAggregateComplianceDetailsByConfigRuleRequest@ data type, -- Config supports only the @COMPLIANT@ and @NON_COMPLIANT@. Config does -- not support the @NOT_APPLICABLE@ and @INSUFFICIENT_DATA@ values. -- -- 'limit', 'getAggregateComplianceDetailsByConfigRule_limit' - The maximum number of evaluation results returned on each page. The -- default is 50. You cannot specify a number greater than 100. If you -- specify 0, Config uses the default. -- -- 'nextToken', 'getAggregateComplianceDetailsByConfigRule_nextToken' - The @nextToken@ string returned on a previous page that you use to get -- the next page of results in a paginated response. -- -- 'configurationAggregatorName', 'getAggregateComplianceDetailsByConfigRule_configurationAggregatorName' - The name of the configuration aggregator. -- -- 'configRuleName', 'getAggregateComplianceDetailsByConfigRule_configRuleName' - The name of the Config rule for which you want compliance information. -- -- 'accountId', 'getAggregateComplianceDetailsByConfigRule_accountId' - The 12-digit account ID of the source account. -- -- 'awsRegion', 'getAggregateComplianceDetailsByConfigRule_awsRegion' - The source region from where the data is aggregated. newGetAggregateComplianceDetailsByConfigRule :: -- | 'configurationAggregatorName' Prelude.Text -> -- | 'configRuleName' Prelude.Text -> -- | 'accountId' Prelude.Text -> -- | 'awsRegion' Prelude.Text -> GetAggregateComplianceDetailsByConfigRule newGetAggregateComplianceDetailsByConfigRule pConfigurationAggregatorName_ pConfigRuleName_ pAccountId_ pAwsRegion_ = GetAggregateComplianceDetailsByConfigRule' { complianceType = Prelude.Nothing, limit = Prelude.Nothing, nextToken = Prelude.Nothing, configurationAggregatorName = pConfigurationAggregatorName_, configRuleName = pConfigRuleName_, accountId = pAccountId_, awsRegion = pAwsRegion_ } -- | The resource compliance status. -- -- For the @GetAggregateComplianceDetailsByConfigRuleRequest@ data type, -- Config supports only the @COMPLIANT@ and @NON_COMPLIANT@. Config does -- not support the @NOT_APPLICABLE@ and @INSUFFICIENT_DATA@ values. getAggregateComplianceDetailsByConfigRule_complianceType :: Lens.Lens' GetAggregateComplianceDetailsByConfigRule (Prelude.Maybe ComplianceType) getAggregateComplianceDetailsByConfigRule_complianceType = Lens.lens (\GetAggregateComplianceDetailsByConfigRule' {complianceType} -> complianceType) (\s@GetAggregateComplianceDetailsByConfigRule' {} a -> s {complianceType = a} :: GetAggregateComplianceDetailsByConfigRule) -- | The maximum number of evaluation results returned on each page. The -- default is 50. You cannot specify a number greater than 100. If you -- specify 0, Config uses the default. getAggregateComplianceDetailsByConfigRule_limit :: Lens.Lens' GetAggregateComplianceDetailsByConfigRule (Prelude.Maybe Prelude.Natural) getAggregateComplianceDetailsByConfigRule_limit = Lens.lens (\GetAggregateComplianceDetailsByConfigRule' {limit} -> limit) (\s@GetAggregateComplianceDetailsByConfigRule' {} a -> s {limit = a} :: GetAggregateComplianceDetailsByConfigRule) -- | The @nextToken@ string returned on a previous page that you use to get -- the next page of results in a paginated response. getAggregateComplianceDetailsByConfigRule_nextToken :: Lens.Lens' GetAggregateComplianceDetailsByConfigRule (Prelude.Maybe Prelude.Text) getAggregateComplianceDetailsByConfigRule_nextToken = Lens.lens (\GetAggregateComplianceDetailsByConfigRule' {nextToken} -> nextToken) (\s@GetAggregateComplianceDetailsByConfigRule' {} a -> s {nextToken = a} :: GetAggregateComplianceDetailsByConfigRule) -- | The name of the configuration aggregator. getAggregateComplianceDetailsByConfigRule_configurationAggregatorName :: Lens.Lens' GetAggregateComplianceDetailsByConfigRule Prelude.Text getAggregateComplianceDetailsByConfigRule_configurationAggregatorName = Lens.lens (\GetAggregateComplianceDetailsByConfigRule' {configurationAggregatorName} -> configurationAggregatorName) (\s@GetAggregateComplianceDetailsByConfigRule' {} a -> s {configurationAggregatorName = a} :: GetAggregateComplianceDetailsByConfigRule) -- | The name of the Config rule for which you want compliance information. getAggregateComplianceDetailsByConfigRule_configRuleName :: Lens.Lens' GetAggregateComplianceDetailsByConfigRule Prelude.Text getAggregateComplianceDetailsByConfigRule_configRuleName = Lens.lens (\GetAggregateComplianceDetailsByConfigRule' {configRuleName} -> configRuleName) (\s@GetAggregateComplianceDetailsByConfigRule' {} a -> s {configRuleName = a} :: GetAggregateComplianceDetailsByConfigRule) -- | The 12-digit account ID of the source account. getAggregateComplianceDetailsByConfigRule_accountId :: Lens.Lens' GetAggregateComplianceDetailsByConfigRule Prelude.Text getAggregateComplianceDetailsByConfigRule_accountId = Lens.lens (\GetAggregateComplianceDetailsByConfigRule' {accountId} -> accountId) (\s@GetAggregateComplianceDetailsByConfigRule' {} a -> s {accountId = a} :: GetAggregateComplianceDetailsByConfigRule) -- | The source region from where the data is aggregated. getAggregateComplianceDetailsByConfigRule_awsRegion :: Lens.Lens' GetAggregateComplianceDetailsByConfigRule Prelude.Text getAggregateComplianceDetailsByConfigRule_awsRegion = Lens.lens (\GetAggregateComplianceDetailsByConfigRule' {awsRegion} -> awsRegion) (\s@GetAggregateComplianceDetailsByConfigRule' {} a -> s {awsRegion = a} :: GetAggregateComplianceDetailsByConfigRule) instance Core.AWSPager GetAggregateComplianceDetailsByConfigRule where page rq rs | Core.stop ( rs Lens.^? getAggregateComplianceDetailsByConfigRuleResponse_nextToken Prelude.. Lens._Just ) = Prelude.Nothing | Core.stop ( rs Lens.^? getAggregateComplianceDetailsByConfigRuleResponse_aggregateEvaluationResults Prelude.. Lens._Just ) = Prelude.Nothing | Prelude.otherwise = Prelude.Just Prelude.$ rq Prelude.& getAggregateComplianceDetailsByConfigRule_nextToken Lens..~ rs Lens.^? getAggregateComplianceDetailsByConfigRuleResponse_nextToken Prelude.. Lens._Just instance Core.AWSRequest GetAggregateComplianceDetailsByConfigRule where type AWSResponse GetAggregateComplianceDetailsByConfigRule = GetAggregateComplianceDetailsByConfigRuleResponse request overrides = Request.postJSON (overrides defaultService) response = Response.receiveJSON ( \s h x -> GetAggregateComplianceDetailsByConfigRuleResponse' Prelude.<$> ( x Data..?> "AggregateEvaluationResults" Core..!@ Prelude.mempty ) Prelude.<*> (x Data..?> "NextToken") Prelude.<*> (Prelude.pure (Prelude.fromEnum s)) ) instance Prelude.Hashable GetAggregateComplianceDetailsByConfigRule where hashWithSalt _salt GetAggregateComplianceDetailsByConfigRule' {..} = _salt `Prelude.hashWithSalt` complianceType `Prelude.hashWithSalt` limit `Prelude.hashWithSalt` nextToken `Prelude.hashWithSalt` configurationAggregatorName `Prelude.hashWithSalt` configRuleName `Prelude.hashWithSalt` accountId `Prelude.hashWithSalt` awsRegion instance Prelude.NFData GetAggregateComplianceDetailsByConfigRule where rnf GetAggregateComplianceDetailsByConfigRule' {..} = Prelude.rnf complianceType `Prelude.seq` Prelude.rnf limit `Prelude.seq` Prelude.rnf nextToken `Prelude.seq` Prelude.rnf configurationAggregatorName `Prelude.seq` Prelude.rnf configRuleName `Prelude.seq` Prelude.rnf accountId `Prelude.seq` Prelude.rnf awsRegion instance Data.ToHeaders GetAggregateComplianceDetailsByConfigRule where toHeaders = Prelude.const ( Prelude.mconcat [ "X-Amz-Target" Data.=# ( "StarlingDoveService.GetAggregateComplianceDetailsByConfigRule" :: Prelude.ByteString ), "Content-Type" Data.=# ( "application/x-amz-json-1.1" :: Prelude.ByteString ) ] ) instance Data.ToJSON GetAggregateComplianceDetailsByConfigRule where toJSON GetAggregateComplianceDetailsByConfigRule' {..} = Data.object ( Prelude.catMaybes [ ("ComplianceType" Data..=) Prelude.<$> complianceType, ("Limit" Data..=) Prelude.<$> limit, ("NextToken" Data..=) Prelude.<$> nextToken, Prelude.Just ( "ConfigurationAggregatorName" Data..= configurationAggregatorName ), Prelude.Just ("ConfigRuleName" Data..= configRuleName), Prelude.Just ("AccountId" Data..= accountId), Prelude.Just ("AwsRegion" Data..= awsRegion) ] ) instance Data.ToPath GetAggregateComplianceDetailsByConfigRule where toPath = Prelude.const "/" instance Data.ToQuery GetAggregateComplianceDetailsByConfigRule where toQuery = Prelude.const Prelude.mempty -- | /See:/ 'newGetAggregateComplianceDetailsByConfigRuleResponse' smart constructor. data GetAggregateComplianceDetailsByConfigRuleResponse = GetAggregateComplianceDetailsByConfigRuleResponse' { -- | Returns an AggregateEvaluationResults object. aggregateEvaluationResults :: Prelude.Maybe [AggregateEvaluationResult], -- | 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 response's http status code. httpStatus :: Prelude.Int } deriving (Prelude.Eq, Prelude.Read, Prelude.Show, Prelude.Generic) -- | -- Create a value of 'GetAggregateComplianceDetailsByConfigRuleResponse' 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: -- -- 'aggregateEvaluationResults', 'getAggregateComplianceDetailsByConfigRuleResponse_aggregateEvaluationResults' - Returns an AggregateEvaluationResults object. -- -- 'nextToken', 'getAggregateComplianceDetailsByConfigRuleResponse_nextToken' - The @nextToken@ string returned on a previous page that you use to get -- the next page of results in a paginated response. -- -- 'httpStatus', 'getAggregateComplianceDetailsByConfigRuleResponse_httpStatus' - The response's http status code. newGetAggregateComplianceDetailsByConfigRuleResponse :: -- | 'httpStatus' Prelude.Int -> GetAggregateComplianceDetailsByConfigRuleResponse newGetAggregateComplianceDetailsByConfigRuleResponse pHttpStatus_ = GetAggregateComplianceDetailsByConfigRuleResponse' { aggregateEvaluationResults = Prelude.Nothing, nextToken = Prelude.Nothing, httpStatus = pHttpStatus_ } -- | Returns an AggregateEvaluationResults object. getAggregateComplianceDetailsByConfigRuleResponse_aggregateEvaluationResults :: Lens.Lens' GetAggregateComplianceDetailsByConfigRuleResponse (Prelude.Maybe [AggregateEvaluationResult]) getAggregateComplianceDetailsByConfigRuleResponse_aggregateEvaluationResults = Lens.lens (\GetAggregateComplianceDetailsByConfigRuleResponse' {aggregateEvaluationResults} -> aggregateEvaluationResults) (\s@GetAggregateComplianceDetailsByConfigRuleResponse' {} a -> s {aggregateEvaluationResults = a} :: GetAggregateComplianceDetailsByConfigRuleResponse) Prelude.. Lens.mapping Lens.coerced -- | The @nextToken@ string returned on a previous page that you use to get -- the next page of results in a paginated response. getAggregateComplianceDetailsByConfigRuleResponse_nextToken :: Lens.Lens' GetAggregateComplianceDetailsByConfigRuleResponse (Prelude.Maybe Prelude.Text) getAggregateComplianceDetailsByConfigRuleResponse_nextToken = Lens.lens (\GetAggregateComplianceDetailsByConfigRuleResponse' {nextToken} -> nextToken) (\s@GetAggregateComplianceDetailsByConfigRuleResponse' {} a -> s {nextToken = a} :: GetAggregateComplianceDetailsByConfigRuleResponse) -- | The response's http status code. getAggregateComplianceDetailsByConfigRuleResponse_httpStatus :: Lens.Lens' GetAggregateComplianceDetailsByConfigRuleResponse Prelude.Int getAggregateComplianceDetailsByConfigRuleResponse_httpStatus = Lens.lens (\GetAggregateComplianceDetailsByConfigRuleResponse' {httpStatus} -> httpStatus) (\s@GetAggregateComplianceDetailsByConfigRuleResponse' {} a -> s {httpStatus = a} :: GetAggregateComplianceDetailsByConfigRuleResponse) instance Prelude.NFData GetAggregateComplianceDetailsByConfigRuleResponse where rnf GetAggregateComplianceDetailsByConfigRuleResponse' {..} = Prelude.rnf aggregateEvaluationResults `Prelude.seq` Prelude.rnf nextToken `Prelude.seq` Prelude.rnf httpStatus