Network.AWS.IAM.GetRole

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.

Policies returned by this API are URL-encoded compliant with RFC 3986. You can use a URL decoding method to convert the policy back to plain JSON text. For example, if you use Java, you can use the decode method of the 'java.net.URLDecoder' utility class in the Java SDK. Other languages and SDKs provide similar functionality.

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

data GetRole

See: getRole smart constructor.

Instances

Eq GetRole

Methods

(==) :: GetRole -> GetRole -> Bool

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

Data 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

Methods

readsPrec :: Int -> ReadS GetRole

readList :: ReadS [GetRole]

readPrec :: ReadPrec GetRole

readListPrec :: ReadPrec [GetRole]

Show GetRole

Methods

showsPrec :: Int -> GetRole -> ShowS

show :: GetRole -> String

showList :: [GetRole] -> ShowS

Generic GetRole

Associated Types

type Rep GetRole :: * -> *

Methods

from :: GetRole -> Rep GetRole x

to :: Rep GetRole x -> GetRole

Hashable GetRole

Methods

hashWithSalt :: Int -> GetRole -> Int

hash :: GetRole -> Int

NFData GetRole

Methods

rnf :: GetRole -> ()

AWSRequest GetRole

Associated Types

type Rs GetRole :: *

Methods

request :: GetRole -> Request GetRole

response :: MonadResource m => Logger -> Service -> Proxy * GetRole -> ClientResponse -> m (Response GetRole)

ToPath GetRole

Methods

toPath :: GetRole -> ByteString

ToHeaders GetRole

Methods

toHeaders :: GetRole -> [Header]

ToQuery GetRole

Methods

toQuery :: GetRole -> QueryString

type Rep GetRole

type Rep GetRole = D1 (MetaData "GetRole" "Network.AWS.IAM.GetRole" "amazonka-iam-1.4.4-BicPZt3TaHh2CoAkQqkWBu" True) (C1 (MetaCons "GetRole'" PrefixI True) (S1 (MetaSel (Just Symbol "_grRoleName") NoSourceUnpackedness NoSourceStrictness DecidedLazy) (Rec0 Text)))

type Rs GetRole

type Rs GetRole = GetRoleResponse

Request Lenses

grRoleName :: Lens' GetRole Text

The name of the IAM role to get information about.

The 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: =,.'-

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
• grrsRole

data GetRoleResponse

Contains the response to a successful GetRole request.

See: getRoleResponse smart constructor.

Instances

Eq GetRoleResponse

Methods

(==) :: GetRoleResponse -> GetRoleResponse -> Bool

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

Data GetRoleResponse

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

Methods

readsPrec :: Int -> ReadS GetRoleResponse

readList :: ReadS [GetRoleResponse]

readPrec :: ReadPrec GetRoleResponse

readListPrec :: ReadPrec [GetRoleResponse]

Show GetRoleResponse

Methods

showsPrec :: Int -> GetRoleResponse -> ShowS

show :: GetRoleResponse -> String

showList :: [GetRoleResponse] -> ShowS

Generic GetRoleResponse

Associated Types

type Rep GetRoleResponse :: * -> *

Methods

from :: GetRoleResponse -> Rep GetRoleResponse x

to :: Rep GetRoleResponse x -> GetRoleResponse

NFData GetRoleResponse

Methods

rnf :: GetRoleResponse -> ()

type Rep GetRoleResponse

type Rep GetRoleResponse = D1 (MetaData "GetRoleResponse" "Network.AWS.IAM.GetRole" "amazonka-iam-1.4.4-BicPZt3TaHh2CoAkQqkWBu" False) (C1 (MetaCons "GetRoleResponse'" PrefixI True) ((:*:) (S1 (MetaSel (Just Symbol "_grrsResponseStatus") NoSourceUnpackedness SourceStrict DecidedUnpack) (Rec0 Int)) (S1 (MetaSel (Just Symbol "_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.