{-# 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.DescribeSnapshotAttribute -- Copyright : (c) 2013-2016 Brendan Hay -- License : Mozilla Public License, v. 2.0. -- Maintainer : Brendan Hay -- Stability : auto-generated -- Portability : non-portable (GHC extensions) -- -- Describes the specified attribute of the specified snapshot. You can specify only one attribute at a time. -- -- For more information about EBS snapshots, see in the /Amazon Elastic Compute Cloud User Guide/. module Network.AWS.EC2.DescribeSnapshotAttribute ( -- * Creating a Request describeSnapshotAttribute , DescribeSnapshotAttribute -- * Request Lenses , dsaDryRun , dsaSnapshotId , dsaAttribute -- * Destructuring the Response , describeSnapshotAttributeResponse , DescribeSnapshotAttributeResponse -- * Response Lenses , dsarsCreateVolumePermissions , dsarsProductCodes , dsarsSnapshotId , dsarsResponseStatus ) 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 DescribeSnapshotAttribute. -- -- /See:/ 'describeSnapshotAttribute' smart constructor. data DescribeSnapshotAttribute = DescribeSnapshotAttribute' { _dsaDryRun :: !(Maybe Bool) , _dsaSnapshotId :: !Text , _dsaAttribute :: !SnapshotAttributeName } deriving (Eq,Read,Show,Data,Typeable,Generic) -- | Creates a value of 'DescribeSnapshotAttribute' with the minimum fields required to make a request. -- -- Use one of the following lenses to modify other fields as desired: -- -- * 'dsaDryRun' -- -- * 'dsaSnapshotId' -- -- * 'dsaAttribute' describeSnapshotAttribute :: Text -- ^ 'dsaSnapshotId' -> SnapshotAttributeName -- ^ 'dsaAttribute' -> DescribeSnapshotAttribute describeSnapshotAttribute pSnapshotId_ pAttribute_ = DescribeSnapshotAttribute' { _dsaDryRun = Nothing , _dsaSnapshotId = pSnapshotId_ , _dsaAttribute = pAttribute_ } -- | 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'. dsaDryRun :: Lens' DescribeSnapshotAttribute (Maybe Bool) dsaDryRun = lens _dsaDryRun (\ s a -> s{_dsaDryRun = a}); -- | The ID of the EBS snapshot. dsaSnapshotId :: Lens' DescribeSnapshotAttribute Text dsaSnapshotId = lens _dsaSnapshotId (\ s a -> s{_dsaSnapshotId = a}); -- | The snapshot attribute you would like to view. dsaAttribute :: Lens' DescribeSnapshotAttribute SnapshotAttributeName dsaAttribute = lens _dsaAttribute (\ s a -> s{_dsaAttribute = a}); instance AWSRequest DescribeSnapshotAttribute where type Rs DescribeSnapshotAttribute = DescribeSnapshotAttributeResponse request = postQuery ec2 response = receiveXML (\ s h x -> DescribeSnapshotAttributeResponse' <$> (x .@? "createVolumePermission" .!@ mempty >>= may (parseXMLList "item")) <*> (x .@? "productCodes" .!@ mempty >>= may (parseXMLList "item")) <*> (x .@? "snapshotId") <*> (pure (fromEnum s))) instance Hashable DescribeSnapshotAttribute instance NFData DescribeSnapshotAttribute instance ToHeaders DescribeSnapshotAttribute where toHeaders = const mempty instance ToPath DescribeSnapshotAttribute where toPath = const "/" instance ToQuery DescribeSnapshotAttribute where toQuery DescribeSnapshotAttribute'{..} = mconcat ["Action" =: ("DescribeSnapshotAttribute" :: ByteString), "Version" =: ("2016-04-01" :: ByteString), "DryRun" =: _dsaDryRun, "SnapshotId" =: _dsaSnapshotId, "Attribute" =: _dsaAttribute] -- | Contains the output of DescribeSnapshotAttribute. -- -- /See:/ 'describeSnapshotAttributeResponse' smart constructor. data DescribeSnapshotAttributeResponse = DescribeSnapshotAttributeResponse' { _dsarsCreateVolumePermissions :: !(Maybe [CreateVolumePermission]) , _dsarsProductCodes :: !(Maybe [ProductCode]) , _dsarsSnapshotId :: !(Maybe Text) , _dsarsResponseStatus :: !Int } deriving (Eq,Read,Show,Data,Typeable,Generic) -- | Creates a value of 'DescribeSnapshotAttributeResponse' with the minimum fields required to make a request. -- -- Use one of the following lenses to modify other fields as desired: -- -- * 'dsarsCreateVolumePermissions' -- -- * 'dsarsProductCodes' -- -- * 'dsarsSnapshotId' -- -- * 'dsarsResponseStatus' describeSnapshotAttributeResponse :: Int -- ^ 'dsarsResponseStatus' -> DescribeSnapshotAttributeResponse describeSnapshotAttributeResponse pResponseStatus_ = DescribeSnapshotAttributeResponse' { _dsarsCreateVolumePermissions = Nothing , _dsarsProductCodes = Nothing , _dsarsSnapshotId = Nothing , _dsarsResponseStatus = pResponseStatus_ } -- | A list of permissions for creating volumes from the snapshot. dsarsCreateVolumePermissions :: Lens' DescribeSnapshotAttributeResponse [CreateVolumePermission] dsarsCreateVolumePermissions = lens _dsarsCreateVolumePermissions (\ s a -> s{_dsarsCreateVolumePermissions = a}) . _Default . _Coerce; -- | A list of product codes. dsarsProductCodes :: Lens' DescribeSnapshotAttributeResponse [ProductCode] dsarsProductCodes = lens _dsarsProductCodes (\ s a -> s{_dsarsProductCodes = a}) . _Default . _Coerce; -- | The ID of the EBS snapshot. dsarsSnapshotId :: Lens' DescribeSnapshotAttributeResponse (Maybe Text) dsarsSnapshotId = lens _dsarsSnapshotId (\ s a -> s{_dsarsSnapshotId = a}); -- | The response status code. dsarsResponseStatus :: Lens' DescribeSnapshotAttributeResponse Int dsarsResponseStatus = lens _dsarsResponseStatus (\ s a -> s{_dsarsResponseStatus = a}); instance NFData DescribeSnapshotAttributeResponse