Microsoft.Network trafficmanagerprofiles/ExternalEndpoints

• più recenti
• 2024-04-01-anteprima
• 2022-04-01
• 2022-04-01-anteprima
• 2018-08-01

Definizione di risorsa Bicep

Il tipo di risorsa trafficmanagerprofiles/ExternalEndpoints 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.

Formato risorsa

Per creare una risorsa Microsoft.Network/trafficmanagerprofiles/ExternalEndpoints, aggiungere il bicep seguente al modello.

resource symbolicname 'Microsoft.Network/trafficmanagerprofiles/ExternalEndpoints@2024-04-01-preview' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    alwaysServe: 'string'
    customHeaders: [
      {
        name: 'string'
        value: 'string'
      }
    ]
    endpointLocation: 'string'
    endpointMonitorStatus: 'string'
    endpointStatus: 'string'
    geoMapping: [
      'string'
    ]
    minChildEndpoints: int
    minChildEndpointsIPv4: int
    minChildEndpointsIPv6: int
    priority: int
    subnets: [
      {
        first: 'string'
        last: 'string'
        scope: int
      }
    ]
    target: 'string'
    targetResourceId: 'string'
    weight: int
  }
}

Valori delle proprietà

Microsoft.Network/trafficmanagerprofiles/ExternalEndpoints

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: trafficmanagerprofiles
proprietà	Proprietà dell'endpoint di Gestione traffico.	Proprietà endpoint

Proprietà endpoint

Nome	Descrizione	Valore
sempreServire	Se Always Serve è abilitato, il probe per l'integrità degli endpoint verrà disabilitato e gli endpoint verranno inclusi nel metodo di routing del traffico.	'Disabilitato' 'Abilitato'
customHeaders	Elenco di intestazioni personalizzate.	EndpointPropertiesCustomHeadersItem[]
endpointLocation	Specifica il percorso degli endpoint esterni o annidati quando si usa il metodo di routing del traffico "Prestazioni".	corda
endpointMonitorStatus	Stato di monitoraggio dell'endpoint.	'CheckingEndpoint' 'Degradato' 'Disabilitato' 'Inattivo' 'In linea' 'Arrestato' 'Non monitorato'
endpointStatus	Stato dell'endpoint. Se l'endpoint è Abilitato, viene eseguito il probe per l'integrità dell'endpoint e viene incluso nel metodo di routing del traffico.	'Disabilitato' 'Abilitato'
geoMappatura	Elenco di paesi/aree mappate a questo endpoint quando si usa il metodo di routing del traffico 'Geografico'. Consultare la documentazione geografica di Gestione traffico per un elenco completo dei valori accettati.	stringa[]
minChildEndpoints	Numero minimo di endpoint che devono essere disponibili nel profilo figlio affinché il profilo padre sia considerato disponibile. Applicabile solo all'endpoint di tipo 'NestedEndpoints'.	Int
minChildEndpointsIPv4	Numero minimo di endpoint IPv4 (tipo di record DNS A) che devono essere disponibili nel profilo figlio affinché il profilo padre sia considerato disponibile. Applicabile solo all'endpoint di tipo 'NestedEndpoints'.	Int
minChildEndpointsIPv6	Numero minimo di endpoint IPv6 (tipo di record DNS AAAA) che devono essere disponibili nel profilo figlio affinché il profilo padre sia considerato disponibile. Applicabile solo all'endpoint di tipo 'NestedEndpoints'.	Int
priorità	Priorità di questo endpoint quando si usa il metodo di routing del traffico "Priority". I valori possibili sono compresi tra 1 e 1000, i valori inferiori rappresentano una priorità più alta. Si tratta di un parametro facoltativo. Se specificato, deve essere specificato in tutti gli endpoint e nessun endpoint può condividere lo stesso valore di priorità.	Int
Subnet	Elenco di subnet, indirizzi IP e/o intervalli di indirizzi mappati a questo endpoint quando si usa il metodo di routing del traffico "Subnet". Un elenco vuoto corrisponderà a tutti gli intervalli non coperti da altri endpoint.	EndpointPropertiesSubnetsItem[]
bersaglio	Nome DNS completo o indirizzo IP dell'endpoint. Gestione traffico restituisce questo valore nelle risposte DNS per indirizzare il traffico a questo endpoint.	corda
IdentificatoreRisorsaDiDestinazione	URI della risorsa di Azure dell'endpoint. Non applicabile agli endpoint di tipo 'ExternalEndpoints'.	corda
peso	Peso di questo endpoint quando si usa il metodo di routing del traffico "Ponderato". I valori possibili sono compresi tra 1 e 1000.	Int

