Microsoft. Bilanciatori di carico di rete/pool di indirizzi backend

Definizione di risorsa Bicep

Il tipo di risorsa loadBalancers/backendAddressPools può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Esempi di utilizzo

Esempi bicep

Un esempio di base di distribuzione del pool di indirizzi back-end di Load Balancer.

param resourceName string = 'acctest0001'
param location string = 'westeurope'

resource loadBalancer 'Microsoft.Network/loadBalancers@2022-07-01' = {
  name: resourceName
  location: location
  sku: {
    name: 'Standard'
    tier: 'Regional'
  }
  properties: {
    frontendIPConfigurations: [
      {
        name: 'internal'
        properties: {
          publicIPAddress: {
            id: publicIPAddress.id
          }
        }
      }
    ]
  }
}

resource backendAddressPool 'Microsoft.Network/loadBalancers/backendAddressPools@2022-07-01' = {
  name: resourceName
  parent: loadBalancer
  properties: {}
}

resource publicIPAddress 'Microsoft.Network/publicIPAddresses@2022-07-01' = {
  name: resourceName
  location: location
  sku: {
    name: 'Standard'
    tier: 'Regional'
  }
  properties: {
    ddosSettings: {
      protectionMode: 'VirtualNetworkInherited'
    }
    idleTimeoutInMinutes: 4
    publicIPAddressVersion: 'IPv4'
    publicIPAllocationMethod: 'Static'
  }
}

Moduli verificati di Azure

Per distribuire questo tipo di risorsa, è possibile usare moduli verificati di Azure.

Module Descrizione
Load Balancer - Pool di indirizzi backend AVM Child Module per Load Balancer - Pool di indirizzi backend

Esempi di avvio rapido di Azure

I modelli di avvio rapido di Azure seguenti contengono esempi Bicep per la distribuzione di questo tipo di risorsa.

File bicipite Descrizione
Creare un servizio di bilanciamento del carico tra aree Questo modello crea un servizio di bilanciamento del carico tra aree con un pool back-end contenente due servizi di bilanciamento del carico a livello di area. Il servizio di bilanciamento del carico tra aree è attualmente disponibile in aree limitate. I servizi di bilanciamento del carico a livello di area dietro il servizio di bilanciamento del carico tra aree possono trovarsi in qualsiasi area.
servizio di bilanciamento del carico pubblico concatenato a un servizio di bilanciamento del carico del gateway Questo modello consente di distribuire un'istanza di Load Balancer Standard pubblica concatenato a un servizio di bilanciamento del carico del gateway. Il traffico in ingresso da Internet viene instradato al servizio di bilanciamento del carico del gateway con macchine virtuali Linux nel pool back-end.

Formato risorsa

Per creare una risorsa Microsoft.Network/loadBalancers/backendAddressPools, aggiungere il bicep seguente al modello.

resource symbolicname 'Microsoft.Network/loadBalancers/backendAddressPools@2026-03-01' = {
  parent: resourceSymbolicName
  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'
    }
  }
}

Valori delle proprietà

Microsoft.Network/loadBalancers/backendAddressPools

Nome Descrizione Valore
nome Nome della risorsa stringa (obbligatorio)
genitore In Bicep è possibile specificare la risorsa padre per una risorsa figlio. È necessario aggiungere questa proprietà solo quando la risorsa figlio viene dichiarata all'esterno della risorsa padre.

Per altre informazioni, vedere risorsa figlio all'esterno della risorsa padre.
Nome simbolico per la risorsa di tipo: loadBalancers
proprietà Proprietà del pool di indirizzi back-end del servizio di bilanciamento del carico. BackendAddressPoolPropertiesFormat

BackendAddressPoolPropertiesFormat

