Network.AWS.ELBv2.CreateTargetGroup

Creates a target group.

To register targets with the target group, use RegisterTargets . To update the health check settings for the target group, use ModifyTargetGroup . To monitor the health of targets in the target group, use DescribeTargetHealth .

To route traffic to the targets in a target group, specify the target group in an action using CreateListener or CreateRule .

To delete a target group, use DeleteTargetGroup .

For more information, see Target Groups for Your Application Load Balancers in the Application Load Balancers Guide .

Creating a Request

createTargetGroup

Arguments

:: Text

ctgName

-> ProtocolEnum

ctgProtocol

-> Natural

ctgPort

-> Text

ctgVPCId

-> CreateTargetGroup

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

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

• ctgMatcher - The HTTP codes to use when checking for a successful response from a target. The default is 200.
• ctgHealthCheckPath - The ping path that is the destination on the targets for health checks. The default is /.
• ctgUnhealthyThresholdCount - The number of consecutive health check failures required before considering a target unhealthy. The default is 2.
• ctgHealthCheckIntervalSeconds - The approximate amount of time, in seconds, between health checks of an individual target. The default is 30 seconds.
• ctgHealthyThresholdCount - The number of consecutive health checks successes required before considering an unhealthy target healthy. The default is 5.
• ctgHealthCheckProtocol - The protocol the load balancer uses when performing health checks on targets. The default is the HTTP protocol.
• ctgHealthCheckTimeoutSeconds - The amount of time, in seconds, during which no response from a target means a failed health check. The default is 5 seconds.
• ctgHealthCheckPort - The port the load balancer uses when performing health checks on targets. The default is traffic-port , which indicates the port on which each target receives traffic from the load balancer.
• ctgName - The name of the target group.
• ctgProtocol - The protocol to use for routing traffic to the targets.
• ctgPort - The port on which the targets receive traffic. This port is used unless you specify a port override when registering the target.
• ctgVPCId - The identifier of the virtual private cloud (VPC).

data CreateTargetGroup

Contains the parameters for CreateTargetGroup.

See: createTargetGroup smart constructor.

Instances

Eq CreateTargetGroup

Methods

(==) :: CreateTargetGroup -> CreateTargetGroup -> Bool

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

Data CreateTargetGroup

Methods

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

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

toConstr :: CreateTargetGroup -> Constr

dataTypeOf :: CreateTargetGroup -> DataType

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

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

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

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

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

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

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

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

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

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

Read CreateTargetGroup

Methods

readsPrec :: Int -> ReadS CreateTargetGroup

readList :: ReadS [CreateTargetGroup]

readPrec :: ReadPrec CreateTargetGroup

readListPrec :: ReadPrec [CreateTargetGroup]

Show CreateTargetGroup

Methods

showsPrec :: Int -> CreateTargetGroup -> ShowS

show :: CreateTargetGroup -> String

showList :: [CreateTargetGroup] -> ShowS

Generic CreateTargetGroup

Associated Types

type Rep CreateTargetGroup :: * -> *

Methods

from :: CreateTargetGroup -> Rep CreateTargetGroup x

to :: Rep CreateTargetGroup x -> CreateTargetGroup

Hashable CreateTargetGroup

Methods

hashWithSalt :: Int -> CreateTargetGroup -> Int

hash :: CreateTargetGroup -> Int

NFData CreateTargetGroup

Methods

rnf :: CreateTargetGroup -> ()

AWSRequest CreateTargetGroup

Associated Types

type Rs CreateTargetGroup :: *

Methods

request :: CreateTargetGroup -> Request CreateTargetGroup

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

ToPath CreateTargetGroup

Methods

toPath :: CreateTargetGroup -> ByteString

ToHeaders CreateTargetGroup

Methods

toHeaders :: CreateTargetGroup -> [Header]

ToQuery CreateTargetGroup

Methods

toQuery :: CreateTargetGroup -> QueryString

type Rep CreateTargetGroup

type Rep CreateTargetGroup = D1 (MetaData "CreateTargetGroup" "Network.AWS.ELBv2.CreateTargetGroup" "amazonka-elbv2-1.4.5-J8ZeSE6X9TjH6Y7FrPuIXa" False) (C1 (MetaCons "CreateTargetGroup'" PrefixI True) ((:*:) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_ctgMatcher") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Matcher))) ((:*:) (S1 (MetaSel (Just Symbol "_ctgHealthCheckPath") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_ctgUnhealthyThresholdCount") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Nat))))) ((:*:) (S1 (MetaSel (Just Symbol "_ctgHealthCheckIntervalSeconds") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Nat))) ((:*:) (S1 (MetaSel (Just Symbol "_ctgHealthyThresholdCount") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Nat))) (S1 (MetaSel (Just Symbol "_ctgHealthCheckProtocol") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe ProtocolEnum)))))) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_ctgHealthCheckTimeoutSeconds") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Nat))) ((:*:) (S1 (MetaSel (Just Symbol "_ctgHealthCheckPort") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_ctgName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text)))) ((:*:) (S1 (MetaSel (Just Symbol "_ctgProtocol") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 ProtocolEnum)) ((:*:) (S1 (MetaSel (Just Symbol "_ctgPort") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Nat)) (S1 (MetaSel (Just Symbol "_ctgVPCId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text)))))))

