.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.42) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "VM::EC2::ELB 3pm" .TH VM::EC2::ELB 3pm "2022-10-14" "perl v5.34.0" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" VM::EC2::ELB \-\- Object describing an Elastic Load Balancer .SH "SYNOPSIS" .IX Header "SYNOPSIS" .Vb 1 \& use VM::EC2; \& \& $ec2 = VM::EC2\->new(...); \& $lb = $ec2\->create_load_balancer(%args); \& or \& $lb = $ec2\->describe_load_balancers(\-load_balancer_name=>\*(Aqmy\-lb\*(Aq); \& \& @zones = $lb\->AvailabilityZones; \& $created = $lb\->CreatedTime; \& $dns_name = $lb\->DNSName; \& $health_check = $lb\->HealthCheck; \& @instances = $lb\->Instances; \& @list_desc = $lb\->ListenerDescriptions; \& $name = $lb\->LoadBalancerName; \& @policies_obj = $lb\->Policies; \& @policies = $lb\->describe_policies(\-policy_names=>\*(Aqmypolicy\*(Aq); \& $scheme = $lb\->Scheme; \& $sg_name = $lb\->SourceSecurityGroup; \& $success = $lb\->create_load_balancer_listeners(%args); \& $success = $lb\->enable_availability_zones_for_load_balancer(@zones); \& @list = $lb\->register_instances_with_load_balancer(\-instances => \*(Aqi\-12345678\*(Aq); \& $state = $lb\->describe_instance_health(\-instances => \*(Aqi\-12345678\*(Aq) \& $success = $lb\->delete_load_balancer; .Ve .SH "DESCRIPTION" .IX Header "DESCRIPTION" This object represents an Amazon Elastic Load Balancer and is returned by \&\s-1VM::EC2\-\s0>\fBdescribe_load_balancers()\fR and \s-1VM::EC2\-\s0>\fBcreate_load_balancer()\fR. In addition to methods to query the \s-1ELB\s0's attributes, there are methods that manage the \s-1ELB\s0's lifecycle and properties. .SH "METHODS" .IX Header "METHODS" The following object methods are supported: .PP .Vb 10 \& AvailabilityZones \-\- The enabled availability zones for the ELB in the \& form of an array of L \& objects. \& BackendServerDescriptions \-\- The backend server descriptions. \& CreatedTime \-\- The creation date of the ELB. \& DNSName \-\- The DNS name of the ELB. \& HealthCheck \-\- The health check associated with the ELB in the \& form of a L object. \& Instances \-\- The instances that the ELB points to, in the form \& of an array of L objects. \& ListenerDescriptions \-\- An array of L \& objects. \& LoadBalancerName \-\- The name of the ELB \& Policies \-\- The policies of the ELB in the form of a \& L object. \& Scheme \-\- Specifies the type of ELB (\*(Aqinternal\*(Aq is for VPC \& only.) \& SecurityGroups \-\- The security groups the ELB is a member of (VPC \& only) in the form of L \& objects. \& SourceSecurityGroup \-\- The security group that the ELB is a member of \& Subnets \-\- Provides an array of VPC subnet objects \& (L) that the ELB is part of. \& VPCId \-\- Provides the ID of the VPC attached to the ELB. .Ve .PP \&\*(L"Unimplemented/untested\*(R" object methods related to Route 53 (return raw data/ data structures): .PP .Vb 4 \& CanonicalHostedZoneName \-\- The name of the Amazon Route 53 hosted zone that \& is associated with the ELB. \& CanonicalHostedZoneNameID \-\- The ID of the Amazon Route 53 hosted zone name \& that is associated with the ELB. .Ve .PP The following convenience methods are supported; .PP .Vb 8 \& active_policies \-\- Returns the policies that are actively in use by \& the ELB in the form of L \& objects. \& all_policies \-\- Returns all policies that are associated with the \& ELB in the form of L \& objects. \& listeners \-\- Provides the L objects \& associated with the ELB .Ve .SH "LIFECYCLE METHODS" .IX Header "LIFECYCLE METHODS" .ie n .SS "$success = $elb\->delete_load_balancer =head2 $success = $elb\->delete" .el .SS "\f(CW$success\fP = \f(CW$elb\fP\->delete_load_balancer =head2 \f(CW$success\fP = \f(CW$elb\fP\->delete" .IX Subsection "$success = $elb->delete_load_balancer =head2 $success = $elb->delete" This method deletes the \s-1ELB.\s0 Returns true on success. .ie n .SS "$success = $elb\->create_app_cookie_stickiness_policy(\-cookie_name=>$cookie_name,\-policy_name=>$policy_name)" .el .SS "\f(CW$success\fP = \f(CW$elb\fP\->create_app_cookie_stickiness_policy(\-cookie_name=>$cookie_name,\-policy_name=>$policy_name)" .IX Subsection "$success = $elb->create_app_cookie_stickiness_policy(-cookie_name=>$cookie_name,-policy_name=>$policy_name)" Generates a stickiness policy with sticky session lifetimes that follow that of an application-generated cookie. This policy can be associated only with \&\s-1HTTP/HTTPS\s0 listeners. Returns true on success. .ie n .SS "$success = $elb\->create_lb_cookie_stickiness_policy(\-cookie_expiration_period=>$secs,\-policy_name=>$name)" .el .SS "\f(CW$success\fP = \f(CW$elb\fP\->create_lb_cookie_stickiness_policy(\-cookie_expiration_period=>$secs,\-policy_name=>$name)" .IX Subsection "$success = $elb->create_lb_cookie_stickiness_policy(-cookie_expiration_period=>$secs,-policy_name=>$name)" Generates a stickiness policy with sticky session lifetimes controlled by the lifetime of the browser (user-agent) or a specified expiration period. This policy can be associated only with \s-1HTTP/HTTPS\s0 listeners. Returns true on success. .ie n .SS "$success = $elb\->create_load_balancer_listeners(\-listeners=>\e%listener_hash); =head2 $success = $elb\->create_listeners(\e%listener_hash);" .el .SS "\f(CW$success\fP = \f(CW$elb\fP\->create_load_balancer_listeners(\-listeners=>\e%listener_hash); =head2 \f(CW$success\fP = \f(CW$elb\fP\->create_listeners(\e%listener_hash);" .IX Subsection "$success = $elb->create_load_balancer_listeners(-listeners=>%listener_hash); =head2 $success = $elb->create_listeners(%listener_hash);" Creates one or more listeners on a \s-1ELB\s0 for the specified port. If a listener with the given port does not already exist, it will be created; otherwise, the properties of the new listener must match the properties of the existing listener. Returns true on success. .PP The passed argument must either be a VM::EC2::ELB:Listener object (or arrayref of objects) or a hash (or arrayref of hashes) containing the following keys: .PP .Vb 6 \& Protocol \-\- Value as one of: HTTP, HTTPS, TCP, or SSL \& LoadBalancerPort \-\- Value in range 1\-65535 \& InstancePort \-\- Value in range 1\-65535 \& and optionally: \& InstanceProtocol \-\- Value as one of: HTTP, HTTPS, TCP, or SSL \& SSLCertificateId \-\- Certificate ID from AWS IAM certificate list .Ve .ie n .SS "$success = $elb\->delete_load_balancer_listeners(\-load_balancer_ports=>\e@ports) =head2 $success = $elb\->delete_listeners(@ports)" .el .SS "\f(CW$success\fP = \f(CW$elb\fP\->delete_load_balancer_listeners(\-load_balancer_ports=>\e@ports) =head2 \f(CW$success\fP = \f(CW$elb\fP\->delete_listeners(@ports)" .IX Subsection "$success = $elb->delete_load_balancer_listeners(-load_balancer_ports=>@ports) =head2 $success = $elb->delete_listeners(@ports)" Deletes listeners from the \s-1ELB\s0 for the specified port. Returns true on success. .ie n .SS "@zones = $elb\->disable_availability_zones_for_load_balancer(\-zones=>\e@zones) =head2 @zones = $elb\->disable_availability_zones(@zones) =head2 @zones = $elb\->disable_zones(@zones)" .el .SS "\f(CW@zones\fP = \f(CW$elb\fP\->disable_availability_zones_for_load_balancer(\-zones=>\e@zones) =head2 \f(CW@zones\fP = \f(CW$elb\fP\->disable_availability_zones(@zones) =head2 \f(CW@zones\fP = \f(CW$elb\fP\->disable_zones(@zones)" .IX Subsection "@zones = $elb->disable_availability_zones_for_load_balancer(-zones=>@zones) =head2 @zones = $elb->disable_availability_zones(@zones) =head2 @zones = $elb->disable_zones(@zones)" Removes the specified \s-1EC2\s0 Availability Zones from the set of configured Availability Zones for the \s-1ELB.\s0 Returns a series of VM::EC2::AvailabilityZone objects now associated with the \s-1ELB.\s0 .ie n .SS "@zones = $elb\->enable_availability_zones_for_load_balancer(\-zones=>\e@zones) =head2 @zones = $elb\->enable_availability_zones(@zones) =head2 @zones = $elb\->enable_zones(@zones)" .el .SS "\f(CW@zones\fP = \f(CW$elb\fP\->enable_availability_zones_for_load_balancer(\-zones=>\e@zones) =head2 \f(CW@zones\fP = \f(CW$elb\fP\->enable_availability_zones(@zones) =head2 \f(CW@zones\fP = \f(CW$elb\fP\->enable_zones(@zones)" .IX Subsection "@zones = $elb->enable_availability_zones_for_load_balancer(-zones=>@zones) =head2 @zones = $elb->enable_availability_zones(@zones) =head2 @zones = $elb->enable_zones(@zones)" Adds the specified \s-1EC2\s0 Availability Zones to the set of configured Availability Zones for the \s-1ELB.\s0 Returns a series of VM::EC2::AvailabilityZone objects now associated with the \s-1ELB.\s0 .ie n .SS "@instance_ids = $elb\->register_instances_with_load_balancer(\-instances=>\e@instance_ids) =head2 @instance_ids = $elb\->register_instances(@instance_ids)" .el .SS "\f(CW@instance_ids\fP = \f(CW$elb\fP\->register_instances_with_load_balancer(\-instances=>\e@instance_ids) =head2 \f(CW@instance_ids\fP = \f(CW$elb\fP\->register_instances(@instance_ids)" .IX Subsection "@instance_ids = $elb->register_instances_with_load_balancer(-instances=>@instance_ids) =head2 @instance_ids = $elb->register_instances(@instance_ids)" Adds new instances to the \s-1ELB.\s0 If the instance is in an availability zone that is not registered with the \s-1ELB\s0 will be in the OutOfService state. Once the zone is added to the \s-1ELB\s0 the instance will go into the InService state. Returns an array of instance IDs now associated with the \s-1ELB.\s0 .ie n .SS "@instance_ids = $elb\->deregister_instances_from_load_balancer(\-instances=>\e@instance_ids) =head2 @instance_ids = $elb\->deregister_instances(@instance_ids)" .el .SS "\f(CW@instance_ids\fP = \f(CW$elb\fP\->deregister_instances_from_load_balancer(\-instances=>\e@instance_ids) =head2 \f(CW@instance_ids\fP = \f(CW$elb\fP\->deregister_instances(@instance_ids)" .IX Subsection "@instance_ids = $elb->deregister_instances_from_load_balancer(-instances=>@instance_ids) =head2 @instance_ids = $elb->deregister_instances(@instance_ids)" Deregisters instances from the \s-1ELB.\s0 Once the instance is deregistered, it will stop receiving traffic from the \s-1ELB.\s0 Returns an array of instance IDs now associated with the \s-1ELB.\s0 .ie n .SS "@states = $elb\->describe_instance_health(\-instances=>\e@instance_ids) =head2 @states = $elb\->describe_instance_health(@instance_ids)" .el .SS "\f(CW@states\fP = \f(CW$elb\fP\->describe_instance_health(\-instances=>\e@instance_ids) =head2 \f(CW@states\fP = \f(CW$elb\fP\->describe_instance_health(@instance_ids)" .IX Subsection "@states = $elb->describe_instance_health(-instances=>@instance_ids) =head2 @states = $elb->describe_instance_health(@instance_ids)" Provides the current state of the instances of the specified LoadBalancer. If no instances are specified, the state of all the instances for the \s-1ELB\s0 is returned. Returns an array of VM::EC2::ELB::InstanceState objects. .ie n .SS "$success = $elb\->create_load_balancer_policy(\-policy_name=>$name,\-policy_type_name=>$type_name,\-policy_attributes=>\e@attrs) =head2 $success = $elb\->create_policy(\-policy_name=>$name,\-policy_type_name=>$type_name,\-policy_attributes=>\e@attrs)" .el .SS "\f(CW$success\fP = \f(CW$elb\fP\->create_load_balancer_policy(\-policy_name=>$name,\-policy_type_name=>$type_name,\-policy_attributes=>\e@attrs) =head2 \f(CW$success\fP = \f(CW$elb\fP\->create_policy(\-policy_name=>$name,\-policy_type_name=>$type_name,\-policy_attributes=>\e@attrs)" .IX Subsection "$success = $elb->create_load_balancer_policy(-policy_name=>$name,-policy_type_name=>$type_name,-policy_attributes=>@attrs) =head2 $success = $elb->create_policy(-policy_name=>$name,-policy_type_name=>$type_name,-policy_attributes=>@attrs)" Creates a new policy that contains the necessary attributes depending on the policy type. Policies are settings that are saved for your \s-1ELB\s0 and that can be applied to the front-end listener, or the back-end application server, depending on your policy type. Returns true on success. .ie n .SS "$success = $elb\->delete_load_balancer_policy(\-policy_name=>$policy_name) =head2 $success = $elb\->delete_policy($policy_name)" .el .SS "\f(CW$success\fP = \f(CW$elb\fP\->delete_load_balancer_policy(\-policy_name=>$policy_name) =head2 \f(CW$success\fP = \f(CW$elb\fP\->delete_policy($policy_name)" .IX Subsection "$success = $elb->delete_load_balancer_policy(-policy_name=>$policy_name) =head2 $success = $elb->delete_policy($policy_name)" Deletes a policy from the \s-1ELB.\s0 The specified policy must not be enabled for any listeners. Returns true on success. .SH "CONFIGURATION METHODS" .IX Header "CONFIGURATION METHODS" .ie n .SS "$health_check = $elb\->configure_health_check(\-healthy_threshold=>$cnt,\-interval=>$secs,\-target=>$target,\-timeout=>$secs,\-unhealthy_threshold=>$cnt)" .el .SS "\f(CW$health_check\fP = \f(CW$elb\fP\->configure_health_check(\-healthy_threshold=>$cnt,\-interval=>$secs,\-target=>$target,\-timeout=>$secs,\-unhealthy_threshold=>$cnt)" .IX Subsection "$health_check = $elb->configure_health_check(-healthy_threshold=>$cnt,-interval=>$secs,-target=>$target,-timeout=>$secs,-unhealthy_threshold=>$cnt)" This method configures the health check for a particular target service. .PP \&\-target must be in the format Protocol:Port[/PathToPing]: \- Valid Protocol types are: \s-1HTTP, HTTPS, TCP, SSL\s0 \- Port must be in range 0\-65535 \- PathToPing is only applicable to \s-1HTTP\s0 or \s-1HTTPS\s0 protocol types and must be 1024 characters long or fewer. .PP .Vb 1 \& ex: HTTP:80/index.html .Ve .ie n .SS "$success = $elb\->create_policy(\-policy_name=>$name,\-policy_type_name=>$type_name)" .el .SS "\f(CW$success\fP = \f(CW$elb\fP\->create_policy(\-policy_name=>$name,\-policy_type_name=>$type_name)" .IX Subsection "$success = $elb->create_policy(-policy_name=>$name,-policy_type_name=>$type_name)" Creates a new policy that contains the necessary attributes depending on the policy type. Returns true on success. .ie n .SS "$success = $elb\->set_load_balancer_listener_ssl_certificate(\-port=>$port,\-cert_id=>$cert_id)" .el .SS "\f(CW$success\fP = \f(CW$elb\fP\->set_load_balancer_listener_ssl_certificate(\-port=>$port,\-cert_id=>$cert_id)" .IX Subsection "$success = $elb->set_load_balancer_listener_ssl_certificate(-port=>$port,-cert_id=>$cert_id)" Sets the certificate that terminates the specified listener's \s-1SSL\s0 connections. The specified certificate replaces any prior certificate that was used on the same \s-1ELB\s0 and port. Returns true on success. .ie n .SS "$success = $elb\->set_load_balancer_policies_of_listener(\-port=>$port,\-policy_names=>\e@names) =head2 $success = $elb\->set_policies_of_listener(\-port=>$port,\-policy_names=>\e@names)" .el .SS "\f(CW$success\fP = \f(CW$elb\fP\->set_load_balancer_policies_of_listener(\-port=>$port,\-policy_names=>\e@names) =head2 \f(CW$success\fP = \f(CW$elb\fP\->set_policies_of_listener(\-port=>$port,\-policy_names=>\e@names)" .IX Subsection "$success = $elb->set_load_balancer_policies_of_listener(-port=>$port,-policy_names=>@names) =head2 $success = $elb->set_policies_of_listener(-port=>$port,-policy_names=>@names)" Associates, updates, or disables a policy with a listener on the \s-1ELB.\s0 Multiple policies may be associated with a listener. Returns true on success. .ie n .SS "@groups = $elb\->apply_security_groups_to_load_balancer(\-security_groups=>\e@groups) =head2 @groups = $elb\->apply_security_groups(@groups)" .el .SS "\f(CW@groups\fP = \f(CW$elb\fP\->apply_security_groups_to_load_balancer(\-security_groups=>\e@groups) =head2 \f(CW@groups\fP = \f(CW$elb\fP\->apply_security_groups(@groups)" .IX Subsection "@groups = $elb->apply_security_groups_to_load_balancer(-security_groups=>@groups) =head2 @groups = $elb->apply_security_groups(@groups)" Associates one or more security groups with your \s-1ELB\s0 in \s-1VPC.\s0 The provided security group IDs will override any currently applied security groups. Returns a list of VM::EC2::SecurityGroup objects. .ie n .SS "@subnets = $elb\->attach_load_balancer_to_subnets(\-subnets=>\e@subnets) =head2 @subnets = $elb\->attach_to_subnets(@subnets)" .el .SS "\f(CW@subnets\fP = \f(CW$elb\fP\->attach_load_balancer_to_subnets(\-subnets=>\e@subnets) =head2 \f(CW@subnets\fP = \f(CW$elb\fP\->attach_to_subnets(@subnets)" .IX Subsection "@subnets = $elb->attach_load_balancer_to_subnets(-subnets=>@subnets) =head2 @subnets = $elb->attach_to_subnets(@subnets)" Adds one or more subnets to the set of configured subnets for the \s-1ELB.\s0 Returns a series of VM::EC2::VPC::Subnet objects corresponding to the subnets the \s-1ELB\s0 is now attached to. .ie n .SS "@subnets = $elb\->detach_load_balancer_from_subnets(\-subnets=>\e@subnets) =head2 @subnets = $elb\->detach_from_subnets(@subnets)" .el .SS "\f(CW@subnets\fP = \f(CW$elb\fP\->detach_load_balancer_from_subnets(\-subnets=>\e@subnets) =head2 \f(CW@subnets\fP = \f(CW$elb\fP\->detach_from_subnets(@subnets)" .IX Subsection "@subnets = $elb->detach_load_balancer_from_subnets(-subnets=>@subnets) =head2 @subnets = $elb->detach_from_subnets(@subnets)" Removes subnets from the set of configured subnets in the \s-1VPC\s0 for the \s-1ELB.\s0 Returns a series of VM::EC2::VPC::Subnet objects corresponding to the subnets the \s-1ELB\s0 is now attached to. .ie n .SS "$success = $elb\->set_load_balancer_policies_for_backend_server(\-port=>$port,\-policy_names=>$names) =head2 $success = $elb\->set_policies_for_backend_server(\-port=>$port,\-policy_names=>$names)" .el .SS "\f(CW$success\fP = \f(CW$elb\fP\->set_load_balancer_policies_for_backend_server(\-port=>$port,\-policy_names=>$names) =head2 \f(CW$success\fP = \f(CW$elb\fP\->set_policies_for_backend_server(\-port=>$port,\-policy_names=>$names)" .IX Subsection "$success = $elb->set_load_balancer_policies_for_backend_server(-port=>$port,-policy_names=>$names) =head2 $success = $elb->set_policies_for_backend_server(-port=>$port,-policy_names=>$names)" Replaces the current set of policies associated with a port on which the back\- end server is listening with a new set of policies. After the policies have been created, they can be applied here as a list. At this time, only the back\- end server authentication policy type can be applied to the back-end ports; this policy type is composed of multiple public key policies. Returns true on success. .ie n .SS "$success = $elb\->add_tags({ Name => Value[, Name => Value,...]); =head2 $success = $elb\->add_tags(\e%tags);" .el .SS "\f(CW$success\fP = \f(CW$elb\fP\->add_tags({ Name => Value[, Name => Value,...]); =head2 \f(CW$success\fP = \f(CW$elb\fP\->add_tags(\e%tags);" .IX Subsection "$success = $elb->add_tags({ Name => Value[, Name => Value,...]); =head2 $success = $elb->add_tags(%tags);" Adds tags to the \s-1ELB.\s0 Up to ten tags can be applied. .SH "INFORMATION METHODS" .IX Header "INFORMATION METHODS" .ie n .SS "$state = $lb\->describe_instance_health(\-instances=>\e@instances) =head2 $state = $lb\->describe_instance_health(@instances) =head2 $state = $lb\->describe_instance_health" .el .SS "\f(CW$state\fP = \f(CW$lb\fP\->describe_instance_health(\-instances=>\e@instances) =head2 \f(CW$state\fP = \f(CW$lb\fP\->describe_instance_health(@instances) =head2 \f(CW$state\fP = \f(CW$lb\fP\->describe_instance_health" .IX Subsection "$state = $lb->describe_instance_health(-instances=>@instances) =head2 $state = $lb->describe_instance_health(@instances) =head2 $state = $lb->describe_instance_health" Returns the current state of the instances registered with the \s-1ELB.\s0 .ie n .SS "@policies = $lb\->describe_load_balancer_policies(\-policy_names=>\e@names) =head2 @policies = $lb\->describe_load_balancer_policies;" .el .SS "\f(CW@policies\fP = \f(CW$lb\fP\->describe_load_balancer_policies(\-policy_names=>\e@names) =head2 \f(CW@policies\fP = \f(CW$lb\fP\->describe_load_balancer_policies;" .IX Subsection "@policies = $lb->describe_load_balancer_policies(-policy_names=>@names) =head2 @policies = $lb->describe_load_balancer_policies;" .SH "STRING OVERLOADING" .IX Header "STRING OVERLOADING" When used in a string context, this object will interpolate the Elastic Load Balancer Name. .SH "SEE ALSO" .IX Header "SEE ALSO" \&\s-1VM::EC2\s0 VM::EC2::Generic VM::EC2::ELB::HealthCheck VM::EC2::ELB::ListenerDescription VM::EC2::ELB::BackendServerDescription VM::EC2::ELB::Policies .SH "AUTHOR" .IX Header "AUTHOR" Lance Kinley . .PP Copyright (c) 2012\-2014 Loyalty Methods, Inc. .PP This package and its accompanying libraries is free software; you can redistribute it and/or modify it under the terms of the \s-1GPL\s0 (either version 1, or at your option, any later version) or the Artistic License 2.0. Refer to \s-1LICENSE\s0 for the full license text. In addition, please see \s-1DISCLAIMER\s0.txt for disclaimers of warranty.