amazonka-ec2-1.6.0: gen/Network/AWS/EC2/DeregisterImage.hs
{-# LANGUAGE DeriveDataTypeable #-}
{-# LANGUAGE DeriveGeneric #-}
{-# LANGUAGE OverloadedStrings #-}
{-# LANGUAGE RecordWildCards #-}
{-# LANGUAGE TypeFamilies #-}
{-# OPTIONS_GHC -fno-warn-unused-imports #-}
{-# OPTIONS_GHC -fno-warn-unused-binds #-}
{-# OPTIONS_GHC -fno-warn-unused-matches #-}
-- Derived from AWS service descriptions, licensed under Apache 2.0.
-- |
-- Module : Network.AWS.EC2.DeregisterImage
-- Copyright : (c) 2013-2018 Brendan Hay
-- License : Mozilla Public License, v. 2.0.
-- Maintainer : Brendan Hay <brendan.g.hay+amazonka@gmail.com>
-- Stability : auto-generated
-- Portability : non-portable (GHC extensions)
--
-- Deregisters the specified AMI. After you deregister an AMI, it can't be used to launch new instances; however, it doesn't affect any instances that you've already launched from the AMI. You'll continue to incur usage costs for those instances until you terminate them.
--
--
-- When you deregister an Amazon EBS-backed AMI, it doesn't affect the snapshot that was created for the root volume of the instance during the AMI creation process. When you deregister an instance store-backed AMI, it doesn't affect the files that you uploaded to Amazon S3 when you created the AMI.
--
module Network.AWS.EC2.DeregisterImage
(
-- * Creating a Request
deregisterImage
, DeregisterImage
-- * Request Lenses
, diDryRun
, diImageId
-- * Destructuring the Response
, deregisterImageResponse
, DeregisterImageResponse
) where
import Network.AWS.EC2.Types
import Network.AWS.EC2.Types.Product
import Network.AWS.Lens
import Network.AWS.Prelude
import Network.AWS.Request
import Network.AWS.Response
-- | Contains the parameters for DeregisterImage.
--
--
--
-- /See:/ 'deregisterImage' smart constructor.
data DeregisterImage = DeregisterImage'
{ _diDryRun :: !(Maybe Bool)
, _diImageId :: !Text
} deriving (Eq, Read, Show, Data, Typeable, Generic)
-- | Creates a value of 'DeregisterImage' with the minimum fields required to make a request.
--
-- Use one of the following lenses to modify other fields as desired:
--
-- * 'diDryRun' - Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is @DryRunOperation@ . Otherwise, it is @UnauthorizedOperation@ .
--
-- * 'diImageId' - The ID of the AMI.
deregisterImage
:: Text -- ^ 'diImageId'
-> DeregisterImage
deregisterImage pImageId_ =
DeregisterImage' {_diDryRun = Nothing, _diImageId = pImageId_}
-- | Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is @DryRunOperation@ . Otherwise, it is @UnauthorizedOperation@ .
diDryRun :: Lens' DeregisterImage (Maybe Bool)
diDryRun = lens _diDryRun (\ s a -> s{_diDryRun = a})
-- | The ID of the AMI.
diImageId :: Lens' DeregisterImage Text
diImageId = lens _diImageId (\ s a -> s{_diImageId = a})
instance AWSRequest DeregisterImage where
type Rs DeregisterImage = DeregisterImageResponse
request = postQuery ec2
response = receiveNull DeregisterImageResponse'
instance Hashable DeregisterImage where
instance NFData DeregisterImage where
instance ToHeaders DeregisterImage where
toHeaders = const mempty
instance ToPath DeregisterImage where
toPath = const "/"
instance ToQuery DeregisterImage where
toQuery DeregisterImage'{..}
= mconcat
["Action" =: ("DeregisterImage" :: ByteString),
"Version" =: ("2016-11-15" :: ByteString),
"DryRun" =: _diDryRun, "ImageId" =: _diImageId]
-- | /See:/ 'deregisterImageResponse' smart constructor.
data DeregisterImageResponse =
DeregisterImageResponse'
deriving (Eq, Read, Show, Data, Typeable, Generic)
-- | Creates a value of 'DeregisterImageResponse' with the minimum fields required to make a request.
--
deregisterImageResponse
:: DeregisterImageResponse
deregisterImageResponse = DeregisterImageResponse'
instance NFData DeregisterImageResponse where