Front Doors - Create Or Update

Riferimento

Servizio:: Front Door Service

Versione API:: 2019-05-01

Crea un nuovo frontdoor con un nome Frontdoor sotto la sottoscrizione e il gruppo di risorse specificati.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/frontDoors/{frontDoorName}?api-version=2019-05-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
frontDoorName	path	True	string	Nome della Frontdoor che è univoca a livello globale. Criterio di espressione regolare: `^[a-zA-Z0-9]+([-a-zA-Z0-9]?[a-zA-Z0-9])*$`
resourceGroupName	path	True	string	Nome del gruppo di risorse all'interno della sottoscrizione di Azure. Criterio di espressione regolare: `^[a-zA-Z0-9_\-\.]*[^\.]$`
subscriptionId	path	True	string	Credenziali della sottoscrizione che identificano in modo univoco la sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata di servizio.
api-version	query	True	string	Versione API client.

Corpo della richiesta

Nome	Tipo	Descrizione
location	string	Percorso della risorsa.
properties.backendPools	BackendPool[]	Pool back-end disponibili per le regole di routing.
properties.backendPoolsSettings	BackendPoolsSettings	Impostazioni per tutti i back-endPool
properties.enabledState	FrontDoorEnabledState	Stato operativo del bilanciamento del carico Frontdoor. I valori consentiti sono "Enabled" o "Disabled"
properties.friendlyName	string	Nome descrittivo per la frontdoor
properties.frontendEndpoints	FrontendEndpoint[]	Endpoint front-end disponibili per le regole di routing.
properties.healthProbeSettings	HealthProbeSettingsModel[]	Impostazioni del probe di integrità associate a questa istanza di frontdoor.
properties.loadBalancingSettings	LoadBalancingSettingsModel[]	Impostazioni del bilanciamento del carico associate a questa istanza di frontdoor.
properties.routingRules	RoutingRule[]	Regole di routing associate a questa frontdoor.
tags	object	Tag di risorse.

Risposte

Nome	Tipo	Descrizione
200 OK	FrontDoor	OK. La richiesta ha avuto esito positivo.
201 Created	FrontDoor	Creazione riuscita. La richiesta è stata soddisfatta e è stata creata una nuova frontdoor.
202 Accepted	FrontDoor	Accettato. La richiesta è stata accettata per l'elaborazione e l'operazione verrà completata in modo asincrono.
Other Status Codes	ErrorResponse	Risposta di errore frontdoor che descrive perché l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

Create or update specific Front Door

Esempio di richiesta

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1?api-version=2019-05-01

{
  "location": "westus",
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  },
  "properties": {
    "routingRules": [
      {
        "name": "routingRule1",
        "properties": {
          "frontendEndpoints": [
            {
              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/frontendEndpoint1"
            },
            {
              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/default"
            }
          ],
          "acceptedProtocols": [
            "Http"
          ],
          "patternsToMatch": [
            "/*"
          ],
          "routeConfiguration": {
            "@odata.type": "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration",
            "backendPool": {
              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/backendPools/backendPool1"
            }
          },
          "enabledState": "Enabled"
        }
      }
    ],
    "healthProbeSettings": [
      {
        "name": "healthProbeSettings1",
        "properties": {
          "path": "/",
          "protocol": "Http",
          "intervalInSeconds": 120,
          "enabledState": "Enabled",
          "healthProbeMethod": "HEAD"
        }
      }
    ],
    "loadBalancingSettings": [
      {
        "name": "loadBalancingSettings1",
        "properties": {
          "sampleSize": 4,
          "successfulSamplesRequired": 2
        }
      }
    ],
    "backendPools": [
      {
        "name": "backendPool1",
        "properties": {
          "backends": [
            {
              "address": "w3.contoso.com",
              "httpPort": 80,
              "httpsPort": 443,
              "weight": 1,
              "priority": 2
            },
            {
              "address": "contoso.com.website-us-west-2.othercloud.net",
              "httpPort": 80,
              "httpsPort": 443,
              "weight": 2,
              "priority": 1
            },
            {
              "address": "contoso1.azurewebsites.net",
              "httpPort": 80,
              "httpsPort": 443,
              "weight": 1,
              "priority": 1
            }
          ],
          "loadBalancingSettings": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/loadBalancingSettings/loadBalancingSettings1"
          },
          "healthProbeSettings": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/healthProbeSettings/healthProbeSettings1"
          }
        }
      }
    ],
    "frontendEndpoints": [
      {
        "name": "frontendEndpoint1",
        "properties": {
          "hostName": "www.contoso.com",
          "sessionAffinityEnabledState": "Enabled",
          "sessionAffinityTtlSeconds": 60,
          "webApplicationFirewallPolicyLink": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoorWebApplicationFirewallPolicies/policy1"
          }
        }
      },
      {
        "name": "default",
        "properties": {
          "hostName": "frontDoor1.azurefd.net"
        }
      }
    ],
    "backendPoolsSettings": {
      "enforceCertificateNameCheck": "Enabled",
      "sendRecvTimeoutSeconds": 60
    },
    "enabledState": "Enabled"
  }
}

