Network.AWS.IAM.CreateServiceLinkedRole

Creates an IAM role that is linked to a specific AWS service. The service controls the attached policies and when the role can be deleted. This helps ensure that the service is not broken by an unexpectedly changed or deleted role, which could put your AWS resources into an unknown state. Allowing the service to control the role helps improve service stability and proper cleanup when a service and its role are no longer needed.

The name of the role is autogenerated by combining the string that you specify for the AWSServiceName parameter with the string that you specify for the CustomSuffix parameter. The resulting name must be unique in your account or the request fails.

To attach a policy to this service-linked role, you must make the request using the AWS service that depends on this role.

Creating a Request

createServiceLinkedRole

Arguments

:: Text

cslrAWSServiceName

-> CreateServiceLinkedRole

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

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

• cslrCustomSuffix - A string that you provide, which is combined with the service name to form the complete role name. If you make multiple requests for the same service, then you must supply a different CustomSuffix for each request. Otherwise the request fails with a duplicate role name error. For example, you could add -1 or -debug to the suffix.
• cslrDescription - The description of the role.
• cslrAWSServiceName - The AWS service to which this role is attached. You use a string similar to a URL but without the http:// in front. For example: elasticbeanstalk.amazonaws.com

data CreateServiceLinkedRole

See: createServiceLinkedRole smart constructor.

Instances

Eq CreateServiceLinkedRole

Methods

(==) :: CreateServiceLinkedRole -> CreateServiceLinkedRole -> Bool

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

Data CreateServiceLinkedRole

Methods

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

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

toConstr :: CreateServiceLinkedRole -> Constr

dataTypeOf :: CreateServiceLinkedRole -> DataType

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

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

gmapT :: (forall b. Data b => b -> b) -> CreateServiceLinkedRole -> CreateServiceLinkedRole

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

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

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

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

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

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

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

Read CreateServiceLinkedRole

Methods

readsPrec :: Int -> ReadS CreateServiceLinkedRole

readList :: ReadS [CreateServiceLinkedRole]

readPrec :: ReadPrec CreateServiceLinkedRole

readListPrec :: ReadPrec [CreateServiceLinkedRole]

Show CreateServiceLinkedRole

Methods

showsPrec :: Int -> CreateServiceLinkedRole -> ShowS

show :: CreateServiceLinkedRole -> String

showList :: [CreateServiceLinkedRole] -> ShowS

Generic CreateServiceLinkedRole

Associated Types

type Rep CreateServiceLinkedRole :: * -> *

Methods

from :: CreateServiceLinkedRole -> Rep CreateServiceLinkedRole x

to :: Rep CreateServiceLinkedRole x -> CreateServiceLinkedRole

Hashable CreateServiceLinkedRole

Methods

hashWithSalt :: Int -> CreateServiceLinkedRole -> Int

hash :: CreateServiceLinkedRole -> Int

NFData CreateServiceLinkedRole

Methods

rnf :: CreateServiceLinkedRole -> ()

AWSRequest CreateServiceLinkedRole

Associated Types

type Rs CreateServiceLinkedRole :: *

Methods

request :: CreateServiceLinkedRole -> Request CreateServiceLinkedRole

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

ToQuery CreateServiceLinkedRole

Methods

toQuery :: CreateServiceLinkedRole -> QueryString

ToPath CreateServiceLinkedRole

Methods

toPath :: CreateServiceLinkedRole -> ByteString

ToHeaders CreateServiceLinkedRole

Methods

toHeaders :: CreateServiceLinkedRole -> [Header]

type Rep CreateServiceLinkedRole