EndpointPropertiesCustomHeadersItem

Nome	Descrizione	Valore
nome	Nome intestazione.	corda
valore	Valore dell'intestazione.	corda

EndpointPropertiesSubnetsItem

Nome	Descrizione	Valore
primo	Primo indirizzo nella subnet.	corda
ultimo	Ultimo indirizzo nella subnet.	corda
portata	Dimensioni del blocco (numero di bit iniziali nella subnet mask).	Int

Esempi di utilizzo

Esempi bicep

Esempio di base di distribuzione di un endpoint esterno all'interno di un profilo di Gestione traffico.

param resourceName string = 'acctest0001'

resource trafficManagerProfile 'Microsoft.Network/trafficManagerProfiles@2018-08-01' = {
  name: resourceName
  location: 'global'
  properties: {
    dnsConfig: {
      relativeName: 'acctest-tmp-230630034107608613'
      ttl: 30
    }
    monitorConfig: {
      expectedStatusCodeRanges: []
      intervalInSeconds: 30
      path: '/'
      port: 443
      protocol: 'HTTPS'
      timeoutInSeconds: 10
      toleratedNumberOfFailures: 3
    }
    trafficRoutingMethod: 'Weighted'
  }
}

resource externalendpoint 'Microsoft.Network/trafficManagerProfiles/ExternalEndpoints@2018-08-01' = {
  parent: trafficManagerProfile
  name: resourceName
  properties: {
    customHeaders: []
    endpointStatus: 'Enabled'
    subnets: []
    target: 'www.example.com'
    weight: 3
  }
}

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa trafficmanagerprofiles/ExternalEndpoints 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.

Formato risorsa

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

{
  "type": "Microsoft.Network/trafficmanagerprofiles/ExternalEndpoints",
  "apiVersion": "2024-04-01-preview",
  "name": "string",
  "properties": {
    "alwaysServe": "string",
    "customHeaders": [
      {
        "name": "string",
        "value": "string"
      }
    ],
    "endpointLocation": "string",
    "endpointMonitorStatus": "string",
    "endpointStatus": "string",
    "geoMapping": [ "string" ],
    "minChildEndpoints": "int",
    "minChildEndpointsIPv4": "int",
    "minChildEndpointsIPv6": "int",
    "priority": "int",
    "subnets": [
      {
        "first": "string",
        "last": "string",
        "scope": "int"
      }
    ],
    "target": "string",
    "targetResourceId": "string",
    "weight": "int"
  }
}

Valori delle proprietà

Microsoft.Network/trafficmanagerprofiles/ExternalEndpoints

Nome	Descrizione	Valore
versione dell'API	Versione dell'API	'2024-04-01-anteprima'
nome	Nome della risorsa	stringa (obbligatorio)
proprietà	Proprietà dell'endpoint di Gestione traffico.	Proprietà endpoint
digitare	Tipo di risorsa	'Microsoft.Network/trafficmanagerprofiles/ExternalEndpoints'

Proprietà endpoint

