lb

class pulumi_azure.lb.BackendAddressPool(resource_name, opts=None, loadbalancer_id=None, location=None, name=None, resource_group_name=None, __name__=None, __opts__=None)

Manage a Load Balancer Backend Address Pool.

NOTE: When using this resource, the Load Balancer needs to have a FrontEnd IP Configuration Attached
Parameters:
  • resource_name (str) – The name of the resource.
  • opts (pulumi.ResourceOptions) – Options for the resource.
  • loadbalancer_id (pulumi.Input[str]) – The ID of the Load Balancer in which to create the Backend Address Pool.
  • name (pulumi.Input[str]) – Specifies the name of the Backend Address Pool.
  • resource_group_name (pulumi.Input[str]) – The name of the resource group in which to create the resource.
backend_ip_configurations = None

The Backend IP Configurations associated with this Backend Address Pool.

load_balancing_rules = None

The Load Balancing Rules associated with this Backend Address Pool.

loadbalancer_id = None

The ID of the Load Balancer in which to create the Backend Address Pool.

name = None

Specifies the name of the Backend Address Pool.

resource_group_name = None

The name of the resource group in which to create the resource.

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_azure.lb.GetBackendAddressPoolResult(loadbalancer_id=None, name=None, id=None)

A collection of values returned by getBackendAddressPool.

id = None

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

class pulumi_azure.lb.GetLBResult(frontend_ip_configurations=None, location=None, name=None, private_ip_address=None, private_ip_addresses=None, resource_group_name=None, sku=None, tags=None, id=None)

A collection of values returned by getLB.

frontend_ip_configurations = None

(Optional) A frontend_ip_configuration block as documented below.

location = None

The Azure location where the Load Balancer exists.

name = None

The name of the Frontend IP Configuration.

private_ip_address = None

Private IP Address to assign to the Load Balancer.

private_ip_addresses = None

The list of private IP address assigned to the load balancer in frontend_ip_configuration blocks, if any.

sku = None

The SKU of the Load Balancer.

tags = None

A mapping of tags assigned to the resource.

id = None

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

class pulumi_azure.lb.LoadBalancer(resource_name, opts=None, frontend_ip_configurations=None, location=None, name=None, resource_group_name=None, sku=None, tags=None, __name__=None, __opts__=None)

Manage a Load Balancer Resource.

Parameters:
  • resource_name (str) – The name of the resource.
  • opts (pulumi.ResourceOptions) – Options for the resource.
  • frontend_ip_configurations (pulumi.Input[list]) – A frontend_ip_configuration block as documented below.
  • location (pulumi.Input[str]) – Specifies the supported Azure Region where the Load Balancer should be created.
  • name (pulumi.Input[str]) – Specifies the name of the frontend ip configuration.
  • resource_group_name (pulumi.Input[str]) – The name of the Resource Group in which to create the Load Balancer.
  • sku (pulumi.Input[str]) – The SKU of the Azure Load Balancer. Accepted values are Basic and Standard. Defaults to Basic.
  • tags (pulumi.Input[dict]) – A mapping of tags to assign to the resource.
frontend_ip_configurations = None

A frontend_ip_configuration block as documented below.

location = None

Specifies the supported Azure Region where the Load Balancer should be created.

name = None

Specifies the name of the frontend ip configuration.

private_ip_address = None

Private IP Address to assign to the Load Balancer. The last one and first four IPs in any range are reserved and cannot be manually assigned.

private_ip_addresses = None

The list of private IP address assigned to the load balancer in frontend_ip_configuration blocks, if any.

resource_group_name = None

The name of the Resource Group in which to create the Load Balancer.

sku = None

The SKU of the Azure Load Balancer. Accepted values are Basic and Standard. Defaults to Basic.

tags = None

A mapping of tags to assign to the resource.

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_azure.lb.NatPool(resource_name, opts=None, backend_port=None, frontend_ip_configuration_name=None, frontend_port_end=None, frontend_port_start=None, loadbalancer_id=None, location=None, name=None, protocol=None, resource_group_name=None, __name__=None, __opts__=None)

Manages a Load Balancer NAT pool.