type Rep CreateServiceLinkedRole = D1 (MetaData "CreateServiceLinkedRole" "Network.AWS.IAM.CreateServiceLinkedRole" "amazonka-iam-1.5.0-2w4nVHAOrDgI2P1QVLKd9e" False) (C1 (MetaCons "CreateServiceLinkedRole'" PrefixI True) ((:*:) (S1 (MetaSel (Just Symbol "_cslrCustomSuffix") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) ((:*:) (S1 (MetaSel (Just Symbol "_cslrDescription") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_cslrAWSServiceName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text)))))

type Rs CreateServiceLinkedRole

type Rs CreateServiceLinkedRole = CreateServiceLinkedRoleResponse

Request Lenses

cslrCustomSuffix :: Lens' CreateServiceLinkedRole (Maybe Text)

A string that you provide, which is combined with the service name to form the complete role name. If you make multiple requests for the same service, then you must supply a different CustomSuffix for each request. Otherwise the request fails with a duplicate role name error. For example, you could add -1 or -debug to the suffix.

cslrDescription :: Lens' CreateServiceLinkedRole (Maybe Text)

The description of the role.

cslrAWSServiceName :: Lens' CreateServiceLinkedRole Text

The AWS service to which this role is attached. You use a string similar to a URL but without the http:// in front. For example: elasticbeanstalk.amazonaws.com

Destructuring the Response

createServiceLinkedRoleResponse

Arguments

:: Int

cslrrsResponseStatus

-> CreateServiceLinkedRoleResponse

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

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

• cslrrsRole - A Role object that contains details about the newly created role.
• cslrrsResponseStatus - -- | The response status code.

data CreateServiceLinkedRoleResponse

See: createServiceLinkedRoleResponse smart constructor.

Instances

Eq CreateServiceLinkedRoleResponse

Methods

(==) :: CreateServiceLinkedRoleResponse -> CreateServiceLinkedRoleResponse -> Bool

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

Data CreateServiceLinkedRoleResponse

Methods

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

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

toConstr :: CreateServiceLinkedRoleResponse -> Constr

dataTypeOf :: CreateServiceLinkedRoleResponse -> DataType

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

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

gmapT :: (forall b. Data b => b -> b) -> CreateServiceLinkedRoleResponse -> CreateServiceLinkedRoleResponse

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

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

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

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

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

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

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

Read CreateServiceLinkedRoleResponse

Methods

readsPrec :: Int -> ReadS CreateServiceLinkedRoleResponse

readList :: ReadS [CreateServiceLinkedRoleResponse]

readPrec :: ReadPrec CreateServiceLinkedRoleResponse

readListPrec :: ReadPrec [CreateServiceLinkedRoleResponse]

Show CreateServiceLinkedRoleResponse

Methods

showsPrec :: Int -> CreateServiceLinkedRoleResponse -> ShowS

show :: CreateServiceLinkedRoleResponse -> String

showList :: [CreateServiceLinkedRoleResponse] -> ShowS

Generic CreateServiceLinkedRoleResponse

Associated Types

type Rep CreateServiceLinkedRoleResponse :: * -> *

Methods

from :: CreateServiceLinkedRoleResponse -> Rep CreateServiceLinkedRoleResponse x

to :: Rep CreateServiceLinkedRoleResponse x -> CreateServiceLinkedRoleResponse

NFData CreateServiceLinkedRoleResponse

Methods

rnf :: CreateServiceLinkedRoleResponse -> ()

type Rep CreateServiceLinkedRoleResponse

type Rep CreateServiceLinkedRoleResponse = D1 (MetaData "CreateServiceLinkedRoleResponse" "Network.AWS.IAM.CreateServiceLinkedRole" "amazonka-iam-1.5.0-2w4nVHAOrDgI2P1QVLKd9e" False) (C1 (MetaCons "CreateServiceLinkedRoleResponse'" PrefixI True) ((:*:) (S1 (MetaSel (Just Symbol "_cslrrsRole") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Role))) (S1 (MetaSel (Just Symbol "_cslrrsResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Int))))

Response Lenses

cslrrsRole :: Lens' CreateServiceLinkedRoleResponse (Maybe Role)

A Role object that contains details about the newly created role.

cslrrsResponseStatus :: Lens' CreateServiceLinkedRoleResponse Int

• - | The response status code.