Nome Descrizione Valore
drainPeriodInSeconds Quantità di secondi di attesa del servizio di bilanciamento del carico prima di inviare RESET all'indirizzo client e back-end. Int
loadBalancerBackendAddresses Matrice di indirizzi back-end. LoadBalancerBackendAddress[]
ubicazione Posizione del pool di indirizzi back-end. corda
syncMode Modalità sincrona dell'indirizzo back-end per il pool back-end 'Automatico'
'Manuale'
tunnelInterfaces Matrice di interfacce del tunnel del servizio di bilanciamento del carico del gateway. GatewayLoadBalancerTunnelInterface[]
Rete virtuale Riferimento a una rete virtuale. SubResource

Interfaccia GatewayLoadBalancerTunnel

Nome Descrizione Valore
identificatore Identificatore dell'interfaccia del tunnel del servizio di bilanciamento del carico del gateway. Int
porto Porta dell'interfaccia del tunnel del servizio di bilanciamento del carico del gateway. Int
protocollo Protocollo dell'interfaccia del tunnel del servizio di bilanciamento del carico del gateway. 'Nativo'
'Nessuno'
'VXLAN'
digitare Tipo di traffico dell'interfaccia del tunnel del servizio di bilanciamento del carico del gateway. 'Esterno'
'Interno'
'Nessuno'

LoadBalancerBackendAddress

Nome Descrizione Valore
nome Nome dell'indirizzo back-end. corda
proprietà Proprietà del pool di indirizzi back-end del servizio di bilanciamento del carico. LoadBalancerBackendAddressPropertiesFormat

LoadBalancerBackendAddressPropertiesFormat

Nome Descrizione Valore
adminStato Elenco di stati amministrativi che, una volta impostati, possono eseguire l'override del probe di integrità in modo che Load Balancer inoltra sempre nuove connessioni al back-end o nega nuove connessioni e reimposta le connessioni esistenti. 'Giù'
'Nessuno'
'Su'
indirizzo IP Indirizzo IP appartenente alla rete virtuale a cui si fa riferimento. corda
loadBalancerFrontendIPConfiguration Riferimento alla configurazione dell'indirizzo IP front-end definita nel servizio di bilanciamento del carico a livello di area. SubResource
sottorete Riferimento a una subnet esistente. SubResource
Rete virtuale Riferimento a una rete virtuale esistente. SubResource

Sottorisorsa

Nome Descrizione Valore
Id ID risorsa. corda

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa loadBalancers/backendAddressPools può essere distribuito con operazioni destinate a:

Esempi di utilizzo

Modelli di avvio rapido di Azure

I modelli di avvio rapido di Azure seguenti distribuire questo tipo di risorsa.

Sagoma Descrizione
Creare un servizio di bilanciamento del carico tra aree

Distribuire in Azure
Questo modello crea un servizio di bilanciamento del carico tra aree con un pool back-end contenente due servizi di bilanciamento del carico a livello di area. Il servizio di bilanciamento del carico tra aree è attualmente disponibile in aree limitate. I servizi di bilanciamento del carico a livello di area dietro il servizio di bilanciamento del carico tra aree possono trovarsi in qualsiasi area.
servizio di bilanciamento del carico pubblico concatenato a un servizio di bilanciamento del carico del gateway

Distribuire in Azure
Questo modello consente di distribuire un'istanza di Load Balancer Standard pubblica concatenato a un servizio di bilanciamento del carico del gateway. Il traffico in ingresso da Internet viene instradato al servizio di bilanciamento del carico del gateway con macchine virtuali Linux nel pool back-end.
Load Balancer Standard con pool back-end per indirizzi IP

Distribuire in Azure
Questo modello viene usato per illustrare come usare i modelli di Resource Manager per configurare il pool back-end di un servizio di bilanciamento del carico in base all'indirizzo IP, come descritto nel documento gestione del pool back-end.

Formato risorsa

Per creare una risorsa Microsoft.Network/loadBalancers/backendAddressPools, aggiungere il codice JSON seguente al modello.

