{-# 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.KMS.DeleteAlias
-- Copyright   : (c) 2013-2023 Brendan Hay
-- License     : Mozilla Public License, v. 2.0.
-- Maintainer  : Brendan Hay
-- Stability   : auto-generated
-- Portability : non-portable (GHC extensions)
--
-- Deletes the specified alias.
--
-- Adding, deleting, or updating an alias can allow or deny permission to
-- the KMS key. For details, see
-- <https://docs.aws.amazon.com/kms/latest/developerguide/abac.html ABAC for KMS>
-- in the /Key Management Service Developer Guide/.
--
-- Because an alias is not a property of a KMS key, you can delete and
-- change the aliases of a KMS key without affecting the KMS key. Also,
-- aliases do not appear in the response from the DescribeKey operation. To
-- get the aliases of all KMS keys, use the ListAliases operation.
--
-- Each KMS key can have multiple aliases. To change the alias of a KMS
-- key, use DeleteAlias to delete the current alias and CreateAlias to
-- create a new alias. To associate an existing alias with a different KMS
-- key, call UpdateAlias.
--
-- __Cross-account use__: No. You cannot perform this operation on an alias
-- in a different Amazon Web Services account.
--
-- __Required permissions__
--
-- -   <https://docs.aws.amazon.com/kms/latest/developerguide/kms-api-permissions-reference.html kms:DeleteAlias>
--     on the alias (IAM policy).
--
-- -   <https://docs.aws.amazon.com/kms/latest/developerguide/kms-api-permissions-reference.html kms:DeleteAlias>
--     on the KMS key (key policy).
--
-- For details, see
-- <https://docs.aws.amazon.com/kms/latest/developerguide/kms-alias.html#alias-access Controlling access to aliases>
-- in the /Key Management Service Developer Guide/.
--
-- __Related operations:__
--
-- -   CreateAlias
--
-- -   ListAliases
--
-- -   UpdateAlias
module Amazonka.KMS.DeleteAlias
  ( -- * Creating a Request
    DeleteAlias (..),
    newDeleteAlias,

    -- * Request Lenses
    deleteAlias_aliasName,

    -- * Destructuring the Response
    DeleteAliasResponse (..),
    newDeleteAliasResponse,
  )
where

import qualified Amazonka.Core as Core
import qualified Amazonka.Core.Lens.Internal as Lens
import qualified Amazonka.Data as Data
import Amazonka.KMS.Types
import qualified Amazonka.Prelude as Prelude
import qualified Amazonka.Request as Request
import qualified Amazonka.Response as Response

-- | /See:/ 'newDeleteAlias' smart constructor.
data DeleteAlias = DeleteAlias'
  { -- | The alias to be deleted. The alias name must begin with @alias\/@
    -- followed by the alias name, such as @alias\/ExampleAlias@.
    DeleteAlias -> Text
aliasName :: Prelude.Text
  }
  deriving (DeleteAlias -> DeleteAlias -> Bool
forall a. (a -> a -> Bool) -> (a -> a -> Bool) -> Eq a
/= :: DeleteAlias -> DeleteAlias -> Bool
$c/= :: DeleteAlias -> DeleteAlias -> Bool
== :: DeleteAlias -> DeleteAlias -> Bool
$c== :: DeleteAlias -> DeleteAlias -> Bool
Prelude.Eq, ReadPrec [DeleteAlias]
ReadPrec DeleteAlias
Int -> ReadS DeleteAlias
ReadS [DeleteAlias]
forall a.
(Int -> ReadS a)
-> ReadS [a] -> ReadPrec a -> ReadPrec [a] -> Read a
readListPrec :: ReadPrec [DeleteAlias]
$creadListPrec :: ReadPrec [DeleteAlias]
readPrec :: ReadPrec DeleteAlias
$creadPrec :: ReadPrec DeleteAlias
readList :: ReadS [DeleteAlias]
$creadList :: ReadS [DeleteAlias]
readsPrec :: Int -> ReadS DeleteAlias
$creadsPrec :: Int -> ReadS DeleteAlias
Prelude.Read, Int -> DeleteAlias -> ShowS
[DeleteAlias] -> ShowS
DeleteAlias -> String
forall a.
(Int -> a -> ShowS) -> (a -> String) -> ([a] -> ShowS) -> Show a
showList :: [DeleteAlias] -> ShowS
$cshowList :: [DeleteAlias] -> ShowS
show :: DeleteAlias -> String
$cshow :: DeleteAlias -> String
showsPrec :: Int -> DeleteAlias -> ShowS
$cshowsPrec :: Int -> DeleteAlias -> ShowS
Prelude.Show, forall x. Rep DeleteAlias x -> DeleteAlias
forall x. DeleteAlias -> Rep DeleteAlias x
forall a.
(forall x. a -> Rep a x) -> (forall x. Rep a x -> a) -> Generic a
$cto :: forall x. Rep DeleteAlias x -> DeleteAlias
$cfrom :: forall x. DeleteAlias -> Rep DeleteAlias x
Prelude.Generic)

-- |
-- Create a value of 'DeleteAlias' with all optional fields omitted.
--
-- Use <https://hackage.haskell.org/package/generic-lens generic-lens> or <https://hackage.haskell.org/package/optics optics> to modify other optional fields.
--
-- The following record fields are available, with the corresponding lenses provided
-- for backwards compatibility:
--
-- 'aliasName', 'deleteAlias_aliasName' - The alias to be deleted. The alias name must begin with @alias\/@
-- followed by the alias name, such as @alias\/ExampleAlias@.
newDeleteAlias ::
  -- | 'aliasName'
  Prelude.Text ->
  DeleteAlias
newDeleteAlias :: Text -> DeleteAlias
newDeleteAlias Text
pAliasName_ =
  DeleteAlias' {$sel:aliasName:DeleteAlias' :: Text
aliasName = Text
pAliasName_}