Risposta di esempio

Codice di stato:: 200

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1",
  "name": "frontDoor1",
  "type": "Microsoft.Network/frontDoor",
  "location": "westus",
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  },
  "properties": {
    "routingRules": [
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/routingRules/routingRule1",
        "name": "routingRule1",
        "properties": {
          "frontendEndpoints": [
            {
              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/frontendEndpoint1"
            },
            {
              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/default"
            }
          ],
          "acceptedProtocols": [
            "Http"
          ],
          "patternsToMatch": [
            "/*"
          ],
          "routeConfiguration": {
            "@odata.type": "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration",
            "customForwardingPath": "",
            "forwardingProtocol": "MatchRequest",
            "backendPool": {
              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/backendPools/backendPool1"
            }
          },
          "enabledState": "Enabled"
        }
      }
    ],
    "healthProbeSettings": [
      {
        "name": "healthProbeSettings1",
        "properties": {
          "path": "/",
          "protocol": "Http",
          "intervalInSeconds": 120,
          "enabledState": "Enabled",
          "healthProbeMethod": "HEAD"
        }
      }
    ],
    "loadBalancingSettings": [
      {
        "name": "loadBalancingSettings1",
        "properties": {
          "sampleSize": 4,
          "successfulSamplesRequired": 2
        }
      }
    ],
    "backendPools": [
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/backendPools/backendPool1",
        "name": "backendPool1",
        "properties": {
          "backends": [
            {
              "address": "w3.contoso.com",
              "httpPort": 80,
              "httpsPort": 443,
              "enabledState": "Enabled",
              "weight": 1,
              "priority": 2
            },
            {
              "address": "contoso.com.website-us-west-2.othercloud.net",
              "httpPort": 80,
              "httpsPort": 443,
              "enabledState": "Enabled",
              "weight": 2,
              "priority": 1
            },
            {
              "address": "contoso1.azurewebsites.net",
              "httpPort": 80,
              "httpsPort": 443,
              "enabledState": "Enabled",
              "weight": 1,
              "priority": 1
            }
          ],
          "loadBalancingSettings": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/loadBalancingSettings/loadBalancingSettings1"
          },
          "healthProbeSettings": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/healthProbeSettings/healthProbeSettings1"
          }
        }
      }
    ],
    "frontendEndpoints": [
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/frontendEndpoint1",
        "name": "frontendEndpoint1",
        "properties": {
          "hostName": "www.contoso.com",
          "sessionAffinityEnabledState": "Enabled",
          "sessionAffinityTtlSeconds": 60,
          "webApplicationFirewallPolicyLink": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoorWebApplicationFirewallPolicies/policy1"
          }
        }
      },
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/default",
        "name": "default",
        "properties": {
          "hostName": "frontDoor1.azurefd.net"
        }
      }
    ],
    "backendPoolsSettings": {
      "enforceCertificateNameCheck": "Enabled",
      "sendRecvTimeoutSeconds": 60
    },
    "enabledState": "Enabled",
    "resourceState": "Creating",
    "provisioningState": "Succeeded",
    "cname": "frontDoor1.azurefd.net"
  }
}

