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)
Safe Haskell	None
Language	Haskell2010

Network.AWS.IAM.UpdateRole

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

Updates the description or maximum session duration setting of a role.

Synopsis

updateRole :: Text -> UpdateRole
data UpdateRole
urMaxSessionDuration :: Lens' UpdateRole (Maybe Natural)
urDescription :: Lens' UpdateRole (Maybe Text)
urRoleName :: Lens' UpdateRole Text
updateRoleResponse :: Int -> UpdateRoleResponse
data UpdateRoleResponse
urrsResponseStatus :: Lens' UpdateRoleResponse Int

Creating a Request

updateRole #

Arguments

:: Text	`urRoleName`
-> UpdateRole

Creates a value of UpdateRole with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

urMaxSessionDuration - The maximum session duration (in seconds) that you want to set for the specified role. If you do not specify a value for this setting, the default maximum of one hour is applied. This setting can have a value from 1 hour to 12 hours. Anyone who assumes the role from the AWS CLI or API can use the DurationSeconds API parameter or the duration-seconds CLI parameter to request a longer session. The MaxSessionDuration setting determines the maximum duration that can be requested using the DurationSeconds parameter. If users don't specify a value for the DurationSeconds parameter, their security credentials are valid for one hour by default. This applies when you use the AssumeRole* API operations or the assume-role* CLI operations but does not apply when you use those operations to create a console URL. For more information, see Using IAM Roles in the IAM User Guide .
urDescription - The new description that you want to apply to the specified role.
urRoleName - The name of the role that you want to modify.

data UpdateRole #

See: updateRole smart constructor.

Instances