{
  "type": "Microsoft.Network/loadBalancers/backendAddressPools",
  "apiVersion": "2026-03-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"
    }
  }
}

Valori delle proprietà

Microsoft.Network/loadBalancers/backendAddressPools

Nome Descrizione Valore
versione dell'API Versione dell'API '2026-03-01'
nome Nome della risorsa stringa (obbligatorio)
proprietà Proprietà del pool di indirizzi back-end del servizio di bilanciamento del carico. BackendAddressPoolPropertiesFormat
digitare Tipo di risorsa 'Microsoft.Network/loadBalancers/backendAddressPools'

BackendAddressPoolPropertiesFormat

Nome Descrizione Valore
drainPeriodInSeconds Quantità di secondi di attesa del servizio di bilanciamento del carico prima di inviare RESET all'indirizzo client e back-end. Int
loadBalancerBackendAddresses Matrice di indirizzi back-end. LoadBalancerBackendAddress[]
ubicazione Posizione del pool di indirizzi back-end. corda
syncMode Modalità sincrona dell'indirizzo back-end per il pool back-end 'Automatico'
'Manuale'
tunnelInterfaces Matrice di interfacce del tunnel del servizio di bilanciamento del carico del gateway. GatewayLoadBalancerTunnelInterface[]
Rete virtuale Riferimento a una rete virtuale. SubResource

Interfaccia GatewayLoadBalancerTunnel

Nome Descrizione Valore
identificatore Identificatore dell'interfaccia del tunnel del servizio di bilanciamento del carico del gateway. Int
porto Porta dell'interfaccia del tunnel del servizio di bilanciamento del carico del gateway. Int
protocollo Protocollo dell'interfaccia del tunnel del servizio di bilanciamento del carico del gateway. 'Nativo'
'Nessuno'
'VXLAN'
digitare Tipo di traffico dell'interfaccia del tunnel del servizio di bilanciamento del carico del gateway. 'Esterno'
'Interno'
'Nessuno'

LoadBalancerBackendAddress

Nome Descrizione Valore
nome Nome dell'indirizzo back-end. corda
proprietà Proprietà del pool di indirizzi back-end del servizio di bilanciamento del carico. LoadBalancerBackendAddressPropertiesFormat

LoadBalancerBackendAddressPropertiesFormat

Nome Descrizione Valore
adminStato Elenco di stati amministrativi che, una volta impostati, possono eseguire l'override del probe di integrità in modo che Load Balancer inoltra sempre nuove connessioni al back-end o nega nuove connessioni e reimposta le connessioni esistenti. 'Giù'
'Nessuno'
'Su'
indirizzo IP Indirizzo IP appartenente alla rete virtuale a cui si fa riferimento. corda
loadBalancerFrontendIPConfiguration Riferimento alla configurazione dell'indirizzo IP front-end definita nel servizio di bilanciamento del carico a livello di area. SubResource
sottorete Riferimento a una subnet esistente. SubResource
Rete virtuale Riferimento a una rete virtuale esistente. SubResource

Sottorisorsa

Nome Descrizione Valore
Id ID risorsa. corda

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa loadBalancers/backendAddressPools può essere distribuito con operazioni destinate a:

  • Gruppi di risorse Per un elenco delle proprietà modificate in ogni versione dell'API, vedi il registro modifiche.

Esempi di utilizzo

Esempi di Terraform