Codice di stato:: 201

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1",
  "name": "frontDoor1",
  "type": "Microsoft.Network/frontDoor",
  "location": "westus",
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  },
  "properties": {
    "routingRules": [
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/routingRules/routingRule1",
        "name": "routingRule1",
        "properties": {
          "frontendEndpoints": [
            {
              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/frontendEndpoint1"
            },
            {
              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/default"
            }
          ],
          "acceptedProtocols": [
            "Http"
          ],
          "patternsToMatch": [
            "/*"
          ],
          "routeConfiguration": {
            "@odata.type": "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration",
            "customForwardingPath": "",
            "forwardingProtocol": "MatchRequest",
            "backendPool": {
              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/backendPools/backendPool1"
            }
          },
          "enabledState": "Enabled"
        }
      }
    ],
    "healthProbeSettings": [
      {
        "name": "healthProbeSettings1",
        "properties": {
          "path": "/",
          "protocol": "Http",
          "intervalInSeconds": 120,
          "enabledState": "Enabled",
          "healthProbeMethod": "HEAD"
        }
      }
    ],
    "loadBalancingSettings": [
      {
        "name": "loadBalancingSettings1",
        "properties": {
          "sampleSize": 4,
          "successfulSamplesRequired": 2
        }
      }
    ],
    "backendPools": [
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/backendPools/backendPool1",
        "name": "backendPool1",
        "properties": {
          "backends": [
            {
              "address": "w3.contoso.com",
              "httpPort": 80,
              "httpsPort": 443,
              "enabledState": "Enabled",
              "weight": 1,
              "priority": 2
            },
            {
              "address": "contoso.com.website-us-west-2.othercloud.net",
              "httpPort": 80,
              "httpsPort": 443,
              "enabledState": "Enabled",
              "weight": 2,
              "priority": 1
            },
            {
              "address": "contoso1.azurewebsites.net",
              "httpPort": 80,
              "httpsPort": 443,
              "enabledState": "Enabled",
              "weight": 1,
              "priority": 1
            }
          ],
          "loadBalancingSettings": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/loadBalancingSettings/loadBalancingSettings1"
          },
          "healthProbeSettings": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/healthProbeSettings/healthProbeSettings1"
          }
        }
      }
    ],
    "frontendEndpoints": [
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/frontendEndpoint1",
        "name": "frontendEndpoint1",
        "properties": {
          "hostName": "www.contoso.com",
          "sessionAffinityEnabledState": "Enabled",
          "sessionAffinityTtlSeconds": 60,
          "webApplicationFirewallPolicyLink": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoorWebApplicationFirewallPolicies/policy1"
          }
        }
      },
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/default",
        "name": "default",
        "properties": {
          "hostName": "frontDoor1.azurefd.net"
        }
      }
    ],
    "backendPoolsSettings": {
      "enforceCertificateNameCheck": "Enabled",
      "sendRecvTimeoutSeconds": 60
    },
    "enabledState": "Enabled",
    "resourceState": "Creating",
    "provisioningState": "Provisioning",
    "cname": "frontDoor1.azurefd.net"
  }
}

Codice di stato:: 202

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1",
  "name": "frontDoor1",
  "type": "Microsoft.Network/frontDoor",
  "location": "westus",
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  },
  "properties": {
    "routingRules": [
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/routingRules/routingRule1",
        "name": "routingRule1",
        "properties": {
          "frontendEndpoints": [
            {
              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/frontendEndpoint1"
            },
            {
              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/default"
            }
          ],
          "acceptedProtocols": [
            "Http"
          ],
          "patternsToMatch": [
            "/*"
          ],
          "routeConfiguration": {
            "@odata.type": "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration",
            "customForwardingPath": "",
            "forwardingProtocol": "MatchRequest",
            "backendPool": {
              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/backendPools/backendPool1"
            }
          },
          "enabledState": "Enabled"
        }
      }
    ],
    "healthProbeSettings": [
      {
        "name": "healthProbeSettings1",
        "properties": {
          "path": "/",
          "protocol": "Http",
          "intervalInSeconds": 120,
          "enabledState": "Enabled",
          "healthProbeMethod": "HEAD"
        }
      }
    ],
    "loadBalancingSettings": [
      {
        "name": "loadBalancingSettings1",
        "properties": {
          "sampleSize": 4,
          "successfulSamplesRequired": 2
        }
      }
    ],
    "backendPools": [
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/backendPools/backendPool1",
        "name": "backendPool1",
        "properties": {
          "backends": [
            {
              "address": "w3.contoso.com",
              "httpPort": 80,
              "httpsPort": 443,
              "enabledState": "Enabled",
              "weight": 1,
              "priority": 2
            },
            {
              "address": "contoso.com.website-us-west-2.othercloud.net",
              "httpPort": 80,
              "httpsPort": 443,
              "enabledState": "Enabled",
              "weight": 2,
              "priority": 1
            },
            {
              "address": "contoso1.azurewebsites.net",
              "httpPort": 80,
              "httpsPort": 443,
              "enabledState": "Enabled",
              "weight": 1,
              "priority": 1
            }
          ],
          "loadBalancingSettings": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/loadBalancingSettings/loadBalancingSettings1"
          },
          "healthProbeSettings": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/healthProbeSettings/healthProbeSettings1"
          }
        }
      }
    ],
    "frontendEndpoints": [
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/frontendEndpoint1",
        "name": "frontendEndpoint1",
        "properties": {
          "hostName": "www.contoso.com",
          "sessionAffinityEnabledState": "Enabled",
          "sessionAffinityTtlSeconds": 60,
          "webApplicationFirewallPolicyLink": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoorWebApplicationFirewallPolicies/policy1"
          }
        }
      },
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/default",
        "name": "default",
        "properties": {
          "hostName": "frontDoor1.azurefd.net"
        }
      }
    ],
    "backendPoolsSettings": {
      "enforceCertificateNameCheck": "Enabled",
      "sendRecvTimeoutSeconds": 60
    },
    "enabledState": "Enabled",
    "resourceState": "Creating",
    "provisioningState": "Provisioning",
    "cname": "frontDoor1.azurefd.net"
  }
}

