The loadBalancers/backendAddressPools resource type can be deployed with operations that target:
For a list of changed properties in each API version, see change log.
To create a Microsoft.Network/loadBalancers/backendAddressPools resource, add the following JSON to your template.
{
"type": "Microsoft.Network/loadBalancers/backendAddressPools",
"apiVersion": "2023-04-01",
"name": "string",
"properties": {
"drainPeriodInSeconds": "int",
"loadBalancerBackendAddresses": [
{
"name": "string",
"properties": {
"adminState": "string",
"ipAddress": "string",
"loadBalancerFrontendIPConfiguration": {
"id": "string"
},
"subnet": {
"id": "string"
},
"virtualNetwork": {
"id": "string"
}
}
}
],
"location": "string",
"syncMode": "string",
"tunnelInterfaces": [
{
"identifier": "int",
"port": "int",
"protocol": "string",
"type": "string"
}
],
"virtualNetwork": {
"id": "string"
}
}
}
Name | Description | Value |
---|---|---|
type | The resource type | 'Microsoft.Network/loadBalancers/backendAddressPools' |
apiVersion | The resource api version | '2023-04-01' |
name | The resource name See how to set names and types for child resources in JSON ARM templates. |
string (required) |
properties | Properties of load balancer backend address pool. | BackendAddressPoolPropertiesFormat |
Name | Description | Value |
---|---|---|
drainPeriodInSeconds | Amount of seconds Load Balancer waits for before sending RESET to client and backend address. | int |
loadBalancerBackendAddresses | An array of backend addresses. | LoadBalancerBackendAddress[] |
location | The location of the backend address pool. | string |
syncMode | Backend address synchronous mode for the backend pool | 'Automatic' 'Manual' |
tunnelInterfaces | An array of gateway load balancer tunnel interfaces. | GatewayLoadBalancerTunnelInterface[] |
virtualNetwork | A reference to a virtual network. | SubResource |
Name | Description | Value |
---|---|---|
name | Name of the backend address. | string |
properties | Properties of load balancer backend address pool. | LoadBalancerBackendAddressPropertiesFormat |
Name | Description | Value |
---|---|---|
adminState | A list of administrative states which once set can override health probe so that Load Balancer will always forward new connections to backend, or deny new connections and reset existing connections. | 'Down' 'None' 'Up' |
ipAddress | IP Address belonging to the referenced virtual network. | string |
loadBalancerFrontendIPConfiguration | Reference to the frontend ip address configuration defined in regional loadbalancer. | SubResource |
subnet | Reference to an existing subnet. | SubResource |
virtualNetwork | Reference to an existing virtual network. | SubResource |
Name | Description | Value |
---|---|---|
id | Resource ID. | string |
Name | Description | Value |
---|---|---|
identifier | Identifier of gateway load balancer tunnel interface. | int |
port | Port of gateway load balancer tunnel interface. | int |
protocol | Protocol of gateway load balancer tunnel interface. | 'Native' 'None' 'VXLAN' |
type | Traffic type of gateway load balancer tunnel interface. | 'External' 'Internal' 'None' |
The following quickstart templates deploy this resource type.
Template | Description |
---|---|
Public Load Balancer chained to a Gateway Load Balancer |
This template allows you to deploy a Public Standard Load Balancer chained to a Gateway Load Balancer. The traffic incoming from internet is routed to the Gateway Load Balancer with linux VMs (NVAs) in the backend pool. |
Create a cross-region load balancer |
This template creates a cross-region load balancer with a backend pool containing two regional load balancers. Cross-region load balancer is currently available in limited regions. The regional load balancers behind the cross-region load balancer can be in any region. |
Standard Load Balancer with Backend Pool by IP Addresses |
This template is used to demonstrate how ARM Templates can be used to configure the Backend Pool of a Load Balancer by IP Address as outlined in the Backend Pool management document. |