NOTE When using this resource, the Load Balancer needs to have a FrontEnd IP Configuration Attached
Parameters:
  • resource_name (str) – The name of the resource.
  • opts (pulumi.ResourceOptions) – Options for the resource.
  • backend_port (pulumi.Input[float]) – The port used for the internal endpoint. Possible values range between 1 and 65535, inclusive.
  • frontend_ip_configuration_name (pulumi.Input[str]) – The name of the frontend IP configuration exposing this rule.
  • frontend_port_end (pulumi.Input[float]) – The last port number in the range of external ports that will be used to provide Inbound Nat to NICs associated with this Load Balancer. Possible values range between 1 and 65534, inclusive.
  • frontend_port_start (pulumi.Input[float]) – The first port number in the range of external ports that will be used to provide Inbound Nat to NICs associated with this Load Balancer. Possible values range between 1 and 65534, inclusive.
  • loadbalancer_id (pulumi.Input[str]) – The ID of the Load Balancer in which to create the NAT pool.
  • name (pulumi.Input[str]) – Specifies the name of the NAT pool.
  • protocol (pulumi.Input[str]) – The transport protocol for the external endpoint. Possible values are Udp or Tcp.
  • resource_group_name (pulumi.Input[str]) – The name of the resource group in which to create the resource.
backend_port = None

The port used for the internal endpoint. Possible values range between 1 and 65535, inclusive.

frontend_ip_configuration_name = None

The name of the frontend IP configuration exposing this rule.

frontend_port_end = None

The last port number in the range of external ports that will be used to provide Inbound Nat to NICs associated with this Load Balancer. Possible values range between 1 and 65534, inclusive.

frontend_port_start = None

The first port number in the range of external ports that will be used to provide Inbound Nat to NICs associated with this Load Balancer. Possible values range between 1 and 65534, inclusive.

loadbalancer_id = None

The ID of the Load Balancer in which to create the NAT pool.

name = None

Specifies the name of the NAT pool.

protocol = None

The transport protocol for the external endpoint. Possible values are Udp or Tcp.

resource_group_name = None

The name of the resource group in which to create the resource.

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_azure.lb.NatRule(resource_name, opts=None, backend_port=None, enable_floating_ip=None, frontend_ip_configuration_name=None, frontend_port=None, loadbalancer_id=None, location=None, name=None, protocol=None, resource_group_name=None, __name__=None, __opts__=None)

Manages a Load Balancer NAT Rule.

NOTE When using this resource, the Load Balancer needs to have a FrontEnd IP Configuration Attached
Parameters:
  • resource_name (str) – The name of the resource.
  • opts (pulumi.ResourceOptions) – Options for the resource.
  • backend_port (pulumi.Input[float]) – The port used for internal connections on the endpoint. Possible values range between 1 and 65535, inclusive.
  • enable_floating_ip (pulumi.Input[bool]) – Enables the Floating IP Capacity, required to configure a SQL AlwaysOn Availability Group.
  • frontend_ip_configuration_name (pulumi.Input[str]) – The name of the frontend IP configuration exposing this rule.
  • frontend_port (pulumi.Input[float]) – The port for the external endpoint. Port numbers for each Rule must be unique within the Load Balancer. Possible values range between 1 and 65534, inclusive.
  • loadbalancer_id (pulumi.Input[str]) – The ID of the Load Balancer in which to create the NAT Rule.
  • name (pulumi.Input[str]) – Specifies the name of the NAT Rule.
  • protocol (pulumi.Input[str]) – The transport protocol for the external endpoint. Possible values are Udp, Tcp or All.
  • resource_group_name (pulumi.Input[str]) – The name of the resource group in which to create the resource.
backend_port = None

The port used for internal connections on the endpoint. Possible values range between 1 and 65535, inclusive.

enable_floating_ip = None

Enables the Floating IP Capacity, required to configure a SQL AlwaysOn Availability Group.

frontend_ip_configuration_name = None

The name of the frontend IP configuration exposing this rule.

frontend_port = None

The port for the external endpoint. Port numbers for each Rule must be unique within the Load Balancer. Possible values range between 1 and 65534, inclusive.

loadbalancer_id = None

The ID of the Load Balancer in which to create the NAT Rule.

name = None

Specifies the name of the NAT Rule.

protocol = None

The transport protocol for the external endpoint. Possible values are Udp, Tcp or All.

resource_group_name = None

The name of the resource group in which to create the resource.

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_azure.lb.OutboundRule(resource_name, opts=None, allocated_outbound_ports=None, backend_address_pool_id=None, enable_tcp_reset=None, frontend_ip_configurations=None, idle_timeout_in_minutes=None, loadbalancer_id=None, name=None, protocol=None, resource_group_name=None, __name__=None, __opts__=None)

Manages a Load Balancer Outbound Rule.

