{-# 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.IAM.GetPolicyVersion -- 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 information about the specified version of the specified -- managed policy, including the policy document. -- -- Policies returned by this operation are URL-encoded compliant with -- . You can use a URL -- decoding method to convert the policy back to plain JSON text. For -- example, if you use Java, you can use the @decode@ method of the -- @java.net.URLDecoder@ utility class in the Java SDK. Other languages and -- SDKs provide similar functionality. -- -- To list the available versions for a policy, use ListPolicyVersions. -- -- This operation retrieves information about managed policies. To retrieve -- information about an inline policy that is embedded in a user, group, or -- role, use GetUserPolicy, GetGroupPolicy, or GetRolePolicy. -- -- For more information about the types of policies, see -- -- in the /IAM User Guide/. -- -- For more information about managed policy versions, see -- -- in the /IAM User Guide/. module Amazonka.IAM.GetPolicyVersion ( -- * Creating a Request GetPolicyVersion (..), newGetPolicyVersion, -- * Request Lenses getPolicyVersion_policyArn, getPolicyVersion_versionId, -- * Destructuring the Response GetPolicyVersionResponse (..), newGetPolicyVersionResponse, -- * Response Lenses getPolicyVersionResponse_policyVersion, getPolicyVersionResponse_httpStatus, ) where import qualified Amazonka.Core as Core import qualified Amazonka.Core.Lens.Internal as Lens import qualified Amazonka.Data as Data import Amazonka.IAM.Types import qualified Amazonka.Prelude as Prelude import qualified Amazonka.Request as Request import qualified Amazonka.Response as Response -- | /See:/ 'newGetPolicyVersion' smart constructor. data GetPolicyVersion = GetPolicyVersion' { -- | The Amazon Resource Name (ARN) of the managed policy that you want -- information about. -- -- For more information about ARNs, see -- -- in the /Amazon Web Services General Reference/. policyArn :: Prelude.Text, -- | Identifies the policy version to retrieve. -- -- This parameter allows (through its -- ) a string of characters -- that consists of the lowercase letter \'v\' followed by one or two -- digits, and optionally followed by a period \'.\' and a string of -- letters and digits. versionId :: Prelude.Text } deriving (Prelude.Eq, Prelude.Read, Prelude.Show, Prelude.Generic) -- | -- Create a value of 'GetPolicyVersion' 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: -- -- 'policyArn', 'getPolicyVersion_policyArn' - The Amazon Resource Name (ARN) of the managed policy that you want -- information about. -- -- For more information about ARNs, see -- -- in the /Amazon Web Services General Reference/. -- -- 'versionId', 'getPolicyVersion_versionId' - Identifies the policy version to retrieve. -- -- This parameter allows (through its -- ) a string of characters -- that consists of the lowercase letter \'v\' followed by one or two -- digits, and optionally followed by a period \'.\' and a string of -- letters and digits. newGetPolicyVersion :: -- | 'policyArn' Prelude.Text -> -- | 'versionId' Prelude.Text -> GetPolicyVersion newGetPolicyVersion pPolicyArn_ pVersionId_ = GetPolicyVersion' { policyArn = pPolicyArn_, versionId = pVersionId_ } -- | The Amazon Resource Name (ARN) of the managed policy that you want -- information about. -- -- For more information about ARNs, see -- -- in the /Amazon Web Services General Reference/. getPolicyVersion_policyArn :: Lens.Lens' GetPolicyVersion Prelude.Text getPolicyVersion_policyArn = Lens.lens (\GetPolicyVersion' {policyArn} -> policyArn) (\s@GetPolicyVersion' {} a -> s {policyArn = a} :: GetPolicyVersion) -- | Identifies the policy version to retrieve. -- -- This parameter allows (through its -- ) a string of characters -- that consists of the lowercase letter \'v\' followed by one or two -- digits, and optionally followed by a period \'.\' and a string of -- letters and digits. getPolicyVersion_versionId :: Lens.Lens' GetPolicyVersion Prelude.Text getPolicyVersion_versionId = Lens.lens (\GetPolicyVersion' {versionId} -> versionId) (\s@GetPolicyVersion' {} a -> s {versionId = a} :: GetPolicyVersion) instance Core.AWSRequest GetPolicyVersion where type AWSResponse GetPolicyVersion = GetPolicyVersionResponse request overrides = Request.postQuery (overrides defaultService) response = Response.receiveXMLWrapper "GetPolicyVersionResult" ( \s h x -> GetPolicyVersionResponse' Prelude.<$> (x Data..@? "PolicyVersion") Prelude.<*> (Prelude.pure (Prelude.fromEnum s)) ) instance Prelude.Hashable GetPolicyVersion where hashWithSalt _salt GetPolicyVersion' {..} = _salt `Prelude.hashWithSalt` policyArn `Prelude.hashWithSalt` versionId instance Prelude.NFData GetPolicyVersion where rnf GetPolicyVersion' {..} = Prelude.rnf policyArn `Prelude.seq` Prelude.rnf versionId instance Data.ToHeaders GetPolicyVersion where toHeaders = Prelude.const Prelude.mempty instance Data.ToPath GetPolicyVersion where toPath = Prelude.const "/" instance Data.ToQuery GetPolicyVersion where toQuery GetPolicyVersion' {..} = Prelude.mconcat [ "Action" Data.=: ("GetPolicyVersion" :: Prelude.ByteString), "Version" Data.=: ("2010-05-08" :: Prelude.ByteString), "PolicyArn" Data.=: policyArn, "VersionId" Data.=: versionId ] -- | Contains the response to a successful GetPolicyVersion request. -- -- /See:/ 'newGetPolicyVersionResponse' smart constructor. data GetPolicyVersionResponse = GetPolicyVersionResponse' { -- | A structure containing details about the policy version. policyVersion :: Prelude.Maybe PolicyVersion, -- | The response's http status code. httpStatus :: Prelude.Int } deriving (Prelude.Eq, Prelude.Read, Prelude.Show, Prelude.Generic) -- | -- Create a value of 'GetPolicyVersionResponse' 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: -- -- 'policyVersion', 'getPolicyVersionResponse_policyVersion' - A structure containing details about the policy version. -- -- 'httpStatus', 'getPolicyVersionResponse_httpStatus' - The response's http status code. newGetPolicyVersionResponse :: -- | 'httpStatus' Prelude.Int -> GetPolicyVersionResponse newGetPolicyVersionResponse pHttpStatus_ = GetPolicyVersionResponse' { policyVersion = Prelude.Nothing, httpStatus = pHttpStatus_ } -- | A structure containing details about the policy version. getPolicyVersionResponse_policyVersion :: Lens.Lens' GetPolicyVersionResponse (Prelude.Maybe PolicyVersion) getPolicyVersionResponse_policyVersion = Lens.lens (\GetPolicyVersionResponse' {policyVersion} -> policyVersion) (\s@GetPolicyVersionResponse' {} a -> s {policyVersion = a} :: GetPolicyVersionResponse) -- | The response's http status code. getPolicyVersionResponse_httpStatus :: Lens.Lens' GetPolicyVersionResponse Prelude.Int getPolicyVersionResponse_httpStatus = Lens.lens (\GetPolicyVersionResponse' {httpStatus} -> httpStatus) (\s@GetPolicyVersionResponse' {} a -> s {httpStatus = a} :: GetPolicyVersionResponse) instance Prelude.NFData GetPolicyVersionResponse where rnf GetPolicyVersionResponse' {..} = Prelude.rnf policyVersion `Prelude.seq` Prelude.rnf httpStatus