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.GetRole

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

Retrieves information about the specified role, including the role's path, GUID, ARN, and the role's trust policy that grants permission to assume the role. For more information about roles, see Working with Roles .

Synopsis

getRole :: Text -> GetRole
data GetRole
grRoleName :: Lens' GetRole Text
getRoleResponse :: Int -> Role -> GetRoleResponse
data GetRoleResponse
grrsResponseStatus :: Lens' GetRoleResponse Int
grrsRole :: Lens' GetRoleResponse Role

Creating a Request

getRole #

Arguments

:: Text	`grRoleName`
-> GetRole

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

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

grRoleName - The name of the IAM role to get information about. This parameter allows (per its regex pattern ) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

data GetRole #

See: getRole smart constructor.

Instances

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

Request Lenses

grRoleName :: Lens' GetRole Text #

The name of the IAM role to get information about. This parameter allows (per its regex pattern ) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

Destructuring the Response

getRoleResponse #

Arguments

:: Int	`grrsResponseStatus`
-> Role	`grrsRole`
-> GetRoleResponse

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

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

grrsResponseStatus - -- | The response status code.
grrsRole - A structure containing details about the IAM role.

data GetRoleResponse #

Contains the response to a successful GetRole request.

See: getRoleResponse smart constructor.

Instances

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

Response Lenses

grrsResponseStatus :: Lens' GetRoleResponse Int #

- | The response status code.

grrsRole :: Lens' GetRoleResponse Role #

A structure containing details about the IAM role.