Nome	Descrizione	Valore
sempreServire	Se Always Serve è abilitato, il probe per l'integrità degli endpoint verrà disabilitato e gli endpoint verranno inclusi nel metodo di routing del traffico.	'Disabilitato' 'Abilitato'
customHeaders	Elenco di intestazioni personalizzate.	EndpointPropertiesCustomHeadersItem[]
endpointLocation	Specifica il percorso degli endpoint esterni o annidati quando si usa il metodo di routing del traffico "Prestazioni".	corda
endpointMonitorStatus	Stato di monitoraggio dell'endpoint.	'CheckingEndpoint' 'Degradato' 'Disabilitato' 'Inattivo' 'In linea' 'Arrestato' 'Non monitorato'
endpointStatus	Stato dell'endpoint. Se l'endpoint è Abilitato, viene eseguito il probe per l'integrità dell'endpoint e viene incluso nel metodo di routing del traffico.	'Disabilitato' 'Abilitato'
geoMappatura	Elenco di paesi/aree mappate a questo endpoint quando si usa il metodo di routing del traffico 'Geografico'. Consultare la documentazione geografica di Gestione traffico per un elenco completo dei valori accettati.	stringa[]
minChildEndpoints	Numero minimo di endpoint che devono essere disponibili nel profilo figlio affinché il profilo padre sia considerato disponibile. Applicabile solo all'endpoint di tipo 'NestedEndpoints'.	Int
minChildEndpointsIPv4	Numero minimo di endpoint IPv4 (tipo di record DNS A) che devono essere disponibili nel profilo figlio affinché il profilo padre sia considerato disponibile. Applicabile solo all'endpoint di tipo 'NestedEndpoints'.	Int
minChildEndpointsIPv6	Numero minimo di endpoint IPv6 (tipo di record DNS AAAA) che devono essere disponibili nel profilo figlio affinché il profilo padre sia considerato disponibile. Applicabile solo all'endpoint di tipo 'NestedEndpoints'.	Int
priorità	Priorità di questo endpoint quando si usa il metodo di routing del traffico "Priority". I valori possibili sono compresi tra 1 e 1000, i valori inferiori rappresentano una priorità più alta. Si tratta di un parametro facoltativo. Se specificato, deve essere specificato in tutti gli endpoint e nessun endpoint può condividere lo stesso valore di priorità.	Int
Subnet	Elenco di subnet, indirizzi IP e/o intervalli di indirizzi mappati a questo endpoint quando si usa il metodo di routing del traffico "Subnet". Un elenco vuoto corrisponderà a tutti gli intervalli non coperti da altri endpoint.	EndpointPropertiesSubnetsItem[]
bersaglio	Nome DNS completo o indirizzo IP dell'endpoint. Gestione traffico restituisce questo valore nelle risposte DNS per indirizzare il traffico a questo endpoint.	corda
IdentificatoreRisorsaDiDestinazione	URI della risorsa di Azure dell'endpoint. Non applicabile agli endpoint di tipo 'ExternalEndpoints'.	corda
peso	Peso di questo endpoint quando si usa il metodo di routing del traffico "Ponderato". I valori possibili sono compresi tra 1 e 1000.	Int

EndpointPropertiesCustomHeadersItem

Nome	Descrizione	Valore
nome	Nome intestazione.	corda
valore	Valore dell'intestazione.	corda

EndpointPropertiesSubnetsItem

Nome	Descrizione	Valore
primo	Primo indirizzo nella subnet.	corda
ultimo	Ultimo indirizzo nella subnet.	corda
portata	Dimensioni del blocco (numero di bit iniziali nella subnet mask).	Int

Esempi di utilizzo

Modelli di avvio rapido di Azure

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

Sagoma	Descrizione
Aggiungere un endpoint al profilo di Gestione traffico esistente	Modello di esempio per aggiungere un endpoint esterno a un profilo di Gestione traffico di Azure esistente

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa trafficmanagerprofiles/ExternalEndpoints può essere distribuito con operazioni destinate a:

• Gruppi di risorse

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

Formato risorsa

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/trafficmanagerprofiles/ExternalEndpoints@2024-04-01-preview"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      alwaysServe = "string"
      customHeaders = [
        {
          name = "string"
          value = "string"
        }
      ]
      endpointLocation = "string"
      endpointMonitorStatus = "string"
      endpointStatus = "string"
      geoMapping = [
        "string"
      ]
      minChildEndpoints = int
      minChildEndpointsIPv4 = int
      minChildEndpointsIPv6 = int
      priority = int
      subnets = [
        {
          first = "string"
          last = "string"
          scope = int
        }
      ]
      target = "string"
      targetResourceId = "string"
      weight = int
    }
  }
}

Valori delle proprietà

Microsoft.Network/trafficmanagerprofiles/ExternalEndpoints

Nome	Descrizione	Valore
nome	Nome della risorsa	stringa (obbligatorio)
parent_id	ID della risorsa padre per questa risorsa.	ID per la risorsa di tipo: trafficmanagerprofiles
proprietà	Proprietà dell'endpoint di Gestione traffico.	Proprietà endpoint
digitare	Tipo di risorsa	"Microsoft.Network/trafficmanagerprofiles/ExternalEndpoints@2024-04-01-preview"

Proprietà endpoint

