amazonka-iam-1.4.5: gen/Network/AWS/IAM/UpdateUser.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.IAM.UpdateUser
-- Copyright : (c) 2013-2016 Brendan Hay
-- License : Mozilla Public License, v. 2.0.
-- Maintainer : Brendan Hay <brendan.g.hay@gmail.com>
-- Stability : auto-generated
-- Portability : non-portable (GHC extensions)
--
-- Updates the name and/or the path of the specified IAM user.
--
--
-- /Important:/ You should understand the implications of changing an IAM user's path or name. For more information, see <http://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_manage.html#id_users_renaming Renaming an IAM User> and <http://docs.aws.amazon.com/IAM/latest/UserGuide/id_groups_manage_rename.html Renaming an IAM Group> in the /IAM User Guide/ .
--
module Network.AWS.IAM.UpdateUser
(
-- * Creating a Request
updateUser
, UpdateUser
-- * Request Lenses
, uuNewUserName
, uuNewPath
, uuUserName
-- * Destructuring the Response
, updateUserResponse
, UpdateUserResponse
) where
import Network.AWS.IAM.Types
import Network.AWS.IAM.Types.Product
import Network.AWS.Lens
import Network.AWS.Prelude
import Network.AWS.Request
import Network.AWS.Response
-- | /See:/ 'updateUser' smart constructor.
data UpdateUser = UpdateUser'
{ _uuNewUserName :: !(Maybe Text)
, _uuNewPath :: !(Maybe Text)
, _uuUserName :: !Text
} deriving (Eq,Read,Show,Data,Typeable,Generic)
-- | Creates a value of 'UpdateUser' with the minimum fields required to make a request.
--
-- Use one of the following lenses to modify other fields as desired:
--
-- * 'uuNewUserName' - New name for the user. Include this parameter only if you're changing the user's name. The <http://wikipedia.org/wiki/regex regex pattern> for this parameter is a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: =,.@-
--
-- * 'uuNewPath' - New path for the IAM user. Include this parameter only if you're changing the user's path. The <http://wikipedia.org/wiki/regex regex pattern> for this parameter is a string of characters consisting of either a forward slash (/) by itself or a string that must begin and end with forward slashes, containing any ASCII character from the ! (\u0021) thru the DEL character (\u007F), including most punctuation characters, digits, and upper and lowercased letters.
--
-- * 'uuUserName' - Name of the user to update. If you're changing the name of the user, this is the original user name. The <http://wikipedia.org/wiki/regex regex pattern> for this parameter is a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: =,.@-
updateUser
:: Text -- ^ 'uuUserName'
-> UpdateUser
updateUser pUserName_ =
UpdateUser'
{ _uuNewUserName = Nothing
, _uuNewPath = Nothing
, _uuUserName = pUserName_
}
-- | New name for the user. Include this parameter only if you're changing the user's name. The <http://wikipedia.org/wiki/regex regex pattern> for this parameter is a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: =,.@-
uuNewUserName :: Lens' UpdateUser (Maybe Text)
uuNewUserName = lens _uuNewUserName (\ s a -> s{_uuNewUserName = a});
-- | New path for the IAM user. Include this parameter only if you're changing the user's path. The <http://wikipedia.org/wiki/regex regex pattern> for this parameter is a string of characters consisting of either a forward slash (/) by itself or a string that must begin and end with forward slashes, containing any ASCII character from the ! (\u0021) thru the DEL character (\u007F), including most punctuation characters, digits, and upper and lowercased letters.
uuNewPath :: Lens' UpdateUser (Maybe Text)
uuNewPath = lens _uuNewPath (\ s a -> s{_uuNewPath = a});
-- | Name of the user to update. If you're changing the name of the user, this is the original user name. The <http://wikipedia.org/wiki/regex regex pattern> for this parameter is a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: =,.@-
uuUserName :: Lens' UpdateUser Text
uuUserName = lens _uuUserName (\ s a -> s{_uuUserName = a});
instance AWSRequest UpdateUser where
type Rs UpdateUser = UpdateUserResponse
request = postQuery iam
response = receiveNull UpdateUserResponse'
instance Hashable UpdateUser
instance NFData UpdateUser
instance ToHeaders UpdateUser where
toHeaders = const mempty
instance ToPath UpdateUser where
toPath = const "/"
instance ToQuery UpdateUser where
toQuery UpdateUser'{..}
= mconcat
["Action" =: ("UpdateUser" :: ByteString),
"Version" =: ("2010-05-08" :: ByteString),
"NewUserName" =: _uuNewUserName,
"NewPath" =: _uuNewPath, "UserName" =: _uuUserName]
-- | /See:/ 'updateUserResponse' smart constructor.
data UpdateUserResponse =
UpdateUserResponse'
deriving (Eq,Read,Show,Data,Typeable,Generic)
-- | Creates a value of 'UpdateUserResponse' with the minimum fields required to make a request.
--
updateUserResponse
:: UpdateUserResponse
updateUserResponse = UpdateUserResponse'
instance NFData UpdateUserResponse