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.ELBv2.CreateRule

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

Creates a rule for the specified listener. The listener must be associated with an Application Load Balancer.

Rules are evaluated in priority order, from the lowest value to the highest value. When the condition for a rule is met, the specified action is taken. If no conditions are met, the action for the default rule is taken. For more information, see Listener Rules in the Application Load Balancers Guide .

To view your current rules, use DescribeRules . To update a rule, use ModifyRule . To set the priorities of your rules, use SetRulePriorities . To delete a rule, use DeleteRule .

Synopsis

createRule :: Text -> Natural -> CreateRule
data CreateRule
crListenerARN :: Lens' CreateRule Text
crConditions :: Lens' CreateRule [RuleCondition]
crPriority :: Lens' CreateRule Natural
crActions :: Lens' CreateRule [Action]
createRuleResponse :: Int -> CreateRuleResponse
data CreateRuleResponse
crrsRules :: Lens' CreateRuleResponse [Rule]
crrsResponseStatus :: Lens' CreateRuleResponse Int

Creating a Request

createRule #

Arguments

:: Text	`crListenerARN`
-> Natural	`crPriority`
-> CreateRule

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

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

crListenerARN - The Amazon Resource Name (ARN) of the listener.
crConditions - The conditions. Each condition specifies a field name and a single value. If the field name is host-header , you can specify a single host name (for example, my.example.com). A host name is case insensitive, can be up to 128 characters in length, and can contain any of the following characters. Note that you can include up to three wildcard characters. * A-Z, a-z, 0-9 * - . * * (matches 0 or more characters) * ? (matches exactly 1 character) If the field name is path-pattern , you can specify a single path pattern. A path pattern is case sensitive, can be up to 128 characters in length, and can contain any of the following characters. Note that you can include up to three wildcard characters. * A-Z, a-z, 0-9 * _ - . $ / ~ " ' @ : + * & (using &) * * (matches 0 or more characters) * ? (matches exactly 1 character)
crPriority - The priority for the rule. A listener can't have multiple rules with the same priority.
crActions - An action. Each action has the type forward and specifies a target group.

data CreateRule #

See: createRule smart constructor.

Instances

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

Request Lenses

crListenerARN :: Lens' CreateRule Text #

The Amazon Resource Name (ARN) of the listener.

crConditions :: Lens' CreateRule [RuleCondition] #

The conditions. Each condition specifies a field name and a single value. If the field name is host-header , you can specify a single host name (for example, my.example.com). A host name is case insensitive, can be up to 128 characters in length, and can contain any of the following characters. Note that you can include up to three wildcard characters. * A-Z, a-z, 0-9 * - . * * (matches 0 or more characters) * ? (matches exactly 1 character) If the field name is path-pattern , you can specify a single path pattern. A path pattern is case sensitive, can be up to 128 characters in length, and can contain any of the following characters. Note that you can include up to three wildcard characters. * A-Z, a-z, 0-9 * _ - . $ / ~ " ' @ : + * & (using &) * * (matches 0 or more characters) * ? (matches exactly 1 character)

crPriority :: Lens' CreateRule Natural #

The priority for the rule. A listener can't have multiple rules with the same priority.

crActions :: Lens' CreateRule [Action] #

An action. Each action has the type forward and specifies a target group.

Destructuring the Response

createRuleResponse #

Arguments

:: Int	`crrsResponseStatus`
-> CreateRuleResponse

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

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

crrsRules - Information about the rule.
crrsResponseStatus - -- | The response status code.

data CreateRuleResponse #

See: createRuleResponse smart constructor.

Instances

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

Response Lenses

crrsRules :: Lens' CreateRuleResponse [Rule] #

Information about the rule.

crrsResponseStatus :: Lens' CreateRuleResponse Int #

- | The response status code.