type Rs CreateTargetGroup

type Rs CreateTargetGroup = CreateTargetGroupResponse

Request Lenses

ctgMatcher :: Lens' CreateTargetGroup (Maybe Matcher)

The HTTP codes to use when checking for a successful response from a target. The default is 200.

ctgHealthCheckPath :: Lens' CreateTargetGroup (Maybe Text)

The ping path that is the destination on the targets for health checks. The default is /.

ctgUnhealthyThresholdCount :: Lens' CreateTargetGroup (Maybe Natural)

The number of consecutive health check failures required before considering a target unhealthy. The default is 2.

ctgHealthCheckIntervalSeconds :: Lens' CreateTargetGroup (Maybe Natural)

The approximate amount of time, in seconds, between health checks of an individual target. The default is 30 seconds.

ctgHealthyThresholdCount :: Lens' CreateTargetGroup (Maybe Natural)

The number of consecutive health checks successes required before considering an unhealthy target healthy. The default is 5.

ctgHealthCheckProtocol :: Lens' CreateTargetGroup (Maybe ProtocolEnum)

The protocol the load balancer uses when performing health checks on targets. The default is the HTTP protocol.

ctgHealthCheckTimeoutSeconds :: Lens' CreateTargetGroup (Maybe Natural)

The amount of time, in seconds, during which no response from a target means a failed health check. The default is 5 seconds.

ctgHealthCheckPort :: Lens' CreateTargetGroup (Maybe Text)

The port the load balancer uses when performing health checks on targets. The default is traffic-port , which indicates the port on which each target receives traffic from the load balancer.

ctgName :: Lens' CreateTargetGroup Text

The name of the target group.

ctgProtocol :: Lens' CreateTargetGroup ProtocolEnum

The protocol to use for routing traffic to the targets.

ctgPort :: Lens' CreateTargetGroup Natural

The port on which the targets receive traffic. This port is used unless you specify a port override when registering the target.

ctgVPCId :: Lens' CreateTargetGroup Text

The identifier of the virtual private cloud (VPC).

Destructuring the Response

createTargetGroupResponse

Arguments

:: Int

ctgrsResponseStatus

-> CreateTargetGroupResponse

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

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

• ctgrsTargetGroups - Information about the target group.
• ctgrsResponseStatus - -- | The response status code.

data CreateTargetGroupResponse

Contains the output of CreateTargetGroup.

See: createTargetGroupResponse smart constructor.

Instances

Eq CreateTargetGroupResponse

Methods

(==) :: CreateTargetGroupResponse -> CreateTargetGroupResponse -> Bool

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

Data CreateTargetGroupResponse

Methods

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

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

toConstr :: CreateTargetGroupResponse -> Constr

dataTypeOf :: CreateTargetGroupResponse -> DataType

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

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

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

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

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

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

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

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

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

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

Read CreateTargetGroupResponse

Methods

readsPrec :: Int -> ReadS CreateTargetGroupResponse

readList :: ReadS [CreateTargetGroupResponse]

readPrec :: ReadPrec CreateTargetGroupResponse

readListPrec :: ReadPrec [CreateTargetGroupResponse]

Show CreateTargetGroupResponse

Methods

showsPrec :: Int -> CreateTargetGroupResponse -> ShowS

show :: CreateTargetGroupResponse -> String

showList :: [CreateTargetGroupResponse] -> ShowS

Generic CreateTargetGroupResponse

Associated Types

type Rep CreateTargetGroupResponse :: * -> *

Methods

from :: CreateTargetGroupResponse -> Rep CreateTargetGroupResponse x

to :: Rep CreateTargetGroupResponse x -> CreateTargetGroupResponse

NFData CreateTargetGroupResponse

Methods

rnf :: CreateTargetGroupResponse -> ()

type Rep CreateTargetGroupResponse

type Rep CreateTargetGroupResponse = D1 (MetaData "CreateTargetGroupResponse" "Network.AWS.ELBv2.CreateTargetGroup" "amazonka-elbv2-1.4.5-J8ZeSE6X9TjH6Y7FrPuIXa" False) (C1 (MetaCons "CreateTargetGroupResponse'" PrefixI True) ((:*:) (S1 (MetaSel (Just Symbol "_ctgrsTargetGroups") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [TargetGroup]))) (S1 (MetaSel (Just Symbol "_ctgrsResponseStatus") NoSourceUnpackedness SourceStrict DecidedUnpack) (Rec0 Int))))

Response Lenses

ctgrsTargetGroups :: Lens' CreateTargetGroupResponse [TargetGroup]

Information about the target group.

ctgrsResponseStatus :: Lens' CreateTargetGroupResponse Int

• - | The response status code.