-- | The alias to be deleted. The alias name must begin with @alias\/@
-- followed by the alias name, such as @alias\/ExampleAlias@.
deleteAlias_aliasName :: Lens.Lens' DeleteAlias Prelude.Text
deleteAlias_aliasName :: Lens' DeleteAlias Text
deleteAlias_aliasName = forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\DeleteAlias' {Text
aliasName :: Text
$sel:aliasName:DeleteAlias' :: DeleteAlias -> Text
aliasName} -> Text
aliasName) (\s :: DeleteAlias
s@DeleteAlias' {} Text
a -> DeleteAlias
s {$sel:aliasName:DeleteAlias' :: Text
aliasName = Text
a} :: DeleteAlias)

instance Core.AWSRequest DeleteAlias where
  type AWSResponse DeleteAlias = DeleteAliasResponse
  request :: (Service -> Service) -> DeleteAlias -> Request DeleteAlias
request Service -> Service
overrides =
    forall a. (ToRequest a, ToJSON a) => Service -> a -> Request a
Request.postJSON (Service -> Service
overrides Service
defaultService)
  response :: forall (m :: * -> *).
MonadResource m =>
(ByteStringLazy -> IO ByteStringLazy)
-> Service
-> Proxy DeleteAlias
-> ClientResponse ClientBody
-> m (Either Error (ClientResponse (AWSResponse DeleteAlias)))
response = forall (m :: * -> *) a.
MonadResource m =>
AWSResponse a
-> (ByteStringLazy -> IO ByteStringLazy)
-> Service
-> Proxy a
-> ClientResponse ClientBody
-> m (Either Error (ClientResponse (AWSResponse a)))
Response.receiveNull DeleteAliasResponse
DeleteAliasResponse'

instance Prelude.Hashable DeleteAlias where
  hashWithSalt :: Int -> DeleteAlias -> Int
hashWithSalt Int
_salt DeleteAlias' {Text
aliasName :: Text
$sel:aliasName:DeleteAlias' :: DeleteAlias -> Text
..} =
    Int
_salt forall a. Hashable a => Int -> a -> Int
`Prelude.hashWithSalt` Text
aliasName

instance Prelude.NFData DeleteAlias where
  rnf :: DeleteAlias -> ()
rnf DeleteAlias' {Text
aliasName :: Text
$sel:aliasName:DeleteAlias' :: DeleteAlias -> Text
..} = forall a. NFData a => a -> ()
Prelude.rnf Text
aliasName

instance Data.ToHeaders DeleteAlias where
  toHeaders :: DeleteAlias -> [Header]
toHeaders =
    forall a b. a -> b -> a
Prelude.const
      ( forall a. Monoid a => [a] -> a
Prelude.mconcat
          [ HeaderName
"X-Amz-Target"
              forall a. ToHeader a => HeaderName -> a -> [Header]
Data.=# (ByteString
"TrentService.DeleteAlias" :: Prelude.ByteString),
            HeaderName
"Content-Type"
              forall a. ToHeader a => HeaderName -> a -> [Header]
Data.=# ( ByteString
"application/x-amz-json-1.1" ::
                          Prelude.ByteString
                      )
          ]
      )