NOTE When using this resource, the Load Balancer needs to have a FrontEnd IP Configuration and a Backend Address Pool Attached.
Parameters:
  • resource_name (str) – The name of the resource.
  • opts (pulumi.ResourceOptions) – Options for the resource.
  • allocated_outbound_ports (pulumi.Input[float]) – The number of outbound ports to be used for NAT.
  • backend_address_pool_id (pulumi.Input[str]) – The ID of the Backend Address Pool. Outbound traffic is randomly load balanced across IPs in the backend IPs.
  • enable_tcp_reset (pulumi.Input[bool]) – Receive bidirectional TCP Reset on TCP flow idle timeout or unexpected connection termination. This element is only used when the protocol is set to TCP.
  • frontend_ip_configurations (pulumi.Input[list]) – One or more frontend_ip_configuration blocks as defined below.
  • idle_timeout_in_minutes (pulumi.Input[float]) – The timeout for the TCP idle connection
  • loadbalancer_id (pulumi.Input[str]) – The ID of the Load Balancer in which to create the Outbound Rule. Changing this forces a new resource to be created.
  • name (pulumi.Input[str]) – Specifies the name of the Outbound Rule. Changing this forces a new resource to be created.
  • protocol (pulumi.Input[str]) – The transport protocol for the external endpoint. Possible values are Udp, Tcp or All.
  • resource_group_name (pulumi.Input[str]) – The name of the resource group in which to create the resource. Changing this forces a new resource to be created.
allocated_outbound_ports = None

The number of outbound ports to be used for NAT.

backend_address_pool_id = None

The ID of the Backend Address Pool. Outbound traffic is randomly load balanced across IPs in the backend IPs.

enable_tcp_reset = None

Receive bidirectional TCP Reset on TCP flow idle timeout or unexpected connection termination. This element is only used when the protocol is set to TCP.

frontend_ip_configurations = None

One or more frontend_ip_configuration blocks as defined below.

idle_timeout_in_minutes = None

The timeout for the TCP idle connection

loadbalancer_id = None

The ID of the Load Balancer in which to create the Outbound Rule. Changing this forces a new resource to be created.

name = None

Specifies the name of the Outbound Rule. Changing this forces a new resource to be created.

protocol = None

The transport protocol for the external endpoint. Possible values are Udp, Tcp or All.

resource_group_name = None

The name of the resource group in which to create the resource. Changing this forces a new resource to be created.

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_azure.lb.Probe(resource_name, opts=None, interval_in_seconds=None, loadbalancer_id=None, location=None, name=None, number_of_probes=None, port=None, protocol=None, request_path=None, resource_group_name=None, __name__=None, __opts__=None)

Manages a LoadBalancer Probe Resource.

NOTE When using this resource, the Load Balancer needs to have a FrontEnd IP Configuration Attached
Parameters:
  • resource_name (str) – The name of the resource.
  • opts (pulumi.ResourceOptions) – Options for the resource.
  • interval_in_seconds (pulumi.Input[float]) – The interval, in seconds between probes to the backend endpoint for health status. The default value is 15, the minimum value is 5.
  • loadbalancer_id (pulumi.Input[str]) – The ID of the LoadBalancer in which to create the NAT Rule.
  • name (pulumi.Input[str]) – Specifies the name of the Probe.
  • number_of_probes (pulumi.Input[float]) – The number of failed probe attempts after which the backend endpoint is removed from rotation. The default value is 2. NumberOfProbes multiplied by intervalInSeconds value must be greater or equal to 10.Endpoints are returned to rotation when at least one probe is successful.
  • port (pulumi.Input[float]) – Port on which the Probe queries the backend endpoint. Possible values range from 1 to 65535, inclusive.
  • protocol (pulumi.Input[str]) – Specifies the protocol of the end point. Possible values are Http, Https or Tcp. If Tcp is specified, a received ACK is required for the probe to be successful. If Http is specified, a 200 OK response from the specified URI is required for the probe to be successful.
  • request_path (pulumi.Input[str]) – The URI used for requesting health status from the backend endpoint. Required if protocol is set to Http. Otherwise, it is not allowed.
  • resource_group_name (pulumi.Input[str]) – The name of the resource group in which to create the resource.
interval_in_seconds = None

The interval, in seconds between probes to the backend endpoint for health status. The default value is 15, the minimum value is 5.

loadbalancer_id = None

The ID of the LoadBalancer in which to create the NAT Rule.

name = None

Specifies the name of the Probe.

number_of_probes = None

The number of failed probe attempts after which the backend endpoint is removed from rotation. The default value is 2. NumberOfProbes multiplied by intervalInSeconds value must be greater or equal to 10.Endpoints are returned to rotation when at least one probe is successful.

port = None

Port on which the Probe queries the backend endpoint. Possible values range from 1 to 65535, inclusive.

protocol = None

Specifies the protocol of the end point. Possible values are Http, Https or Tcp. If Tcp is specified, a received ACK is required for the probe to be successful. If Http is specified, a 200 OK response from the specified URI is required for the probe to be successful.

request_path = None

The URI used for requesting health status from the backend endpoint. Required if protocol is set to Http. Otherwise, it is not allowed.