Definizioni

Nome	Descrizione
Backend	Indirizzo back-end di un servizio di bilanciamento del carico frontdoor.
backendEnabledState	Se si desidera abilitare l'utilizzo di questo back-end. I valori consentiti sono "Enabled" o "Disabled"
BackendPool	Un pool back-end è una raccolta di back-end a cui è possibile instradare.
BackendPoolsSettings	Impostazioni applicabili a tutti i pool back-end.
CacheConfiguration	Impostazioni di memorizzazione nella cache per una route di tipo di memorizzazione nella cache. Per disabilitare la memorizzazione nella cache, non specificare un oggetto cacheConfiguration.
CustomHttpsConfiguration	Impostazioni HTTPS per un dominio
CustomHttpsProvisioningState	Stato di provisioning di Https personalizzato del front-endEndpoint.
CustomHttpsProvisioningSubstate	Lo stato secondario di provisioning mostra lo stato di avanzamento dell'abilitazione/disabilitazione del processo HTTPS personalizzato in base al passaggio successivo.
DynamicCompressionEnabled	Se usare la compressione dinamica per il contenuto memorizzato nella cache
enforceCertificateNameCheckEnabledState	Se applicare il controllo del nome del certificato sulle richieste HTTPS a tutti i pool back-end. Nessun effetto sulle richieste non HTTPS.
ErrorResponse	Risposta errore indica che il servizio Frontdoor non è in grado di elaborare la richiesta in ingresso. Il motivo viene fornito nel messaggio di errore.
ForwardingConfiguration	Descrive la route di inoltro.
FrontDoor	Frontdoor rappresenta una raccolta di endpoint back-end per instradare il traffico a insieme a regole che specificano la modalità di invio del traffico.
FrontDoorCertificateSource	Definisce l'origine del certificato SSL
FrontDoorCertificateType	Definisce il tipo del certificato usato per le connessioni sicure a un front-endEndpoint
FrontDoorEnabledState	Stato operativo del bilanciamento del carico Frontdoor. I valori consentiti sono "Enabled" o "Disabled"
FrontDoorForwardingProtocol	Questo protocollo userà durante l'inoltro del traffico ai back-end.
FrontDoorHealthProbeMethod	Configura il metodo HTTP da usare per eseguire il probe dei back-end definiti in backendPools.
FrontDoorProtocol	Schemi di protocollo che corrispondono a questa regola
FrontDoorQuery	Trattamento dei termini di query URL quando si forma la chiave della cache.
FrontDoorRedirectProtocol	Protocollo della destinazione a cui viene reindirizzato il traffico
FrontDoorRedirectType	Il tipo di reindirizzamento verrà usato durante il reindirizzamento del traffico.
FrontDoorResourceState	Stato della risorsa della sottorisorsa frontdoor o frontdoor.
FrontDoorTlsProtocolType	Definisce il protocollo di estensione TLS usato per il recapito sicuro
FrontendEndpoint	Endpoint front-end usato per il routing.
HealthProbeEnabled	Indica se abilitare i probe di integrità per i back-end definiti in backendPools. I probe di integrità possono essere disabilitati solo se è presente un singolo back-end abilitato in un singolo pool back-end abilitato.
HealthProbeSettingsModel	Impostazioni di bilanciamento del carico per un pool back-end
LoadBalancingSettingsModel	Impostazioni di bilanciamento del carico per un pool back-end
MinimumTLSVersion	Versione minima TLS richiesta dai client per stabilire un handshake SSL con Frontdoor.
RedirectConfiguration	Descrive la route di reindirizzamento.
RoutingRule	Una regola di routing rappresenta una specifica per il traffico da trattare e dove inviarla, insieme alle informazioni sul probe di integrità.
routingRuleEnabledState	Indica se abilitare l'uso di questa regola. I valori consentiti sono 'Enabled' o 'Disabled'
SessionAffinityEnabledState	Indica se consentire l'affinità di sessione in questo host. Le opzioni valide sono "Abilitate" o "Disabilitate"
SubResource	Riferimento a un'altra sottorisorsa.
Vault	Insieme di credenziali delle chiavi contenente il certificato SSL
WebApplicationFirewallPolicyLink	Definisce i criteri di Web application firewall per ogni host (se applicabile)

