{-# 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.S3.GetBucketLocation -- Copyright : (c) 2013-2018 Brendan Hay -- License : Mozilla Public License, v. 2.0. -- Maintainer : Brendan Hay -- Stability : auto-generated -- Portability : non-portable (GHC extensions) -- -- Returns the region the bucket resides in. module Network.AWS.S3.GetBucketLocation ( -- * Creating a Request getBucketLocation , GetBucketLocation -- * Request Lenses , gblBucket -- * Destructuring the Response , getBucketLocationResponse , GetBucketLocationResponse -- * Response Lenses , gblbrsResponseStatus , gblbrsLocationConstraint ) where import Network.AWS.Lens import Network.AWS.Prelude import Network.AWS.Request import Network.AWS.Response import Network.AWS.S3.Types import Network.AWS.S3.Types.Product -- | /See:/ 'getBucketLocation' smart constructor. newtype GetBucketLocation = GetBucketLocation' { _gblBucket :: BucketName } deriving (Eq, Read, Show, Data, Typeable, Generic) -- | Creates a value of 'GetBucketLocation' with the minimum fields required to make a request. -- -- Use one of the following lenses to modify other fields as desired: -- -- * 'gblBucket' - Undocumented member. getBucketLocation :: BucketName -- ^ 'gblBucket' -> GetBucketLocation getBucketLocation pBucket_ = GetBucketLocation' {_gblBucket = pBucket_} -- | Undocumented member. gblBucket :: Lens' GetBucketLocation BucketName gblBucket = lens _gblBucket (\ s a -> s{_gblBucket = a}) instance AWSRequest GetBucketLocation where type Rs GetBucketLocation = GetBucketLocationResponse request = get s3 response = receiveXML (\ s h x -> GetBucketLocationResponse' <$> (pure (fromEnum s)) <*> (parseXML x)) instance Hashable GetBucketLocation where instance NFData GetBucketLocation where instance ToHeaders GetBucketLocation where toHeaders = const mempty instance ToPath GetBucketLocation where toPath GetBucketLocation'{..} = mconcat ["/", toBS _gblBucket] instance ToQuery GetBucketLocation where toQuery = const (mconcat ["location"]) -- | /See:/ 'getBucketLocationResponse' smart constructor. data GetBucketLocationResponse = GetBucketLocationResponse' { _gblbrsResponseStatus :: !Int , _gblbrsLocationConstraint :: !LocationConstraint } deriving (Eq, Read, Show, Data, Typeable, Generic) -- | Creates a value of 'GetBucketLocationResponse' with the minimum fields required to make a request. -- -- Use one of the following lenses to modify other fields as desired: -- -- * 'gblbrsResponseStatus' - -- | The response status code. -- -- * 'gblbrsLocationConstraint' - Undocumented member. getBucketLocationResponse :: Int -- ^ 'gblbrsResponseStatus' -> LocationConstraint -- ^ 'gblbrsLocationConstraint' -> GetBucketLocationResponse getBucketLocationResponse pResponseStatus_ pLocationConstraint_ = GetBucketLocationResponse' { _gblbrsResponseStatus = pResponseStatus_ , _gblbrsLocationConstraint = pLocationConstraint_ } -- | -- | The response status code. gblbrsResponseStatus :: Lens' GetBucketLocationResponse Int gblbrsResponseStatus = lens _gblbrsResponseStatus (\ s a -> s{_gblbrsResponseStatus = a}) -- | Undocumented member. gblbrsLocationConstraint :: Lens' GetBucketLocationResponse LocationConstraint gblbrsLocationConstraint = lens _gblbrsLocationConstraint (\ s a -> s{_gblbrsLocationConstraint = a}) instance NFData GetBucketLocationResponse where