elasticloadbalancing

class pulumi_aws.elasticloadbalancing.AppCookieStickinessPolicy(resource_name, opts=None, cookie_name=None, lb_port=None, load_balancer=None, name=None, __name__=None, __opts__=None)

Provides an application cookie stickiness policy, which allows an ELB to wed its sticky cookie’s expiration to a cookie generated by your application.

Parameters:
  • resource_name (str) – The name of the resource.
  • opts (pulumi.ResourceOptions) – Options for the resource.
  • cookie_name (pulumi.Input[str]) – The application cookie whose lifetime the ELB’s cookie should follow.
  • lb_port (pulumi.Input[float]) – The load balancer port to which the policy should be applied. This must be an active listener on the load balancer.
  • load_balancer (pulumi.Input[str]) – The name of load balancer to which the policy should be attached.
  • name (pulumi.Input[str]) – The name of the stickiness policy.
cookie_name = None

The application cookie whose lifetime the ELB’s cookie should follow.

lb_port = None

The load balancer port to which the policy should be applied. This must be an active listener on the load balancer.

load_balancer = None

The name of load balancer to which the policy should be attached.

name = None

The name of the stickiness policy.

translate_output_property(prop)

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters:prop (str) – A property name.
Returns:A potentially transformed property name.
Return type:str
translate_input_property(prop)

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters:prop (str) – A property name.
Returns:A potentially transformed property name.
Return type:str
class pulumi_aws.elasticloadbalancing.Attachment(resource_name, opts=None, elb=None, instance=None, __name__=None, __opts__=None)

Attaches an EC2 instance to an Elastic Load Balancer (ELB). For attaching resources with Application Load Balancer (ALB) or Network Load Balancer (NLB), see the ``aws_lb_target_group_attachment` resource <https://www.terraform.io/docs/providers/aws/r/lb_target_group_attachment.html>`_.

NOTE on ELB Instances and ELB Attachments: Terraform currently provides both a standalone ELB Attachment resource (describing an instance attached to an ELB), and an Elastic Load Balancer resource with instances defined in-line. At this time you cannot use an ELB with in-line instances in conjunction with an ELB Attachment resource. Doing so will cause a conflict and will overwrite attachments.
Parameters:
  • resource_name (str) – The name of the resource.
  • opts (pulumi.ResourceOptions) – Options for the resource.
  • elb (pulumi.Input[str]) – The name of the ELB.
  • instance (pulumi.Input[str]) – Instance ID to place in the ELB pool.
elb = None

The name of the ELB.

instance = None

Instance ID to place in the ELB pool.

translate_output_property(prop)

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters:prop (str) – A property name.
Returns:A potentially transformed property name.
Return type:str
translate_input_property(prop)

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters:prop (str) – A property name.
Returns:A potentially transformed property name.
Return type:str
class pulumi_aws.elasticloadbalancing.GetHostedZoneIdResult(id=None)

A collection of values returned by getHostedZoneId.

id = None

id is the provider-assigned unique ID for this managed resource.

class pulumi_aws.elasticloadbalancing.GetLoadBalancerResult(access_logs=None, availability_zones=None, connection_draining=None, connection_draining_timeout=None, cross_zone_load_balancing=None, dns_name=None, health_check=None, idle_timeout=None, instances=None, internal=None, listeners=None, security_groups=None, source_security_group=None, source_security_group_id=None, subnets=None, tags=None, zone_id=None, id=None)

A collection of values returned by getLoadBalancer.

id = None

id is the provider-assigned unique ID for this managed resource.

class pulumi_aws.elasticloadbalancing.GetServiceAccountResult(arn=None, id=None)

A collection of values returned by getServiceAccount.

arn = None

The ARN of the AWS ELB service account in the selected region.

id = None

id is the provider-assigned unique ID for this managed resource.

class pulumi_aws.elasticloadbalancing.ListenerPolicy(resource_name, opts=None, load_balancer_name=None, load_balancer_port=None, policy_names=None, __name__=None, __opts__=None)

Attaches a load balancer policy to an ELB Listener.

Parameters:
  • resource_name (str) – The name of the resource.
  • opts (pulumi.ResourceOptions) – Options for the resource.
  • load_balancer_name (pulumi.Input[str]) – The load balancer to attach the policy to.
  • load_balancer_port (pulumi.Input[float]) – The load balancer listener port to apply the policy to.
  • policy_names (pulumi.Input[list]) – List of Policy Names to apply to the backend server.
load_balancer_name = None

The load balancer to attach the policy to.

load_balancer_port = None

The load balancer listener port to apply the policy to.

policy_names = None

List of Policy Names to apply to the backend server.

translate_output_property(prop)

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters:prop (str) – A property name.
Returns:A potentially transformed property name.
Return type:str
translate_input_property(prop)

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters:prop (str) – A property name.
Returns:A potentially transformed property name.
Return type:str
class pulumi_aws.elasticloadbalancing.LoadBalancer(resource_name, opts=None, access_logs=None, availability_zones=None, connection_draining=None, connection_draining_timeout=None, cross_zone_load_balancing=None, health_check=None, idle_timeout=None, instances=None, internal=None, listeners=None, name=None, name_prefix=None, security_groups=None, source_security_group=None, subnets=None, tags=None, __name__=None, __opts__=None)

