Network.AWS.IAM.UpdateRole

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

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

Methods

(==) :: UpdateRole -> UpdateRole -> Bool

(/=) :: UpdateRole -> UpdateRole -> Bool

Data 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

Methods

readsPrec :: Int -> ReadS UpdateRole

readList :: ReadS [UpdateRole]

readPrec :: ReadPrec UpdateRole

readListPrec :: ReadPrec [UpdateRole]

Show UpdateRole

Methods

showsPrec :: Int -> UpdateRole -> ShowS

show :: UpdateRole -> String

showList :: [UpdateRole] -> ShowS

Generic UpdateRole

Associated Types

type Rep UpdateRole :: * -> *

Methods

from :: UpdateRole -> Rep UpdateRole x

to :: Rep UpdateRole x -> UpdateRole

Hashable UpdateRole

Methods

hashWithSalt :: Int -> UpdateRole -> Int

hash :: UpdateRole -> Int

NFData UpdateRole

Methods

rnf :: UpdateRole -> ()

AWSRequest 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

Methods

toHeaders :: UpdateRole -> [Header]

ToPath UpdateRole

Methods

toPath :: UpdateRole -> ByteString

ToQuery UpdateRole

Methods

toQuery :: UpdateRole -> QueryString

type Rep UpdateRole

type Rep UpdateRole = D1 * (MetaData "UpdateRole" "Network.AWS.IAM.UpdateRole" "amazonka-iam-1.6.0-CI3f7XZIc4eD0Ehb04tNY7" False) (C1 * (MetaCons "UpdateRole'" PrefixI True) ((:*:) * (S1 * (MetaSel (Just Symbol "_urMaxSessionDuration") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Nat))) ((:*:) * (S1 * (MetaSel (Just Symbol "_urDescription") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) (S1 * (MetaSel (Just Symbol "_urRoleName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * Text)))))

type Rs 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

Methods

(==) :: UpdateRoleResponse -> UpdateRoleResponse -> Bool

(/=) :: UpdateRoleResponse -> UpdateRoleResponse -> Bool

Data UpdateRoleResponse

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

Methods

readsPrec :: Int -> ReadS UpdateRoleResponse

readList :: ReadS [UpdateRoleResponse]

readPrec :: ReadPrec UpdateRoleResponse

readListPrec :: ReadPrec [UpdateRoleResponse]

Show UpdateRoleResponse

Methods

showsPrec :: Int -> UpdateRoleResponse -> ShowS

show :: UpdateRoleResponse -> String

showList :: [UpdateRoleResponse] -> ShowS

Generic UpdateRoleResponse

Associated Types

type Rep UpdateRoleResponse :: * -> *

Methods

from :: UpdateRoleResponse -> Rep UpdateRoleResponse x

to :: Rep UpdateRoleResponse x -> UpdateRoleResponse

NFData UpdateRoleResponse

Methods

rnf :: UpdateRoleResponse -> ()

type Rep UpdateRoleResponse

type Rep UpdateRoleResponse = D1 * (MetaData "UpdateRoleResponse" "Network.AWS.IAM.UpdateRole" "amazonka-iam-1.6.0-CI3f7XZIc4eD0Ehb04tNY7" True) (C1 * (MetaCons "UpdateRoleResponse'" PrefixI True) (S1 * (MetaSel (Just Symbol "_urrsResponseStatus") NoSourceUnpackedness NoSourceStrictness DecidedLazy) (Rec0 * Int)))

Response Lenses

urrsResponseStatus :: Lens' UpdateRoleResponse Int

• - | The response status code.