Un esempio di base di distribuzione del pool di indirizzi back-end di Load Balancer.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "publicIPAddress" {
  type      = "Microsoft.Network/publicIPAddresses@2022-07-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      ddosSettings = {
        protectionMode = "VirtualNetworkInherited"
      }
      idleTimeoutInMinutes     = 4
      publicIPAddressVersion   = "IPv4"
      publicIPAllocationMethod = "Static"
    }
    sku = {
      name = "Standard"
      tier = "Regional"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "loadBalancer" {
  type      = "Microsoft.Network/loadBalancers@2022-07-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      frontendIPConfigurations = [
        {
          name = "internal"
          properties = {
            publicIPAddress = {
              id = azapi_resource.publicIPAddress.id
            }
          }
        },
      ]
    }
    sku = {
      name = "Standard"
      tier = "Regional"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "backendAddressPool" {
  type      = "Microsoft.Network/loadBalancers/backendAddressPools@2022-07-01"
  parent_id = azapi_resource.loadBalancer.id
  name      = var.resource_name
  body = {
    properties = {
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Formato risorsa

Per creare una risorsa Microsoft.Network/loadBalancers/backendAddressPools, aggiungere il codice Terraform seguente al modello.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/loadBalancers/backendAddressPools@2026-03-01"
  name = "string"
  parent_id = "string"
  body = {
    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"
      }
    }
  }
}

Valori delle proprietà

Microsoft.Network/loadBalancers/backendAddressPools

Nome Descrizione Valore
nome Nome della risorsa stringa (obbligatorio)
parent_id ID della risorsa padre per questa risorsa. ID per la risorsa di tipo: loadBalancers
proprietà Proprietà del pool di indirizzi back-end del servizio di bilanciamento del carico. BackendAddressPoolPropertiesFormat
digitare Tipo di risorsa "Microsoft. Rete/bilanciatori di carico/backendAddressPools@2026-03-01"

BackendAddressPoolPropertiesFormat

Nome Descrizione Valore
drainPeriodInSeconds Quantità di secondi di attesa del servizio di bilanciamento del carico prima di inviare RESET all'indirizzo client e back-end. Int
loadBalancerBackendAddresses Matrice di indirizzi back-end. LoadBalancerBackendAddress[]
ubicazione Posizione del pool di indirizzi back-end. corda
syncMode Modalità sincrona dell'indirizzo back-end per il pool back-end 'Automatico'
'Manuale'
tunnelInterfaces Matrice di interfacce del tunnel del servizio di bilanciamento del carico del gateway. GatewayLoadBalancerTunnelInterface[]
Rete virtuale Riferimento a una rete virtuale. SubResource

Interfaccia GatewayLoadBalancerTunnel

Nome Descrizione Valore
identificatore Identificatore dell'interfaccia del tunnel del servizio di bilanciamento del carico del gateway. Int
porto Porta dell'interfaccia del tunnel del servizio di bilanciamento del carico del gateway. Int
protocollo Protocollo dell'interfaccia del tunnel del servizio di bilanciamento del carico del gateway. 'Nativo'
'Nessuno'
'VXLAN'
digitare Tipo di traffico dell'interfaccia del tunnel del servizio di bilanciamento del carico del gateway. 'Esterno'
'Interno'
'Nessuno'

LoadBalancerBackendAddress

Nome Descrizione Valore
nome Nome dell'indirizzo back-end. corda
proprietà Proprietà del pool di indirizzi back-end del servizio di bilanciamento del carico. LoadBalancerBackendAddressPropertiesFormat

LoadBalancerBackendAddressPropertiesFormat

Nome Descrizione Valore
adminStato Elenco di stati amministrativi che, una volta impostati, possono eseguire l'override del probe di integrità in modo che Load Balancer inoltra sempre nuove connessioni al back-end o nega nuove connessioni e reimposta le connessioni esistenti. 'Giù'
'Nessuno'
'Su'
indirizzo IP Indirizzo IP appartenente alla rete virtuale a cui si fa riferimento. corda
loadBalancerFrontendIPConfiguration Riferimento alla configurazione dell'indirizzo IP front-end definita nel servizio di bilanciamento del carico a livello di area. SubResource
sottorete Riferimento a una subnet esistente. SubResource
Rete virtuale Riferimento a una rete virtuale esistente. SubResource

Sottorisorsa

Nome Descrizione Valore
Id ID risorsa. corda