instance Data.ToJSON DeleteAlias where
  toJSON :: DeleteAlias -> Value
toJSON DeleteAlias' {Text
aliasName :: Text
$sel:aliasName:DeleteAlias' :: DeleteAlias -> Text
..} =
    [Pair] -> Value
Data.object
      ( forall a. [Maybe a] -> [a]
Prelude.catMaybes
          [forall a. a -> Maybe a
Prelude.Just (Key
"AliasName" forall kv v. (KeyValue kv, ToJSON v) => Key -> v -> kv
Data..= Text
aliasName)]
      )

instance Data.ToPath DeleteAlias where
  toPath :: DeleteAlias -> ByteString
toPath = forall a b. a -> b -> a
Prelude.const ByteString
"/"

instance Data.ToQuery DeleteAlias where
  toQuery :: DeleteAlias -> QueryString
toQuery = forall a b. a -> b -> a
Prelude.const forall a. Monoid a => a
Prelude.mempty

-- | /See:/ 'newDeleteAliasResponse' smart constructor.
data DeleteAliasResponse = DeleteAliasResponse'
  {
  }
  deriving (DeleteAliasResponse -> DeleteAliasResponse -> Bool
forall a. (a -> a -> Bool) -> (a -> a -> Bool) -> Eq a
/= :: DeleteAliasResponse -> DeleteAliasResponse -> Bool
$c/= :: DeleteAliasResponse -> DeleteAliasResponse -> Bool
== :: DeleteAliasResponse -> DeleteAliasResponse -> Bool
$c== :: DeleteAliasResponse -> DeleteAliasResponse -> Bool
Prelude.Eq, ReadPrec [DeleteAliasResponse]
ReadPrec DeleteAliasResponse
Int -> ReadS DeleteAliasResponse
ReadS [DeleteAliasResponse]
forall a.
(Int -> ReadS a)
-> ReadS [a] -> ReadPrec a -> ReadPrec [a] -> Read a
readListPrec :: ReadPrec [DeleteAliasResponse]
$creadListPrec :: ReadPrec [DeleteAliasResponse]
readPrec :: ReadPrec DeleteAliasResponse
$creadPrec :: ReadPrec DeleteAliasResponse
readList :: ReadS [DeleteAliasResponse]
$creadList :: ReadS [DeleteAliasResponse]
readsPrec :: Int -> ReadS DeleteAliasResponse
$creadsPrec :: Int -> ReadS DeleteAliasResponse
Prelude.Read, Int -> DeleteAliasResponse -> ShowS
[DeleteAliasResponse] -> ShowS
DeleteAliasResponse -> String
forall a.
(Int -> a -> ShowS) -> (a -> String) -> ([a] -> ShowS) -> Show a
showList :: [DeleteAliasResponse] -> ShowS
$cshowList :: [DeleteAliasResponse] -> ShowS
show :: DeleteAliasResponse -> String
$cshow :: DeleteAliasResponse -> String
showsPrec :: Int -> DeleteAliasResponse -> ShowS
$cshowsPrec :: Int -> DeleteAliasResponse -> ShowS
Prelude.Show, forall x. Rep DeleteAliasResponse x -> DeleteAliasResponse
forall x. DeleteAliasResponse -> Rep DeleteAliasResponse x
forall a.
(forall x. a -> Rep a x) -> (forall x. Rep a x -> a) -> Generic a
$cto :: forall x. Rep DeleteAliasResponse x -> DeleteAliasResponse
$cfrom :: forall x. DeleteAliasResponse -> Rep DeleteAliasResponse x
Prelude.Generic)

-- |
-- Create a value of 'DeleteAliasResponse' with all optional fields omitted.
--
-- Use <https://hackage.haskell.org/package/generic-lens generic-lens> or <https://hackage.haskell.org/package/optics optics> to modify other optional fields.
newDeleteAliasResponse ::
  DeleteAliasResponse
newDeleteAliasResponse :: DeleteAliasResponse
newDeleteAliasResponse = DeleteAliasResponse
DeleteAliasResponse'

instance Prelude.NFData DeleteAliasResponse where
  rnf :: DeleteAliasResponse -> ()
rnf DeleteAliasResponse
_ = ()