Backend

Indirizzo back-end di un servizio di bilanciamento del carico frontdoor.

Nome	Tipo	Descrizione
address	string	Posizione del back-end (indirizzo IP o FQDN)
backendHostHeader	string	Valore da utilizzare come intestazione host inviato al back-end. Se vuoto o non specificato, questo valore predefinito viene impostato sull'host in ingresso.
enabledState	backendEnabledState	Se si desidera abilitare l'utilizzo di questo back-end. I valori consentiti sono "Enabled" o "Disabled"
httpPort	integer	Il numero di porta TCP di HTTP. Deve essere compreso tra 1 e 65535.
httpsPort	integer	Il numero di porta TCP HTTPS. Deve essere compreso tra 1 e 65535.
priority	integer	Priorità da utilizzare per il bilanciamento del carico. Le priorità più elevate non verranno usate per il bilanciamento del carico se un back-end con priorità inferiore è integro.
weight	integer	Peso di questo endpoint per scopi di bilanciamento del carico.

backendEnabledState

Se si desidera abilitare l'utilizzo di questo back-end. I valori consentiti sono "Enabled" o "Disabled"

Nome	Tipo	Descrizione
Disabled	string
Enabled	string

BackendPool

Un pool back-end è una raccolta di back-end a cui è possibile instradare.

Nome	Tipo	Descrizione
id	string	ID risorsa.
name	string	Nome risorsa.
properties.backends	Backend[]	Set di back-end per questo pool
properties.healthProbeSettings	SubResource	Impostazioni del probe di integrità L7 per un pool back-end
properties.loadBalancingSettings	SubResource	Impostazioni di bilanciamento del carico per un pool back-end
properties.resourceState	FrontDoorResourceState	Stato della risorsa della sottorisorsa frontdoor o frontdoor. Stato della risorsa.
type	string	Tipo di risorsa.

BackendPoolsSettings

Impostazioni applicabili a tutti i pool back-end.

Nome	Tipo	Valore predefinito	Descrizione
enforceCertificateNameCheck	enforceCertificateNameCheckEnabledState	Enabled	Indica se applicare il controllo del nome del certificato nelle richieste HTTPS a tutti i pool back-end. Nessun effetto sulle richieste non HTTPS.
sendRecvTimeoutSeconds	integer		Inviare e ricevere timeout durante l'inoltro della richiesta al back-end. Quando viene raggiunto il timeout, la richiesta ha esito negativo e restituisce.

CacheConfiguration

Impostazioni di memorizzazione nella cache per una route di tipo di memorizzazione nella cache. Per disabilitare la memorizzazione nella cache, non specificare un oggetto cacheConfiguration.

Nome	Tipo	Descrizione
dynamicCompression	DynamicCompressionEnabled	Se usare la compressione dinamica per il contenuto memorizzato nella cache
queryParameterStripDirective	FrontDoorQuery	Trattamento dei termini di query URL quando si forma la chiave della cache.

CustomHttpsConfiguration

Impostazioni HTTPS per un dominio

Nome	Tipo	Descrizione
certificateSource	FrontDoorCertificateSource	Definisce l'origine del certificato SSL
frontDoorCertificateSourceParameters.certificateType	FrontDoorCertificateType	Definisce il tipo del certificato usato per le connessioni sicure a un front-endEndpoint
keyVaultCertificateSourceParameters.secretName	string	Nome del segreto di Key Vault che rappresenta il certificato PFX completo
keyVaultCertificateSourceParameters.secretVersion	string	Versione del segreto di Key Vault che rappresenta il certificato PFX completo
keyVaultCertificateSourceParameters.vault	Vault	Insieme di credenziali delle chiavi contenente il certificato SSL
minimumTlsVersion	MinimumTLSVersion	Versione minima TLS richiesta dai client per stabilire un handshake SSL con Frontdoor.
protocolType	FrontDoorTlsProtocolType	Definisce il protocollo di estensione TLS usato per il recapito sicuro

CustomHttpsProvisioningState

Stato di provisioning di Https personalizzato del front-endEndpoint.

Nome	Tipo	Descrizione
Disabled	string
Disabling	string
Enabled	string
Enabling	string
Failed	string

CustomHttpsProvisioningSubstate

