NAME
Paws::ELBv2 - Perl Interface to AWS Elastic Load Balancing
SYNOPSIS
use Paws;
my $obj = Paws->service('ELBv2');
my $res = $obj->Method(
Arg1 => $val1,
Arg2 => [ 'V1', 'V2' ],
# if Arg3 is an object, the HashRef will be used as arguments to the constructor
# of the arguments type
Arg3 => { Att1 => 'Val1' },
# if Arg4 is an array of objects, the HashRefs will be passed as arguments to
# the constructor of the arguments type
Arg4 => [ { Att1 => 'Val1' }, { Att1 => 'Val2' } ],
);DESCRIPTION
Elastic Load Balancing
A load balancer distributes incoming traffic across targets, such as your EC2 instances. This enables you to increase the availability of your application. The load balancer also monitors the health of its registered targets and ensures that it routes traffic only to healthy targets. You configure your load balancer to accept incoming traffic by specifying one or more listeners, which are configured with a protocol and port number for connections from clients to the load balancer. You configure a target group with a protocol and port number for connections from the load balancer to the targets, and with health check settings to be used when checking the health status of the targets.
Elastic Load Balancing supports two types of load balancers: Classic load balancers and Application load balancers (new). A Classic load balancer makes routing and load balancing decisions either at the transport layer (TCP/SSL) or the application layer (HTTP/HTTPS), and supports either EC2-Classic or a VPC. An Application load balancer makes routing and load balancing decisions at the application layer (HTTP/HTTPS), supports path-based routing, and can route requests to one or more ports on each EC2 instance or container instance in your virtual private cloud (VPC). For more information, see the Elastic Load Balancing User Guide.
This reference covers the 2015-12-01 API, which supports Application load balancers. The 2012-06-01 API supports Classic load balancers.
To get started with an Application load balancer, complete the following tasks:
Create a load balancer using CreateLoadBalancer.
Create a target group using CreateTargetGroup.
Register targets for the target group using RegisterTargets.
Create one or more listeners for your load balancer using CreateListener.
(Optional) Create one or more rules for content routing based on URL using CreateRule.
To delete an Application load balancer and its related resources, complete the following tasks:
Delete the load balancer using DeleteLoadBalancer.
Delete the target group using DeleteTargetGroup.
All Elastic Load Balancing operations are idempotent, which means that they complete at most one time. If you repeat an operation, it succeeds.
METHODS
AddTags(ResourceArns => ArrayRef[Str], Tags => ArrayRef[Paws::ELBv2::Tag])
Each argument is described in detail in: Paws::ELBv2::AddTags
Returns: a Paws::ELBv2::AddTagsOutput instance
Adds the specified tags to the specified resource. You can tag your
Application load balancers and your target groups.Each tag consists of a key and an optional value. If a resource already has a tag with the same key, AddTags updates its value.
To list the current tags for your resources, use DescribeTags. To remove tags from your resources, use RemoveTags.
CreateListener(DefaultActions => ArrayRef[Paws::ELBv2::Action], LoadBalancerArn => Str, Port => Int, Protocol => Str, [Certificates => ArrayRef[Paws::ELBv2::Certificate], SslPolicy => Str])
Each argument is described in detail in: Paws::ELBv2::CreateListener
Returns: a Paws::ELBv2::CreateListenerOutput instance
Creates a listener for the specified Application load balancer.To update a listener, use ModifyListener. When you are finished with a listener, you can delete it using DeleteListener. If you are finished with both the listener and the load balancer, you can delete them both using DeleteLoadBalancer.
For more information, see Listeners for Your Application Load Balancers in the Application Load Balancers Guide.
CreateLoadBalancer(Name => Str, Subnets => ArrayRef[Str], [Scheme => Str, SecurityGroups => ArrayRef[Str], Tags => ArrayRef[Paws::ELBv2::Tag]])
Each argument is described in detail in: Paws::ELBv2::CreateLoadBalancer
Returns: a Paws::ELBv2::CreateLoadBalancerOutput instance
Creates an Application load balancer.To create listeners for your load balancer, use CreateListener. You can add security groups, subnets, and tags when you create your load balancer, or you can add them later using SetSecurityGroups, SetSubnets, and AddTags.
To describe your current load balancers, see DescribeLoadBalancers. When you are finished with a load balancer, you can delete it using DeleteLoadBalancer.
You can create up to 20 load balancers per region per account. You can request an increase for the number of load balancers for your account. For more information, see Limits for Your Application Load Balancer in the Application Load Balancers Guide.
CreateRule(Actions => ArrayRef[Paws::ELBv2::Action], Conditions => ArrayRef[Paws::ELBv2::RuleCondition], ListenerArn => Str, Priority => Int)
Each argument is described in detail in: Paws::ELBv2::CreateRule
Returns: a Paws::ELBv2::CreateRuleOutput instance
Creates a rule for the specified listener.A rule consists conditions and actions. Rules are evaluated in priority order, from the lowest value to the highest value. When the conditions for a rule are met, the specified actions are taken. If no rule's conditions are met, the default actions for the listener are taken.
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.
CreateTargetGroup(Name => Str, Port => Int, Protocol => Str, VpcId => Str, [HealthCheckIntervalSeconds => Int, HealthCheckPath => Str, HealthCheckPort => Str, HealthCheckProtocol => Str, HealthCheckTimeoutSeconds => Int, HealthyThresholdCount => Int, Matcher => Paws::ELBv2::Matcher, UnhealthyThresholdCount => Int])
Each argument is described in detail in: Paws::ELBv2::CreateTargetGroup
Returns: a Paws::ELBv2::CreateTargetGroupOutput instance
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.
DeleteListener(ListenerArn => Str)
Each argument is described in detail in: Paws::ELBv2::DeleteListener
Returns: a Paws::ELBv2::DeleteListenerOutput instance
Deletes the specified listener.Alternatively, your listener is deleted when you delete the load balancer it is attached to using DeleteLoadBalancer.
DeleteLoadBalancer(LoadBalancerArn => Str)
Each argument is described in detail in: Paws::ELBv2::DeleteLoadBalancer
Returns: a Paws::ELBv2::DeleteLoadBalancerOutput instance
Deletes the specified load balancer and its attached listeners.You can't delete a load balancer if deletion protection is enabled. If the load balancer does not exist or has already been deleted, the call succeeds.
Deleting a load balancer does not affect its registered targets. For example, your EC2 instances continue to run and are still registered to their target groups. If you no longer need these EC2 instances, you can stop or terminate them.
DeleteRule(RuleArn => Str)
Each argument is described in detail in: Paws::ELBv2::DeleteRule
Returns: a Paws::ELBv2::DeleteRuleOutput instance
Deletes the specified rule.DeleteTargetGroup(TargetGroupArn => Str)
Each argument is described in detail in: Paws::ELBv2::DeleteTargetGroup
Returns: a Paws::ELBv2::DeleteTargetGroupOutput instance
Deletes the specified target group.You can delete a target group if it is not referenced by any actions. Deleting a target group also deletes any associated health checks.
DeregisterTargets(TargetGroupArn => Str, Targets => ArrayRef[Paws::ELBv2::TargetDescription])
Each argument is described in detail in: Paws::ELBv2::DeregisterTargets
Returns: a Paws::ELBv2::DeregisterTargetsOutput instance
Deregisters the specified targets from the specified target group.
After the targets are deregistered, they no longer receive traffic from
the load balancer.DescribeListeners([ListenerArns => ArrayRef[Str], LoadBalancerArn => Str, Marker => Str, PageSize => Int])
Each argument is described in detail in: Paws::ELBv2::DescribeListeners
Returns: a Paws::ELBv2::DescribeListenersOutput instance
Describes the specified listeners or the listeners for the specified
load balancer. You must specify either a load balancer or one or more
listeners.DescribeLoadBalancerAttributes(LoadBalancerArn => Str)
Each argument is described in detail in: Paws::ELBv2::DescribeLoadBalancerAttributes
Returns: a Paws::ELBv2::DescribeLoadBalancerAttributesOutput instance
Describes the attributes for the specified load balancer.DescribeLoadBalancers([LoadBalancerArns => ArrayRef[Str], Marker => Str, Names => ArrayRef[Str], PageSize => Int])
Each argument is described in detail in: Paws::ELBv2::DescribeLoadBalancers
Returns: a Paws::ELBv2::DescribeLoadBalancersOutput instance
Describes the specified Application load balancers or all of your
Application load balancers.To describe the listeners for a load balancer, use DescribeListeners. To describe the attributes for a load balancer, use DescribeLoadBalancerAttributes.
DescribeRules([ListenerArn => Str, RuleArns => ArrayRef[Str]])
Each argument is described in detail in: Paws::ELBv2::DescribeRules
Returns: a Paws::ELBv2::DescribeRulesOutput instance
Describes the specified rules or the rules for the specified listener.
You must specify either a listener or one or more rules.DescribeSSLPolicies([Marker => Str, Names => ArrayRef[Str], PageSize => Int])
Each argument is described in detail in: Paws::ELBv2::DescribeSSLPolicies
Returns: a Paws::ELBv2::DescribeSSLPoliciesOutput instance
Describes the specified policies or all policies used for SSL
negotiation.Note that the only supported policy at this time is ELBSecurityPolicy-2015-05.
DescribeTags(ResourceArns => ArrayRef[Str])
Each argument is described in detail in: Paws::ELBv2::DescribeTags
Returns: a Paws::ELBv2::DescribeTagsOutput instance
Describes the tags for the specified resources.DescribeTargetGroupAttributes(TargetGroupArn => Str)
Each argument is described in detail in: Paws::ELBv2::DescribeTargetGroupAttributes
Returns: a Paws::ELBv2::DescribeTargetGroupAttributesOutput instance
Describes the attributes for the specified target group.DescribeTargetGroups([LoadBalancerArn => Str, Marker => Str, Names => ArrayRef[Str], PageSize => Int, TargetGroupArns => ArrayRef[Str]])
Each argument is described in detail in: Paws::ELBv2::DescribeTargetGroups
Returns: a Paws::ELBv2::DescribeTargetGroupsOutput instance
Describes the specified target groups or all of your target groups. By
default, all target groups are described. Alternatively, you can
specify one of the following to filter the results: the ARN of the load
balancer, the names of one or more target groups, or the ARNs of one or
more target groups.To describe the targets for a target group, use DescribeTargetHealth. To describe the attributes of a target group, use DescribeTargetGroupAttributes.
DescribeTargetHealth(TargetGroupArn => Str, [Targets => ArrayRef[Paws::ELBv2::TargetDescription]])
Each argument is described in detail in: Paws::ELBv2::DescribeTargetHealth
Returns: a Paws::ELBv2::DescribeTargetHealthOutput instance
Describes the health of the specified targets or all of your targets.ModifyListener(ListenerArn => Str, [Certificates => ArrayRef[Paws::ELBv2::Certificate], DefaultActions => ArrayRef[Paws::ELBv2::Action], Port => Int, Protocol => Str, SslPolicy => Str])
Each argument is described in detail in: Paws::ELBv2::ModifyListener
Returns: a Paws::ELBv2::ModifyListenerOutput instance
Modifies the specified properties of the specified listener.Any properties that you do not specify retain their current values. However, changing the protocol from HTTPS to HTTP removes the security policy and SSL certificate properties. If you change the protocol from HTTP to HTTPS, you must add the security policy.
ModifyLoadBalancerAttributes(Attributes => ArrayRef[Paws::ELBv2::LoadBalancerAttribute], LoadBalancerArn => Str)
Each argument is described in detail in: Paws::ELBv2::ModifyLoadBalancerAttributes
Returns: a Paws::ELBv2::ModifyLoadBalancerAttributesOutput instance
Modifies the specified attributes of the specified load balancer.If any of the specified attributes can't be modified as requested, the call fails. Any existing attributes that you do not modify retain their current values.
ModifyRule(RuleArn => Str, [Actions => ArrayRef[Paws::ELBv2::Action], Conditions => ArrayRef[Paws::ELBv2::RuleCondition]])
Each argument is described in detail in: Paws::ELBv2::ModifyRule
Returns: a Paws::ELBv2::ModifyRuleOutput instance
Modifies the specified rule.Any existing properties that you do not modify retain their current values.
To modify the default action, use ModifyListener.
ModifyTargetGroup(TargetGroupArn => Str, [HealthCheckIntervalSeconds => Int, HealthCheckPath => Str, HealthCheckPort => Str, HealthCheckProtocol => Str, HealthCheckTimeoutSeconds => Int, HealthyThresholdCount => Int, Matcher => Paws::ELBv2::Matcher, UnhealthyThresholdCount => Int])
Each argument is described in detail in: Paws::ELBv2::ModifyTargetGroup
Returns: a Paws::ELBv2::ModifyTargetGroupOutput instance
Modifies the health checks used when evaluating the health state of the
targets in the specified target group.To monitor the health of the targets, use DescribeTargetHealth.
ModifyTargetGroupAttributes(Attributes => ArrayRef[Paws::ELBv2::TargetGroupAttribute], TargetGroupArn => Str)
Each argument is described in detail in: Paws::ELBv2::ModifyTargetGroupAttributes
Returns: a Paws::ELBv2::ModifyTargetGroupAttributesOutput instance
Modifies the specified attributes of the specified target group.RegisterTargets(TargetGroupArn => Str, Targets => ArrayRef[Paws::ELBv2::TargetDescription])
Each argument is described in detail in: Paws::ELBv2::RegisterTargets
Returns: a Paws::ELBv2::RegisterTargetsOutput instance
Registers the specified targets with the specified target group.The target must be in the virtual private cloud (VPC) that you specified for the target group.
To remove a target from a target group, use DeregisterTargets.
RemoveTags(ResourceArns => ArrayRef[Str], TagKeys => ArrayRef[Str])
Each argument is described in detail in: Paws::ELBv2::RemoveTags
Returns: a Paws::ELBv2::RemoveTagsOutput instance
Removes the specified tags from the specified resource.To list the current tags for your resources, use DescribeTags.
SetRulePriorities(RulePriorities => ArrayRef[Paws::ELBv2::RulePriorityPair])
Each argument is described in detail in: Paws::ELBv2::SetRulePriorities
Returns: a Paws::ELBv2::SetRulePrioritiesOutput instance
Sets the priorities of the specified rules.You can reorder the rules as long as there are no priority conflicts in the new order. Any existing rules that you do not specify retain their current priority.
SetSecurityGroups(LoadBalancerArn => Str, SecurityGroups => ArrayRef[Str])
Each argument is described in detail in: Paws::ELBv2::SetSecurityGroups
Returns: a Paws::ELBv2::SetSecurityGroupsOutput instance
Associates the specified security groups with the specified load
balancer. The specified security groups override the previously
associated security groups.SetSubnets(LoadBalancerArn => Str, Subnets => ArrayRef[Str])
Each argument is described in detail in: Paws::ELBv2::SetSubnets
Returns: a Paws::ELBv2::SetSubnetsOutput instance
Enables the Availability Zone for the specified subnets for the
specified load balancer. The specified subnets replace the previously
enabled subnets.SEE ALSO
This service class forms part of Paws
BUGS and CONTRIBUTIONS
The source code is located here: https://github.com/pplu/aws-sdk-perl
Please report bugs to: https://github.com/pplu/aws-sdk-perl/issues