amazonka-iam-1.4.5: Amazon Identity and Access Management SDK.

Copyright(c) 2013-2016 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <brendan.g.hay@gmail.com>
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellNone
LanguageHaskell2010

Network.AWS.IAM.CreateRole

Contents

Description

Creates a new role for your AWS account. For more information about roles, go to Working with Roles . For information about limitations on role names and the number of roles you can create, go to Limitations on IAM Entities in the IAM User Guide .

Synopsis

Creating a Request

createRole #

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

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

  • crPath - The path to the role. For more information about paths, see IAM Identifiers in the IAM User Guide . This parameter is optional. If it is not included, it defaults to a slash (). The <http:wikipedia.orgwikiregex 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.
  • crRoleName - The name of the role to create. 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: =,.@-. Role names are not distinguished by case. For example, you cannot create roles named both PRODROLE and "prodrole".
  • crAssumeRolePolicyDocument - The trust relationship policy document that grants an entity permission to assume the role. The regex pattern for this parameter is a string of characters consisting of any printable ASCII character ranging from the space character (u0020) through end of the ASCII character range (u00FF). It also includes the special characters tab (u0009), line feed (u000A), and carriage return (u000D).

data CreateRole #

See: createRole smart constructor.

Instances

Eq CreateRole # 
Data CreateRole # 

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> CreateRole -> c CreateRole #

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c CreateRole #

toConstr :: CreateRole -> Constr #

dataTypeOf :: CreateRole -> DataType #

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c CreateRole) #

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c CreateRole) #

gmapT :: (forall b. Data b => b -> b) -> CreateRole -> CreateRole #

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> CreateRole -> r #

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> CreateRole -> r #

gmapQ :: (forall d. Data d => d -> u) -> CreateRole -> [u] #

gmapQi :: Int -> (forall d. Data d => d -> u) -> CreateRole -> u #

gmapM :: Monad m => (forall d. Data d => d -> m d) -> CreateRole -> m CreateRole #

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> CreateRole -> m CreateRole #

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> CreateRole -> m CreateRole #

Read CreateRole # 
Show CreateRole # 
Generic CreateRole # 

Associated Types

type Rep CreateRole :: * -> * #

Hashable CreateRole # 
NFData CreateRole # 

Methods

rnf :: CreateRole -> () #

AWSRequest CreateRole # 
ToQuery CreateRole # 
ToPath CreateRole # 
ToHeaders CreateRole # 

Methods

toHeaders :: CreateRole -> [Header] #

type Rep CreateRole # 
type Rep CreateRole = D1 (MetaData "CreateRole" "Network.AWS.IAM.CreateRole" "amazonka-iam-1.4.5-1ijrgQyRuWgA7Tx0390Dx2" False) (C1 (MetaCons "CreateRole'" PrefixI True) ((:*:) (S1 (MetaSel (Just Symbol "_crPath") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) ((:*:) (S1 (MetaSel (Just Symbol "_crRoleName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text)) (S1 (MetaSel (Just Symbol "_crAssumeRolePolicyDocument") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text)))))
type Rs CreateRole # 

Request Lenses

crPath :: Lens' CreateRole (Maybe Text) #

The path to the role. For more information about paths, see IAM Identifiers in the IAM User Guide . This parameter is optional. If it is not included, it defaults to a slash (). The <http:wikipedia.orgwikiregex 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.

crRoleName :: Lens' CreateRole Text #

The name of the role to create. 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: =,.@-. Role names are not distinguished by case. For example, you cannot create roles named both PRODROLE and "prodrole".

crAssumeRolePolicyDocument :: Lens' CreateRole Text #

The trust relationship policy document that grants an entity permission to assume the role. The regex pattern for this parameter is a string of characters consisting of any printable ASCII character ranging from the space character (u0020) through end of the ASCII character range (u00FF). It also includes the special characters tab (u0009), line feed (u000A), and carriage return (u000D).

Destructuring the Response

createRoleResponse #

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

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

data CreateRoleResponse #

Contains the response to a successful CreateRole request.

See: createRoleResponse smart constructor.

Instances

Eq CreateRoleResponse # 
Data CreateRoleResponse # 

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> CreateRoleResponse -> c CreateRoleResponse #

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c CreateRoleResponse #

toConstr :: CreateRoleResponse -> Constr #

dataTypeOf :: CreateRoleResponse -> DataType #

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c CreateRoleResponse) #

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c CreateRoleResponse) #

gmapT :: (forall b. Data b => b -> b) -> CreateRoleResponse -> CreateRoleResponse #

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> CreateRoleResponse -> r #

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> CreateRoleResponse -> r #

gmapQ :: (forall d. Data d => d -> u) -> CreateRoleResponse -> [u] #

gmapQi :: Int -> (forall d. Data d => d -> u) -> CreateRoleResponse -> u #

gmapM :: Monad m => (forall d. Data d => d -> m d) -> CreateRoleResponse -> m CreateRoleResponse #

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> CreateRoleResponse -> m CreateRoleResponse #

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> CreateRoleResponse -> m CreateRoleResponse #

Read CreateRoleResponse # 
Show CreateRoleResponse # 
Generic CreateRoleResponse # 
NFData CreateRoleResponse # 

Methods

rnf :: CreateRoleResponse -> () #

type Rep CreateRoleResponse # 
type Rep CreateRoleResponse = D1 (MetaData "CreateRoleResponse" "Network.AWS.IAM.CreateRole" "amazonka-iam-1.4.5-1ijrgQyRuWgA7Tx0390Dx2" False) (C1 (MetaCons "CreateRoleResponse'" PrefixI True) ((:*:) (S1 (MetaSel (Just Symbol "_crrsResponseStatus") NoSourceUnpackedness SourceStrict DecidedUnpack) (Rec0 Int)) (S1 (MetaSel (Just Symbol "_crrsRole") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Role))))

Response Lenses

crrsResponseStatus :: Lens' CreateRoleResponse Int #

  • - | The response status code.

crrsRole :: Lens' CreateRoleResponse Role #

A structure containing details about the new role.