Lo stato secondario di provisioning mostra lo stato di avanzamento dell'abilitazione/disabilitazione del processo HTTPS personalizzato in base al passaggio successivo.

Nome	Tipo	Descrizione
CertificateDeleted	string
CertificateDeployed	string
DeletingCertificate	string
DeployingCertificate	string
DomainControlValidationRequestApproved	string
DomainControlValidationRequestRejected	string
DomainControlValidationRequestTimedOut	string
IssuingCertificate	string
PendingDomainControlValidationREquestApproval	string
SubmittingDomainControlValidationRequest	string

DynamicCompressionEnabled

Se usare la compressione dinamica per il contenuto memorizzato nella cache

Nome	Tipo	Descrizione
Disabled	string
Enabled	string

enforceCertificateNameCheckEnabledState

Se applicare il controllo del nome del certificato sulle richieste HTTPS a tutti i pool back-end. Nessun effetto sulle richieste non HTTPS.

Nome	Tipo	Descrizione
Disabled	string
Enabled	string

ErrorResponse

Risposta errore indica che il servizio Frontdoor non è in grado di elaborare la richiesta in ingresso. Il motivo viene fornito nel messaggio di errore.

Nome	Tipo	Descrizione
code	string	Codice di errore.
message	string	Messaggio di errore che indica il motivo per cui l'operazione non è riuscita.

ForwardingConfiguration

Descrive la route di inoltro.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration
backendPool	SubResource	Riferimento al back-endPool a cui questa regola viene instradata.
cacheConfiguration	CacheConfiguration	Configurazione della memorizzazione nella cache associata a questa regola.
customForwardingPath	string	Percorso personalizzato utilizzato per riscrivere i percorsi delle risorse corrispondenti a questa regola. Lasciare vuoto per usare il percorso di ingresso.
forwardingProtocol	FrontDoorForwardingProtocol	Questo protocollo userà durante l'inoltro del traffico ai back-end.

FrontDoor

Frontdoor rappresenta una raccolta di endpoint back-end per instradare il traffico a insieme a regole che specificano la modalità di invio del traffico.

Nome	Tipo	Descrizione
id	string	ID risorsa.
location	string	Percorso della risorsa.
name	string	Nome risorsa.
properties.backendPools	BackendPool[]	Pool back-end disponibili per le regole di routing.
properties.backendPoolsSettings	BackendPoolsSettings	Impostazioni per tutti i pool back-end
properties.cname	string	L'host a cui ogni front-endEndpoint deve essere CNAME.
properties.enabledState	FrontDoorEnabledState	Stato operativo del bilanciamento del carico Frontdoor. I valori consentiti sono 'Enabled' o 'Disabled'
properties.friendlyName	string	Nome descrittivo per frontDoor
properties.frontendEndpoints	FrontendEndpoint[]	Endpoint front-end disponibili per le regole di routing.
properties.healthProbeSettings	HealthProbeSettingsModel[]	Impostazioni del probe di integrità associate a questa istanza di frontdoor.
properties.loadBalancingSettings	LoadBalancingSettingsModel[]	Impostazioni del bilanciamento del carico associate a questa istanza di frontdoor.
properties.provisioningState	string	Stato di provisioning della frontdoor.
properties.resourceState	FrontDoorResourceState	Stato della risorsa della sottorisorsa frontdoor o frontdoor. Stato della risorsa della frontdoor.
properties.routingRules	RoutingRule[]	Regole di routing associate a questa frontdoor.
tags	object	Tag delle risorse.
type	string	Tipo di risorsa.

FrontDoorCertificateSource

Definisce l'origine del certificato SSL

Nome	Tipo	Descrizione
AzureKeyVault	string
FrontDoor	string

FrontDoorCertificateType

Definisce il tipo del certificato usato per le connessioni sicure a un front-endEndpoint

Nome	Tipo	Descrizione
Dedicated	string

FrontDoorEnabledState

Stato operativo del bilanciamento del carico Frontdoor. I valori consentiti sono "Enabled" o "Disabled"

Nome	Tipo	Descrizione
Disabled	string
Enabled	string

FrontDoorForwardingProtocol

Questo protocollo userà durante l'inoltro del traffico ai back-end.

Nome	Tipo	Descrizione
HttpOnly	string
HttpsOnly	string
MatchRequest	string

FrontDoorHealthProbeMethod

Configura il metodo HTTP da usare per eseguire il probe dei back-end definiti in backendPools.

Nome	Tipo	Descrizione
GET	string
HEAD	string

FrontDoorProtocol

Schemi di protocollo che corrispondono a questa regola