Provides an Elastic Load Balancer resource, also known as a “Classic Load Balancer” after the release of Application/Network Load Balancers.

NOTE on ELB Instances and ELB Attachments: Terraform currently provides both a standalone ELB Attachment resource (describing an instance attached to an ELB), and an ELB resource with instances defined in-line. At this time you cannot use an ELB with in-line instances in conjunction with a ELB Attachment resources. Doing so will cause a conflict and will overwrite attachments.

If the ARN of the ssl_certificate_id that is pointed to references a certificate that was signed by an ECDSA key, note that ELB only supports the P256 and P384 curves. Using a certificate signed by a key using a different curve could produce the error ERR_SSL_VERSION_OR_CIPHER_MISMATCH in your browser.

Parameters:
  • resource_name (str) – The name of the resource.
  • opts (pulumi.ResourceOptions) – Options for the resource.
  • access_logs (pulumi.Input[dict]) – An Access Logs block. Access Logs documented below.
  • availability_zones (pulumi.Input[list]) – The AZ’s to serve traffic in.
  • connection_draining (pulumi.Input[bool]) – Boolean to enable connection draining. Default: false
  • connection_draining_timeout (pulumi.Input[float]) – The time in seconds to allow for connections to drain. Default: 300
  • cross_zone_load_balancing (pulumi.Input[bool]) – Enable cross-zone load balancing. Default: true
  • health_check (pulumi.Input[dict]) – A health_check block. Health Check documented below.
  • idle_timeout (pulumi.Input[float]) – The time in seconds that the connection is allowed to be idle. Default: 60
  • instances (pulumi.Input[list]) – A list of instance ids to place in the ELB pool.
  • internal (pulumi.Input[bool]) – If true, ELB will be an internal ELB.
  • listeners (pulumi.Input[list]) – A list of listener blocks. Listeners documented below.
  • name (pulumi.Input[str]) – The name of the ELB. By default generated by Terraform.
  • name_prefix (pulumi.Input[str]) – Creates a unique name beginning with the specified prefix. Conflicts with name.
  • security_groups (pulumi.Input[list]) – A list of security group IDs to assign to the ELB. Only valid if creating an ELB within a VPC
  • source_security_group (pulumi.Input[str]) – The name of the security group that you can use as part of your inbound rules for your load balancer’s back-end application instances. Use this for Classic or Default VPC only.
  • subnets (pulumi.Input[list]) – A list of subnet IDs to attach to the ELB.
  • tags (pulumi.Input[dict]) – A mapping of tags to assign to the resource.
access_logs = None

An Access Logs block. Access Logs documented below.

arn = None

The ARN of the ELB

availability_zones = None

The AZ’s to serve traffic in.

connection_draining = None

Boolean to enable connection draining. Default: false

connection_draining_timeout = None

The time in seconds to allow for connections to drain. Default: 300

cross_zone_load_balancing = None

Enable cross-zone load balancing. Default: true

dns_name = None

The DNS name of the ELB

health_check = None

A health_check block. Health Check documented below.

idle_timeout = None

The time in seconds that the connection is allowed to be idle. Default: 60

instances = None

A list of instance ids to place in the ELB pool.

internal = None

If true, ELB will be an internal ELB.

listeners = None

A list of listener blocks. Listeners documented below.

name = None

The name of the ELB. By default generated by Terraform.

name_prefix = None

Creates a unique name beginning with the specified prefix. Conflicts with name.

security_groups = None

A list of security group IDs to assign to the ELB. Only valid if creating an ELB within a VPC

source_security_group = None

The name of the security group that you can use as part of your inbound rules for your load balancer’s back-end application instances. Use this for Classic or Default VPC only.

source_security_group_id = None

The ID of the security group that you can use as part of your inbound rules for your load balancer’s back-end application instances. Only available on ELBs launched in a VPC.

subnets = None

A list of subnet IDs to attach to the ELB.

tags = None

A mapping of tags to assign to the resource.

zone_id = None

The canonical hosted zone ID of the ELB (to be used in a Route 53 Alias record)

translate_output_property(prop)

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters:prop (str) – A property name.
Returns:A potentially transformed property name.
Return type:str
translate_input_property(prop)

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters:prop (str) – A property name.
Returns:A potentially transformed property name.
Return type:str
class pulumi_aws.elasticloadbalancing.LoadBalancerBackendServerPolicy(resource_name, opts=None, instance_port=None, load_balancer_name=None, policy_names=None, __name__=None, __opts__=None)

Attaches a load balancer policy to an ELB backend server.

Parameters:
  • resource_name (str) – The name of the resource.
  • opts (pulumi.ResourceOptions) – Options for the resource.
  • instance_port (pulumi.Input[float]) – The instance port to apply the policy to.
  • load_balancer_name (pulumi.Input[str]) – The load balancer to attach the policy to.
  • policy_names (pulumi.Input[list]) – List of Policy Names to apply to the backend server.
instance_port = None

The instance port to apply the policy to.

load_balancer_name = None