Eq UpdateRole #
Instance details Defined in Network.AWS.IAM.UpdateRole Methods (==) :: UpdateRole -> UpdateRole -> Bool # (/=) :: UpdateRole -> UpdateRole -> Bool #
Data UpdateRole #
Instance details Defined in Network.AWS.IAM.UpdateRole Methods gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> UpdateRole -> c UpdateRole # gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c UpdateRole # toConstr :: UpdateRole -> Constr # dataTypeOf :: UpdateRole -> DataType # dataCast1 :: Typeable t => (forall d. Data d => c (t d)) -> Maybe (c UpdateRole) # dataCast2 :: Typeable t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c UpdateRole) # gmapT :: (forall b. Data b => b -> b) -> UpdateRole -> UpdateRole # gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> UpdateRole -> r # gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> UpdateRole -> r # gmapQ :: (forall d. Data d => d -> u) -> UpdateRole -> [u] # gmapQi :: Int -> (forall d. Data d => d -> u) -> UpdateRole -> u # gmapM :: Monad m => (forall d. Data d => d -> m d) -> UpdateRole -> m UpdateRole # gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> UpdateRole -> m UpdateRole # gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> UpdateRole -> m UpdateRole #
Read UpdateRole #
Instance details Defined in Network.AWS.IAM.UpdateRole Methods readsPrec :: Int -> ReadS UpdateRole # readList :: ReadS [UpdateRole] # readPrec :: ReadPrec UpdateRole # readListPrec :: ReadPrec [UpdateRole] #
Show UpdateRole #
Instance details Defined in Network.AWS.IAM.UpdateRole Methods showsPrec :: Int -> UpdateRole -> ShowS # show :: UpdateRole -> String # showList :: [UpdateRole] -> ShowS #
Generic UpdateRole #
Instance details Defined in Network.AWS.IAM.UpdateRole Associated Types type Rep UpdateRole :: * -> * # Methods from :: UpdateRole -> Rep UpdateRole x # to :: Rep UpdateRole x -> UpdateRole #
Hashable UpdateRole #
Instance details Defined in Network.AWS.IAM.UpdateRole Methods hashWithSalt :: Int -> UpdateRole -> Int # hash :: UpdateRole -> Int #
AWSRequest UpdateRole #
Instance details Defined in Network.AWS.IAM.UpdateRole Associated Types type Rs UpdateRole :: * # Methods request :: UpdateRole -> Request UpdateRole # response :: (MonadResource m, MonadThrow m) => Logger -> Service -> Proxy UpdateRole -> ClientResponse -> m (Response UpdateRole) #
ToHeaders UpdateRole #
Instance details Defined in Network.AWS.IAM.UpdateRole Methods toHeaders :: UpdateRole -> [Header] #
ToPath UpdateRole #
Instance details Defined in Network.AWS.IAM.UpdateRole Methods toPath :: UpdateRole -> ByteString #
ToQuery UpdateRole #
Instance details Defined in Network.AWS.IAM.UpdateRole Methods toQuery :: UpdateRole -> QueryString #
NFData UpdateRole #
Instance details Defined in Network.AWS.IAM.UpdateRole Methods rnf :: UpdateRole -> () #
type Rep UpdateRole #
Instance details Defined in Network.AWS.IAM.UpdateRole type Rep UpdateRole = D1 (MetaData "UpdateRole" "Network.AWS.IAM.UpdateRole" "amazonka-iam-1.6.0-KLHg33OPBsA2oss7MTCyZq" False) (C1 (MetaCons "UpdateRole'" PrefixI True) (S1 (MetaSel (Just "_urMaxSessionDuration") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Nat)) :: (S1 (MetaSel (Just "_urDescription") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :: S1 (MetaSel (Just "_urRoleName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text))))
type Rs UpdateRole #
Instance details Defined in Network.AWS.IAM.UpdateRole type Rs UpdateRole = UpdateRoleResponse

Request Lenses

urMaxSessionDuration :: Lens' UpdateRole (Maybe Natural) #

The maximum session duration (in seconds) that you want to set for the specified role. If you do not specify a value for this setting, the default maximum of one hour is applied. This setting can have a value from 1 hour to 12 hours. Anyone who assumes the role from the AWS CLI or API can use the DurationSeconds API parameter or the duration-seconds CLI parameter to request a longer session. The MaxSessionDuration setting determines the maximum duration that can be requested using the DurationSeconds parameter. If users don't specify a value for the DurationSeconds parameter, their security credentials are valid for one hour by default. This applies when you use the AssumeRole* API operations or the assume-role* CLI operations but does not apply when you use those operations to create a console URL. For more information, see Using IAM Roles in the IAM User Guide .

urDescription :: Lens' UpdateRole (Maybe Text) #

The new description that you want to apply to the specified role.

urRoleName :: Lens' UpdateRole Text #

The name of the role that you want to modify.

Destructuring the Response

updateRoleResponse #

Arguments

:: Int	`urrsResponseStatus`
-> UpdateRoleResponse

Creates a value of UpdateRoleResponse with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

urrsResponseStatus - -- | The response status code.

data UpdateRoleResponse #

See: updateRoleResponse smart constructor.

Instances

Eq UpdateRoleResponse #
Instance details Defined in Network.AWS.IAM.UpdateRole Methods (==) :: UpdateRoleResponse -> UpdateRoleResponse -> Bool # (/=) :: UpdateRoleResponse -> UpdateRoleResponse -> Bool #
Data UpdateRoleResponse #
Instance details Defined in Network.AWS.IAM.UpdateRole Methods gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> UpdateRoleResponse -> c UpdateRoleResponse # gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c UpdateRoleResponse # toConstr :: UpdateRoleResponse -> Constr # dataTypeOf :: UpdateRoleResponse -> DataType # dataCast1 :: Typeable t => (forall d. Data d => c (t d)) -> Maybe (c UpdateRoleResponse) # dataCast2 :: Typeable t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c UpdateRoleResponse) # gmapT :: (forall b. Data b => b -> b) -> UpdateRoleResponse -> UpdateRoleResponse # gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> UpdateRoleResponse -> r # gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> UpdateRoleResponse -> r # gmapQ :: (forall d. Data d => d -> u) -> UpdateRoleResponse -> [u] # gmapQi :: Int -> (forall d. Data d => d -> u) -> UpdateRoleResponse -> u # gmapM :: Monad m => (forall d. Data d => d -> m d) -> UpdateRoleResponse -> m UpdateRoleResponse # gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> UpdateRoleResponse -> m UpdateRoleResponse # gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> UpdateRoleResponse -> m UpdateRoleResponse #
Read UpdateRoleResponse #
Instance details Defined in Network.AWS.IAM.UpdateRole Methods readsPrec :: Int -> ReadS UpdateRoleResponse # readList :: ReadS [UpdateRoleResponse] # readPrec :: ReadPrec UpdateRoleResponse # readListPrec :: ReadPrec [UpdateRoleResponse] #
Show UpdateRoleResponse #
Instance details Defined in Network.AWS.IAM.UpdateRole Methods showsPrec :: Int -> UpdateRoleResponse -> ShowS # show :: UpdateRoleResponse -> String # showList :: [UpdateRoleResponse] -> ShowS #
Generic UpdateRoleResponse #
Instance details Defined in Network.AWS.IAM.UpdateRole Associated Types type Rep UpdateRoleResponse :: * -> * # Methods from :: UpdateRoleResponse -> Rep UpdateRoleResponse x # to :: Rep UpdateRoleResponse x -> UpdateRoleResponse #
NFData UpdateRoleResponse #
Instance details Defined in Network.AWS.IAM.UpdateRole Methods rnf :: UpdateRoleResponse -> () #
type Rep UpdateRoleResponse #
Instance details Defined in Network.AWS.IAM.UpdateRole type Rep UpdateRoleResponse = D1 (MetaData "UpdateRoleResponse" "Network.AWS.IAM.UpdateRole" "amazonka-iam-1.6.0-KLHg33OPBsA2oss7MTCyZq" True) (C1 (MetaCons "UpdateRoleResponse'" PrefixI True) (S1 (MetaSel (Just "_urrsResponseStatus") NoSourceUnpackedness NoSourceStrictness DecidedLazy) (Rec0 Int)))

Response Lenses

urrsResponseStatus :: Lens' UpdateRoleResponse Int #

- | The response status code.