Nome	Tipo	Descrizione
Http	string
Https	string

FrontDoorQuery

Trattamento dei termini di query URL quando si forma la chiave della cache.

Nome	Tipo	Descrizione
StripAll	string
StripNone	string

FrontDoorRedirectProtocol

Protocollo della destinazione a cui viene reindirizzato il traffico

Nome	Tipo	Descrizione
HttpOnly	string
HttpsOnly	string
MatchRequest	string

FrontDoorRedirectType

Il tipo di reindirizzamento verrà usato durante il reindirizzamento del traffico.

Nome	Tipo	Descrizione
Found	string
Moved	string
PermanentRedirect	string
TemporaryRedirect	string

FrontDoorResourceState

Stato della risorsa della sottorisorsa frontdoor o frontdoor.

Nome	Tipo	Descrizione
Creating	string
Deleting	string
Disabled	string
Disabling	string
Enabled	string
Enabling	string

FrontDoorTlsProtocolType

Definisce il protocollo di estensione TLS usato per il recapito sicuro

Nome	Tipo	Descrizione
ServerNameIndication	string

FrontendEndpoint

Endpoint front-end usato per il routing.

Nome	Tipo	Descrizione
id	string	ID risorsa.
name	string	Nome risorsa.
properties.customHttpsConfiguration	CustomHttpsConfiguration	Configurazione che specifica come abilitare HTTPS
properties.customHttpsProvisioningState	CustomHttpsProvisioningState	Stato del provisioning di Https personalizzato del front-endEndpoint.
properties.customHttpsProvisioningSubstate	CustomHttpsProvisioningSubstate	Lo stato secondario di provisioning mostra lo stato di avanzamento dell'abilitazione/disabilitazione del processo HTTPS personalizzato passo dopo passo.
properties.hostName	string	Nome host del frontendEndpoint. Deve essere un nome di dominio.
properties.resourceState	FrontDoorResourceState	Stato della risorsa della sottorisorsa frontdoor o frontdoor. Stato della risorsa.
properties.sessionAffinityEnabledState	SessionAffinityEnabledState	Indica se consentire l'affinità di sessione in questo host. Le opzioni valide sono 'Enabled' o 'Disabled'
properties.sessionAffinityTtlSeconds	integer	INUTILIZZATI. Questo campo verrà ignorato. TTL in secondi da usare per l'affinità di sessione, se applicabile.
properties.webApplicationFirewallPolicyLink	WebApplicationFirewallPolicyLink	Definisce i criteri di Web application firewall per ogni host (se applicabile)
type	string	Tipo di risorsa.

HealthProbeEnabled

Indica se abilitare i probe di integrità per i back-end definiti in backendPools. I probe di integrità possono essere disabilitati solo se è presente un singolo back-end abilitato in un singolo pool back-end abilitato.

Nome	Tipo	Descrizione
Disabled	string
Enabled	string

HealthProbeSettingsModel

Impostazioni di bilanciamento del carico per un pool back-end

Nome	Tipo	Valore predefinito	Descrizione
id	string		ID risorsa.
name	string		Nome risorsa.
properties.enabledState	HealthProbeEnabled		Indica se abilitare i probe di integrità per i back-end definiti in backendPools. I probe di integrità possono essere disabilitati solo se è presente un singolo back-end abilitato in un singolo pool back-end abilitato.
properties.healthProbeMethod	FrontDoorHealthProbeMethod	HEAD	Configura il metodo HTTP da usare per eseguire il probe dei back-end definiti in backendPools.
properties.intervalInSeconds	integer		Il numero di secondi tra probe di integrità.
properties.path	string		Il percorso per usare il probe di integrità. Il valore predefinito è /
properties.protocol	FrontDoorProtocol		Schema del protocollo da usare per questo probe
properties.resourceState	FrontDoorResourceState		Stato della risorsa della sottorisorsa frontdoor o frontdoor. Stato della risorsa.
type	string		Tipo di risorsa.

LoadBalancingSettingsModel

Impostazioni di bilanciamento del carico per un pool back-end

Nome	Tipo	Descrizione
id	string	ID risorsa.
name	string	Nome risorsa.
properties.additionalLatencyMilliseconds	integer	Latenza aggiuntiva in millisecondi per i probe che rientrano nel bucket di latenza più basso
properties.resourceState	FrontDoorResourceState	Stato della risorsa della sottorisorsa frontdoor o frontdoor. Stato della risorsa.
properties.sampleSize	integer	Numero di campioni da considerare per le decisioni di bilanciamento del carico
properties.successfulSamplesRequired	integer	Numero di campioni entro il periodo di campionamento che deve avere esito positivo
type	string	Tipo di risorsa.

