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
• ctgHealthCheckPath
• ctgUnhealthyThresholdCount
• ctgHealthCheckIntervalSeconds
• ctgHealthyThresholdCount
• ctgHealthCheckProtocol
• ctgHealthCheckTimeoutSeconds
• ctgHealthCheckPort
• ctgName
• ctgProtocol
• ctgPort
• ctgVPCId

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.4-J3raiqTtsWzGRG4vqY4F1A" 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
• ctgrsResponseStatus

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.4-J3raiqTtsWzGRG4vqY4F1A" 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.