resource_group_name = None

The name of the resource group in which to create the resource.

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_azure.lb.Rule(resource_name, opts=None, backend_address_pool_id=None, backend_port=None, enable_floating_ip=None, frontend_ip_configuration_name=None, frontend_port=None, idle_timeout_in_minutes=None, load_distribution=None, loadbalancer_id=None, location=None, name=None, probe_id=None, protocol=None, resource_group_name=None, __name__=None, __opts__=None)

Manages a Load Balancer Rule.

NOTE When using this resource, the Load Balancer needs to have a FrontEnd IP Configuration Attached
Parameters:
  • resource_name (str) – The name of the resource.
  • opts (pulumi.ResourceOptions) – Options for the resource.
  • backend_address_pool_id (pulumi.Input[str]) – A reference to a Backend Address Pool over which this Load Balancing Rule operates.
  • backend_port (pulumi.Input[float]) – The port used for internal connections on the endpoint. Possible values range between 0 and 65535, inclusive.
  • enable_floating_ip (pulumi.Input[bool]) – Floating IP is pertinent to failover scenarios: a “floating” IP is reassigned to a secondary server in case the primary server fails. Floating IP is required for SQL AlwaysOn.
  • frontend_ip_configuration_name (pulumi.Input[str]) – The name of the frontend IP configuration to which the rule is associated.
  • frontend_port (pulumi.Input[float]) – The port for the external endpoint. Port numbers for each Rule must be unique within the Load Balancer. Possible values range between 0 and 65534, inclusive.
  • idle_timeout_in_minutes (pulumi.Input[float]) – Specifies the timeout for the Tcp idle connection. The value can be set between 4 and 30 minutes. The default value is 4 minutes. This element is only used when the protocol is set to Tcp.
  • load_distribution (pulumi.Input[str]) – Specifies the load balancing distribution type to be used by the Load Balancer. Possible values are: Default – The load balancer is configured to use a 5 tuple hash to map traffic to available servers. SourceIP – The load balancer is configured to use a 2 tuple hash to map traffic to available servers. SourceIPProtocol – The load balancer is configured to use a 3 tuple hash to map traffic to available servers. Also known as Session Persistence, where the options are called None, Client IP and Client IP and Protocol respectively.
  • loadbalancer_id (pulumi.Input[str]) – The ID of the Load Balancer in which to create the Rule.
  • name (pulumi.Input[str]) – Specifies the name of the LB Rule.
  • probe_id (pulumi.Input[str]) – A reference to a Probe used by this Load Balancing Rule.
  • protocol (pulumi.Input[str]) – The transport protocol for the external endpoint. Possible values are Tcp, Udp or All.
  • resource_group_name (pulumi.Input[str]) – The name of the resource group in which to create the resource.
backend_address_pool_id = None

A reference to a Backend Address Pool over which this Load Balancing Rule operates.

backend_port = None

The port used for internal connections on the endpoint. Possible values range between 0 and 65535, inclusive.

enable_floating_ip = None

Floating IP is pertinent to failover scenarios: a “floating” IP is reassigned to a secondary server in case the primary server fails. Floating IP is required for SQL AlwaysOn.

frontend_ip_configuration_name = None

The name of the frontend IP configuration to which the rule is associated.

frontend_port = None

The port for the external endpoint. Port numbers for each Rule must be unique within the Load Balancer. Possible values range between 0 and 65534, inclusive.

idle_timeout_in_minutes = None

Specifies the timeout for the Tcp idle connection. The value can be set between 4 and 30 minutes. The default value is 4 minutes. This element is only used when the protocol is set to Tcp.

load_distribution = None

Specifies the load balancing distribution type to be used by the Load Balancer. Possible values are: Default – The load balancer is configured to use a 5 tuple hash to map traffic to available servers. SourceIP – The load balancer is configured to use a 2 tuple hash to map traffic to available servers. SourceIPProtocol – The load balancer is configured to use a 3 tuple hash to map traffic to available servers. Also known as Session Persistence, where the options are called None, Client IP and Client IP and Protocol respectively.

loadbalancer_id = None

The ID of the Load Balancer in which to create the Rule.

name = None

Specifies the name of the LB Rule.

probe_id = None

A reference to a Probe used by this Load Balancing Rule.

protocol = None

The transport protocol for the external endpoint. Possible values are Tcp, Udp or All.

resource_group_name = None

The name of the resource group in which to create the resource.

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_azure.lb.get_backend_address_pool(loadbalancer_id=None, name=None, opts=None)

Use this data source to access information about an existing Load Balancer Backend Address Pool.

pulumi_azure.lb.get_lb(name=None, resource_group_name=None, opts=None)

Use this data source to access information about an existing Load Balancer