MinimumTLSVersion

Versione minima TLS richiesta dai client per stabilire un handshake SSL con Frontdoor.

Nome	Tipo	Descrizione
1.0	string
1.2	string

RedirectConfiguration

Descrive la route di reindirizzamento.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration
customFragment	string	Frammento da aggiungere all'URL di reindirizzamento. Il frammento è la parte dell'URL che viene dopo #. Non includere #.
customHost	string	Host da reindirizzare. Lasciare vuoto l'host in ingresso come host di destinazione.
customPath	string	Percorso completo da reindirizzare. Il percorso non può essere vuoto e deve iniziare con /. Lasciare vuoto per usare il percorso in ingresso come percorso di destinazione.
customQueryString	string	Set di stringhe di query da inserire nell'URL di reindirizzamento. L'impostazione di questo valore sostituirà qualsiasi stringa di query esistente; lasciare vuoto per mantenere la stringa di query in ingresso. La stringa di query deve essere in formato = . Il primo ? e & verranno aggiunti automaticamente in modo da non includerli in primo piano, ma separare più stringhe di query con &.
redirectProtocol	FrontDoorRedirectProtocol	Protocollo della destinazione a cui viene reindirizzato il traffico
redirectType	FrontDoorRedirectType	Il tipo di reindirizzamento verrà usato durante il reindirizzamento del traffico.

RoutingRule

Una regola di routing rappresenta una specifica per il traffico da trattare e dove inviarla, insieme alle informazioni sul probe di integrità.

Nome	Tipo	Descrizione
id	string	ID risorsa.
name	string	Nome risorsa.
properties.acceptedProtocols	FrontDoorProtocol[]	Schemi di protocollo che corrispondono a questa regola
properties.enabledState	routingRuleEnabledState	Indica se abilitare l'uso di questa regola. I valori consentiti sono 'Enabled' o 'Disabled'
properties.frontendEndpoints	SubResource[]	Endpoint front-end associati a questa regola
properties.patternsToMatch	string[]	Modelli di route della regola.
properties.resourceState	FrontDoorResourceState	Stato della risorsa della sottorisorsa frontdoor o frontdoor. Stato della risorsa.
properties.routeConfiguration	RouteConfiguration: ForwardingConfiguration RedirectConfiguration	Riferimento alla configurazione del routing.
type	string	Tipo di risorsa.

routingRuleEnabledState

Indica se abilitare l'uso di questa regola. I valori consentiti sono 'Enabled' o 'Disabled'

Nome	Tipo	Descrizione
Disabled	string
Enabled	string

SessionAffinityEnabledState

Indica se consentire l'affinità di sessione in questo host. Le opzioni valide sono "Abilitate" o "Disabilitate"

Nome	Tipo	Descrizione
Disabled	string
Enabled	string

SubResource

Riferimento a un'altra sottorisorsa.

Nome	Tipo	Descrizione
id	string	ID risorsa.

Vault

Insieme di credenziali delle chiavi contenente il certificato SSL

Nome	Tipo	Descrizione
id	string	ID risorsa.

WebApplicationFirewallPolicyLink

Definisce i criteri di Web application firewall per ogni host (se applicabile)

Nome	Tipo	Descrizione
id	string	ID risorsa.

Condividi tramite

Front Doors - Create Or Update

Parametri dell'URI

Corpo della richiesta

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

Create or update specific Front Door

Esempio di richiesta

Risposta di esempio

Definizioni

Backend

backendEnabledState

BackendPool

BackendPoolsSettings

CacheConfiguration

CustomHttpsConfiguration

CustomHttpsProvisioningState

CustomHttpsProvisioningSubstate

DynamicCompressionEnabled

enforceCertificateNameCheckEnabledState

ErrorResponse

ForwardingConfiguration

FrontDoor

FrontDoorCertificateSource

FrontDoorCertificateType

FrontDoorEnabledState

FrontDoorForwardingProtocol

FrontDoorHealthProbeMethod

FrontDoorProtocol

FrontDoorQuery

FrontDoorRedirectProtocol

FrontDoorRedirectType

FrontDoorResourceState

FrontDoorTlsProtocolType

FrontendEndpoint

HealthProbeEnabled

HealthProbeSettingsModel

LoadBalancingSettingsModel

MinimumTLSVersion

RedirectConfiguration

RoutingRule

routingRuleEnabledState

SessionAffinityEnabledState

SubResource

Vault

WebApplicationFirewallPolicyLink

Risorse aggiuntive