The load balancer to attach the policy to.

policy_names = None

List of Policy Names to apply to the backend server.

translate_output_property(prop)

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters:prop (str) – A property name.
Returns:A potentially transformed property name.
Return type:str
translate_input_property(prop)

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters:prop (str) – A property name.
Returns:A potentially transformed property name.
Return type:str
class pulumi_aws.elasticloadbalancing.LoadBalancerCookieStickinessPolicy(resource_name, opts=None, cookie_expiration_period=None, lb_port=None, load_balancer=None, name=None, __name__=None, __opts__=None)

Provides a load balancer cookie stickiness policy, which allows an ELB to control the sticky session lifetime of the browser.

Parameters:
  • resource_name (str) – The name of the resource.
  • opts (pulumi.ResourceOptions) – Options for the resource.
  • cookie_expiration_period (pulumi.Input[float]) – The time period after which the session cookie should be considered stale, expressed in seconds.
  • lb_port (pulumi.Input[float]) – The load balancer port to which the policy should be applied. This must be an active listener on the load balancer.
  • load_balancer (pulumi.Input[str]) – The load balancer to which the policy should be attached.
  • name (pulumi.Input[str]) – The name of the stickiness policy.
cookie_expiration_period = None

The time period after which the session cookie should be considered stale, expressed in seconds.

lb_port = None

The load balancer port to which the policy should be applied. This must be an active listener on the load balancer.

load_balancer = None

The load balancer to which the policy should be attached.

name = None

The name of the stickiness policy.

translate_output_property(prop)

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters:prop (str) – A property name.
Returns:A potentially transformed property name.
Return type:str
translate_input_property(prop)

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters:prop (str) – A property name.
Returns:A potentially transformed property name.
Return type:str
class pulumi_aws.elasticloadbalancing.LoadBalancerPolicy(resource_name, opts=None, load_balancer_name=None, policy_attributes=None, policy_name=None, policy_type_name=None, __name__=None, __opts__=None)

Provides a load balancer policy, which can be attached to an ELB listener or backend server.

Parameters:
  • resource_name (str) – The name of the resource.
  • opts (pulumi.ResourceOptions) – Options for the resource.
  • load_balancer_name (pulumi.Input[str]) – The load balancer on which the policy is defined.
  • policy_attributes (pulumi.Input[list]) – Policy attribute to apply to the policy.
  • policy_name (pulumi.Input[str]) – The name of the load balancer policy.
  • policy_type_name (pulumi.Input[str]) – The policy type.
load_balancer_name = None

The load balancer on which the policy is defined.

policy_attributes = None

Policy attribute to apply to the policy.

policy_name = None

The name of the load balancer policy.

policy_type_name = None

The policy type.

translate_output_property(prop)

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters:prop (str) – A property name.
Returns:A potentially transformed property name.
Return type:str
translate_input_property(prop)

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters:prop (str) – A property name.
Returns:A potentially transformed property name.
Return type:str
class pulumi_aws.elasticloadbalancing.SslNegotiationPolicy(resource_name, opts=None, attributes=None, lb_port=None, load_balancer=None, name=None, __name__=None, __opts__=None)

Provides a load balancer SSL negotiation policy, which allows an ELB to control the ciphers and protocols that are supported during SSL negotiations between a client and a load balancer.

Parameters:
  • resource_name (str) – The name of the resource.
  • opts (pulumi.ResourceOptions) – Options for the resource.
  • attributes (pulumi.Input[list]) – An SSL Negotiation policy attribute. Each has two properties:
  • lb_port (pulumi.Input[float]) – The load balancer port to which the policy should be applied. This must be an active listener on the load balancer.
  • load_balancer (pulumi.Input[str]) – The load balancer to which the policy should be attached.
  • name (pulumi.Input[str]) – The name of the attribute
attributes = None

An SSL Negotiation policy attribute. Each has two properties:

lb_port = None

The load balancer port to which the policy should be applied. This must be an active listener on the load balancer.

load_balancer = None

The load balancer to which the policy should be attached.

name = None

The name of the attribute

translate_output_property(prop)

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters:prop (str) – A property name.
Returns:A potentially transformed property name.
Return type:str
translate_input_property(prop)

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters:prop (str) – A property name.
Returns:A potentially transformed property name.
Return type:str
pulumi_aws.elasticloadbalancing.get_hosted_zone_id(region=None, opts=None)

Use this data source to get the HostedZoneId of the AWS Elastic Load Balancing HostedZoneId in a given region for the purpose of using in an AWS Route53 Alias.

pulumi_aws.elasticloadbalancing.get_load_balancer(name=None, tags=None, opts=None)

Provides information about a “classic” Elastic Load Balancer (ELB). See LB Data Source if you are looking for “v2” Application Load Balancer (ALB) or Network Load Balancer (NLB).

This data source can prove useful when a module accepts an LB as an input variable and needs to, for example, determine the security groups associated with it, etc.

pulumi_aws.elasticloadbalancing.get_service_account(region=None, opts=None)

Use this data source to get the Account ID of the AWS Elastic Load Balancing Service Account in a given region for the purpose of whitelisting in S3 bucket policy.