Nome	Descrizione	Valore
sempreServire	Se Always Serve è abilitato, il probe per l'integrità degli endpoint verrà disabilitato e gli endpoint verranno inclusi nel metodo di routing del traffico.	'Disabilitato' 'Abilitato'
customHeaders	Elenco di intestazioni personalizzate.	EndpointPropertiesCustomHeadersItem[]
endpointLocation	Specifica il percorso degli endpoint esterni o annidati quando si usa il metodo di routing del traffico "Prestazioni".	corda
endpointMonitorStatus	Stato di monitoraggio dell'endpoint.	'CheckingEndpoint' 'Degradato' 'Disabilitato' 'Inattivo' 'In linea' 'Arrestato' 'Non monitorato'
endpointStatus	Stato dell'endpoint. Se l'endpoint è Abilitato, viene eseguito il probe per l'integrità dell'endpoint e viene incluso nel metodo di routing del traffico.	'Disabilitato' 'Abilitato'
geoMappatura	Elenco di paesi/aree mappate a questo endpoint quando si usa il metodo di routing del traffico 'Geografico'. Consultare la documentazione geografica di Gestione traffico per un elenco completo dei valori accettati.	stringa[]
minChildEndpoints	Numero minimo di endpoint che devono essere disponibili nel profilo figlio affinché il profilo padre sia considerato disponibile. Applicabile solo all'endpoint di tipo 'NestedEndpoints'.	Int
minChildEndpointsIPv4	Numero minimo di endpoint IPv4 (tipo di record DNS A) che devono essere disponibili nel profilo figlio affinché il profilo padre sia considerato disponibile. Applicabile solo all'endpoint di tipo 'NestedEndpoints'.	Int
minChildEndpointsIPv6	Numero minimo di endpoint IPv6 (tipo di record DNS AAAA) che devono essere disponibili nel profilo figlio affinché il profilo padre sia considerato disponibile. Applicabile solo all'endpoint di tipo 'NestedEndpoints'.	Int
priorità	Priorità di questo endpoint quando si usa il metodo di routing del traffico "Priority". I valori possibili sono compresi tra 1 e 1000, i valori inferiori rappresentano una priorità più alta. Si tratta di un parametro facoltativo. Se specificato, deve essere specificato in tutti gli endpoint e nessun endpoint può condividere lo stesso valore di priorità.	Int
Subnet	Elenco di subnet, indirizzi IP e/o intervalli di indirizzi mappati a questo endpoint quando si usa il metodo di routing del traffico "Subnet". Un elenco vuoto corrisponderà a tutti gli intervalli non coperti da altri endpoint.	EndpointPropertiesSubnetsItem[]
bersaglio	Nome DNS completo o indirizzo IP dell'endpoint. Gestione traffico restituisce questo valore nelle risposte DNS per indirizzare il traffico a questo endpoint.	corda
IdentificatoreRisorsaDiDestinazione	URI della risorsa di Azure dell'endpoint. Non applicabile agli endpoint di tipo 'ExternalEndpoints'.	corda
peso	Peso di questo endpoint quando si usa il metodo di routing del traffico "Ponderato". I valori possibili sono compresi tra 1 e 1000.	Int

EndpointPropertiesCustomHeadersItem

Nome	Descrizione	Valore
nome	Nome intestazione.	corda
valore	Valore dell'intestazione.	corda

EndpointPropertiesSubnetsItem

Nome	Descrizione	Valore
primo	Primo indirizzo nella subnet.	corda
ultimo	Ultimo indirizzo nella subnet.	corda
portata	Dimensioni del blocco (numero di bit iniziali nella subnet mask).	Int

Esempi di utilizzo

Esempi di Terraform

Esempio di base di distribuzione di un endpoint esterno all'interno di un profilo di Gestione traffico.

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" "trafficManagerProfile" {
  type      = "Microsoft.Network/trafficManagerProfiles@2018-08-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = "global"
  body = {
    properties = {
      dnsConfig = {
        relativeName = "acctest-tmp-230630034107608613"
        ttl          = 30
      }
      monitorConfig = {
        expectedStatusCodeRanges = [
        ]
        intervalInSeconds         = 30
        path                      = "/"
        port                      = 443
        protocol                  = "HTTPS"
        timeoutInSeconds          = 10
        toleratedNumberOfFailures = 3
      }
      trafficRoutingMethod = "Weighted"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "ExternalEndpoint" {
  type      = "Microsoft.Network/trafficManagerProfiles/ExternalEndpoints@2018-08-01"
  parent_id = azapi_resource.trafficManagerProfile.id
  name      = var.resource_name
  body = {
    properties = {
      customHeaders = [
      ]
      endpointStatus = "Enabled"
      subnets = [
      ]
      target = "www.example.com"
      weight = 3
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}