Front Doors - Create Or Update

Referentie

Service:: Front Door Service

API-versie:: 2019-05-01

Hiermee maakt u een nieuwe Front Door met een Front Door-naam onder het opgegeven abonnement en de opgegeven resourcegroep.

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

URI-parameters

Name	In	Vereist	Type	Description
frontDoorName	path	True	string	Naam van de Front Door die wereldwijd uniek is. Regex-patroon: `^[a-zA-Z0-9]+([-a-zA-Z0-9]?[a-zA-Z0-9])*$`
resourceGroupName	path	True	string	Naam van de resourcegroep binnen het Azure-abonnement. Regex-patroon: `^[a-zA-Z0-9_\-\.]*[^\.]$`
subscriptionId	path	True	string	De abonnementsreferenties waarmee het Microsoft Azure-abonnement uniek wordt geïdentificeerd. De abonnements-id maakt deel uit van de URI voor elke service-aanroep.
api-version	query	True	string	Client-API-versie.

Aanvraagbody

Name	Type	Description
location	string	Resourcelocatie.
properties.backendPools	BackendPool[]	Back-endpools die beschikbaar zijn voor routeringsregels.
properties.backendPoolsSettings	BackendPoolsSettings	Instellingen voor alle back-endpools
properties.enabledState	FrontDoorEnabledState	Operationele status van de Front Door-load balancer. Toegestane waarden zijn Ingeschakeld of Uitgeschakeld
properties.friendlyName	string	Een beschrijvende naam voor de frontDoor
properties.frontendEndpoints	FrontendEndpoint[]	Front-end-eindpunten die beschikbaar zijn voor routeringsregels.
properties.healthProbeSettings	HealthProbeSettingsModel[]	Statustestinstellingen die zijn gekoppeld aan dit Front Door-exemplaar.
properties.loadBalancingSettings	LoadBalancingSettingsModel[]	Instellingen voor taakverdeling die zijn gekoppeld aan dit Front Door-exemplaar.
properties.routingRules	RoutingRule[]	Routeringsregels die zijn gekoppeld aan deze Front Door.
tags	object	Resourcetags.

Antwoorden

Name	Type	Description
200 OK	FrontDoor	OK. De aanvraag is voltooid.
201 Created	FrontDoor	Gemaakt. Aan de aanvraag is voldaan en er is een nieuwe Front Door gemaakt.
202 Accepted	FrontDoor	Aanvaard. De aanvraag is geaccepteerd voor verwerking en de bewerking wordt asynchroon voltooid.
Other Status Codes	ErrorResponse	Antwoord van Front Door-fout waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	uw gebruikersaccount imiteren

Voorbeelden

Create or update specific Front Door

Voorbeeldaanvraag

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"
  }
}

Voorbeeldrespons

Statuscode:: 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"
  }
}

Statuscode:: 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"
  }
}

Statuscode:: 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"
  }
}

Definities

Name	Description
Backend	Back-endadres van een frontDoor-load balancer.
backendEnabledState	Of het gebruik van deze back-end moet worden ingeschakeld. Toegestane waarden zijn Ingeschakeld of Uitgeschakeld
BackendPool	Een back-endpool is een verzameling back-ends waarnaar kan worden gerouteerd.
BackendPoolsSettings	Instellingen die van toepassing zijn op alle back-endpools.
CacheConfiguration	Cache-instellingen voor een route van het type caching. Als u caching wilt uitschakelen, moet u geen cacheConfiguration-object opgeven.
CustomHttpsConfiguration	HTTPS-instellingen voor een domein
CustomHttpsProvisioningState	Inrichtingsstatus van aangepaste HTTPS van het frontendEndpoint.
CustomHttpsProvisioningSubstate	Substatus inrichten toont stap voor stap de voortgang van het proces voor het inschakelen/uitschakelen van aangepaste HTTPS.
DynamicCompressionEnabled	Of dynamische compressie moet worden gebruikt voor inhoud in de cache
enforceCertificateNameCheckEnabledState	Of certificaatnaamcontrole moet worden afgedwongen op HTTPS-aanvragen voor alle back-endpools. Geen effect op niet-HTTPS-aanvragen.
ErrorResponse	Foutreactie geeft aan dat de Front Door-service de binnenkomende aanvraag niet kan verwerken. De reden wordt opgegeven in het foutbericht.
ForwardingConfiguration	Beschrijft de doorstuurroute.
FrontDoor	Front Door vertegenwoordigt een verzameling back-endeindpunten waarnaar u verkeer kunt routeren, samen met regels die aangeven hoe verkeer daarheen wordt verzonden.
FrontDoorCertificateSource	Definieert de bron van het SSL-certificaat
FrontDoorCertificateType	Definieert het type certificaat dat wordt gebruikt voor beveiligde verbindingen met een frontendEndpoint
FrontDoorEnabledState	Operationele status van de Front Door-load balancer. Toegestane waarden zijn Ingeschakeld of Uitgeschakeld
FrontDoorForwardingProtocol	Protocol dat deze regel gebruikt bij het doorsturen van verkeer naar back-ends.
FrontDoorHealthProbeMethod	Hiermee configureert u welke HTTP-methode moet worden gebruikt om de back-ends te testen die zijn gedefinieerd onder backendPools.
FrontDoorProtocol	Protocolschema's die overeenkomen met deze regel
FrontDoorQuery	Behandeling van URL-querytermen bij het vormen van de cachesleutel.
FrontDoorRedirectProtocol	Het protocol van de bestemming waarnaar het verkeer wordt omgeleid
FrontDoorRedirectType	Het omleidingstype dat de regel gebruikt bij het omleiden van verkeer.
FrontDoorResourceState	Resourcestatus van de Front Door- of Front Door-subresource.
FrontDoorTlsProtocolType	Definieert het TLS-extensieprotocol dat wordt gebruikt voor beveiligde levering
FrontendEndpoint	Een front-endeindpunt dat wordt gebruikt voor routering.
HealthProbeEnabled	Of statustests moeten worden uitgevoerd op back-ends die zijn gedefinieerd onder backendPools. Statustests kunnen alleen worden uitgeschakeld als er één ingeschakelde back-end is in een back-endpool met één ingeschakelde back-end.
HealthProbeSettingsModel	Instellingen voor taakverdeling voor een back-endpool
LoadBalancingSettingsModel	Instellingen voor taakverdeling voor een back-endpool
MinimumTLSVersion	De minimale TLS-versie die van de clients is vereist om een SSL-handshake met Front Door tot stand te brengen.
RedirectConfiguration	Beschrijft omleidingsroute.
RoutingRule	Een regel voor doorsturen vertegenwoordigt een specificatie voor verkeer dat moet worden behandeld en waar het moet worden verzonden, samen met statustestinformatie.
routingRuleEnabledState	Of het gebruik van deze regel moet worden ingeschakeld. Toegestane waarden zijn Ingeschakeld of Uitgeschakeld
SessionAffinityEnabledState	Of sessieaffiniteit op deze host moet worden toegestaan. Geldige opties zijn Ingeschakeld of Uitgeschakeld
SubResource	Verwijzing naar een andere subresource.
Vault	De Key Vault met het SSL-certificaat
WebApplicationFirewallPolicyLink	Definieert het Web Application Firewall beleid voor elke host (indien van toepassing)

Backend

Back-endadres van een frontDoor-load balancer.

Name	Type	Description
address	string	Locatie van de back-end (IP-adres of FQDN)
backendHostHeader	string	De waarde die moet worden gebruikt als de hostheader die naar de back-end wordt verzonden. Als dit leeg of niet is opgegeven, wordt deze standaard ingesteld op de binnenkomende host.
enabledState	backendEnabledState	Of het gebruik van deze back-end moet worden ingeschakeld. Toegestane waarden zijn Ingeschakeld of Uitgeschakeld
httpPort	integer	Het HTTP TCP-poortnummer. Moet tussen 1 en 65535 zijn.
httpsPort	integer	Het HTTPS TCP-poortnummer. Moet tussen 1 en 65535 zijn.
priority	integer	Prioriteit voor taakverdeling. Hogere prioriteiten worden niet gebruikt voor taakverdeling als een back-end met een lagere prioriteit in orde is.
weight	integer	Gewicht van dit eindpunt voor taakverdelingsdoeleinden.

backendEnabledState

Of het gebruik van deze back-end moet worden ingeschakeld. Toegestane waarden zijn Ingeschakeld of Uitgeschakeld

Name	Type	Description
Disabled	string
Enabled	string

BackendPool

Een back-endpool is een verzameling back-ends waarnaar kan worden gerouteerd.

Name	Type	Description
id	string	Resource-id.
name	string	Resourcenaam.
properties.backends	Backend[]	De set back-ends voor deze pool
properties.healthProbeSettings	SubResource	L7-statustestinstellingen voor een back-endpool
properties.loadBalancingSettings	SubResource	Instellingen voor taakverdeling voor een back-endpool
properties.resourceState	FrontDoorResourceState	Resourcestatus van de Front Door- of Front Door-subresource. Resourcestatus.
type	string	Resourcetype.

BackendPoolsSettings

Instellingen die van toepassing zijn op alle back-endpools.

Name	Type	Default value	Description
enforceCertificateNameCheck	enforceCertificateNameCheckEnabledState	Enabled	Of certificaatnaamcontrole moet worden afgedwongen op HTTPS-aanvragen voor alle back-endpools. Geen effect op niet-HTTPS-aanvragen.
sendRecvTimeoutSeconds	integer		Time-out verzenden en ontvangen bij het doorsturen van aanvraag naar de back-end. Wanneer de time-out is bereikt, mislukt de aanvraag en wordt deze geretourneerd.

CacheConfiguration

Cache-instellingen voor een route van het type caching. Als u caching wilt uitschakelen, moet u geen cacheConfiguration-object opgeven.

Name	Type	Description
dynamicCompression	DynamicCompressionEnabled	Of dynamische compressie moet worden gebruikt voor inhoud in de cache
queryParameterStripDirective	FrontDoorQuery	Behandeling van URL-querytermen bij het vormen van de cachesleutel.

CustomHttpsConfiguration

HTTPS-instellingen voor een domein

Name	Type	Description
certificateSource	FrontDoorCertificateSource	Definieert de bron van het SSL-certificaat
frontDoorCertificateSourceParameters.certificateType	FrontDoorCertificateType	Definieert het type certificaat dat wordt gebruikt voor beveiligde verbindingen met een frontendEndpoint
keyVaultCertificateSourceParameters.secretName	string	De naam van het Key Vault geheim dat het volledige pfx-certificaat vertegenwoordigt
keyVaultCertificateSourceParameters.secretVersion	string	De versie van het Key Vault geheim dat het volledige pfx-certificaat vertegenwoordigt
keyVaultCertificateSourceParameters.vault	Vault	De Key Vault met het SSL-certificaat
minimumTlsVersion	MinimumTLSVersion	De minimale TLS-versie die van de clients is vereist om een SSL-handshake met Front Door tot stand te brengen.
protocolType	FrontDoorTlsProtocolType	Definieert het TLS-extensieprotocol dat wordt gebruikt voor beveiligde levering

CustomHttpsProvisioningState

Inrichtingsstatus van aangepaste HTTPS van het frontendEndpoint.

Name	Type	Description
Disabled	string
Disabling	string
Enabled	string
Enabling	string
Failed	string

CustomHttpsProvisioningSubstate

Substatus inrichten toont stap voor stap de voortgang van het proces voor het inschakelen/uitschakelen van aangepaste HTTPS.

Name	Type	Description
CertificateDeleted	string
CertificateDeployed	string
DeletingCertificate	string
DeployingCertificate	string
DomainControlValidationRequestApproved	string
DomainControlValidationRequestRejected	string
DomainControlValidationRequestTimedOut	string
IssuingCertificate	string
PendingDomainControlValidationREquestApproval	string
SubmittingDomainControlValidationRequest	string

DynamicCompressionEnabled

Of dynamische compressie moet worden gebruikt voor inhoud in de cache

Name	Type	Description
Disabled	string
Enabled	string

enforceCertificateNameCheckEnabledState

Of certificaatnaamcontrole moet worden afgedwongen op HTTPS-aanvragen voor alle back-endpools. Geen effect op niet-HTTPS-aanvragen.

Name	Type	Description
Disabled	string
Enabled	string

ErrorResponse

Foutreactie geeft aan dat de Front Door-service de binnenkomende aanvraag niet kan verwerken. De reden wordt opgegeven in het foutbericht.

Name	Type	Description
code	string	Foutcode.
message	string	Foutbericht waarin wordt aangegeven waarom de bewerking is mislukt.

ForwardingConfiguration

Beschrijft de doorstuurroute.

Name	Type	Description
@odata.type	string: #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration
backendPool	SubResource	Een verwijzing naar de BackendPool waarnaar deze regel wordt gerouteerd.
cacheConfiguration	CacheConfiguration	De cacheconfiguratie die aan deze regel is gekoppeld.
customForwardingPath	string	Een aangepast pad dat wordt gebruikt voor het herschrijven van resourcepaden die overeenkomen met deze regel. Laat leeg om het binnenkomende pad te gebruiken.
forwardingProtocol	FrontDoorForwardingProtocol	Protocol dat deze regel gebruikt bij het doorsturen van verkeer naar back-ends.

FrontDoor

Front Door vertegenwoordigt een verzameling back-endeindpunten waarnaar u verkeer kunt routeren, samen met regels die aangeven hoe verkeer daarheen wordt verzonden.

Name	Type	Description
id	string	Resource-id.
location	string	Resourcelocatie.
name	string	Resourcenaam.
properties.backendPools	BackendPool[]	Back-endpools die beschikbaar zijn voor routeringsregels.
properties.backendPoolsSettings	BackendPoolsSettings	Instellingen voor alle back-endpools
properties.cname	string	De host waarnaar elke front-endEndpoint CNAME moet hebben.
properties.enabledState	FrontDoorEnabledState	Operationele status van de Front Door-load balancer. Toegestane waarden zijn Ingeschakeld of Uitgeschakeld
properties.friendlyName	string	Een beschrijvende naam voor de frontDoor
properties.frontendEndpoints	FrontendEndpoint[]	Front-end-eindpunten die beschikbaar zijn voor routeringsregels.
properties.healthProbeSettings	HealthProbeSettingsModel[]	Statustestinstellingen die zijn gekoppeld aan dit Front Door-exemplaar.
properties.loadBalancingSettings	LoadBalancingSettingsModel[]	Instellingen voor taakverdeling die zijn gekoppeld aan dit Front Door-exemplaar.
properties.provisioningState	string	Inrichtingsstatus van de Front Door.
properties.resourceState	FrontDoorResourceState	Resourcestatus van de Front Door- of Front Door-subresource. Resourcestatus van de Front Door.
properties.routingRules	RoutingRule[]	Routeringsregels die zijn gekoppeld aan deze Front Door.
tags	object	Resourcetags.
type	string	Resourcetype.

FrontDoorCertificateSource

Definieert de bron van het SSL-certificaat

Name	Type	Description
AzureKeyVault	string
FrontDoor	string

FrontDoorCertificateType

Definieert het type certificaat dat wordt gebruikt voor beveiligde verbindingen met een frontendEndpoint

Name	Type	Description
Dedicated	string

FrontDoorEnabledState

Operationele status van de Front Door-load balancer. Toegestane waarden zijn Ingeschakeld of Uitgeschakeld

Name	Type	Description
Disabled	string
Enabled	string

FrontDoorForwardingProtocol

Protocol dat deze regel gebruikt bij het doorsturen van verkeer naar back-ends.

Name	Type	Description
HttpOnly	string
HttpsOnly	string
MatchRequest	string

FrontDoorHealthProbeMethod

Hiermee configureert u welke HTTP-methode moet worden gebruikt om de back-ends te testen die zijn gedefinieerd onder backendPools.

Name	Type	Description
GET	string
HEAD	string

FrontDoorProtocol

Protocolschema's die overeenkomen met deze regel

Name	Type	Description
Http	string
Https	string

FrontDoorQuery

Behandeling van URL-querytermen bij het vormen van de cachesleutel.

Name	Type	Description
StripAll	string
StripNone	string

FrontDoorRedirectProtocol

Het protocol van de bestemming waarnaar het verkeer wordt omgeleid

Name	Type	Description
HttpOnly	string
HttpsOnly	string
MatchRequest	string

FrontDoorRedirectType

Het omleidingstype dat de regel gebruikt bij het omleiden van verkeer.

Name	Type	Description
Found	string
Moved	string
PermanentRedirect	string
TemporaryRedirect	string

FrontDoorResourceState

Resourcestatus van de Front Door- of Front Door-subresource.

Name	Type	Description
Creating	string
Deleting	string
Disabled	string
Disabling	string
Enabled	string
Enabling	string

FrontDoorTlsProtocolType

Definieert het TLS-extensieprotocol dat wordt gebruikt voor beveiligde levering

Name	Type	Description
ServerNameIndication	string

FrontendEndpoint

Een front-endeindpunt dat wordt gebruikt voor routering.

Name	Type	Description
id	string	Resource-id.
name	string	Resourcenaam.
properties.customHttpsConfiguration	CustomHttpsConfiguration	De configuratie die aangeeft hoe HTTPS moet worden ingeschakeld
properties.customHttpsProvisioningState	CustomHttpsProvisioningState	Inrichtingsstatus van aangepaste HTTPS van het frontendEndpoint.
properties.customHttpsProvisioningSubstate	CustomHttpsProvisioningSubstate	Substatus inrichten toont stap voor stap de voortgang van het proces voor het inschakelen/uitschakelen van aangepaste HTTPS.
properties.hostName	string	De hostnaam van het frontendEndpoint. Moet een domeinnaam zijn.
properties.resourceState	FrontDoorResourceState	Resourcestatus van de Front Door- of Front Door-subresource. Resourcestatus.
properties.sessionAffinityEnabledState	SessionAffinityEnabledState	Of sessieaffiniteit op deze host moet worden toegestaan. Geldige opties zijn Ingeschakeld of Uitgeschakeld
properties.sessionAffinityTtlSeconds	integer	ONGEBRUIKTE. Dit veld wordt genegeerd. De TTL die in seconden moet worden gebruikt voor sessieaffiniteit, indien van toepassing.
properties.webApplicationFirewallPolicyLink	WebApplicationFirewallPolicyLink	Definieert het Web Application Firewall beleid voor elke host (indien van toepassing)
type	string	Resourcetype.

HealthProbeEnabled

Of statustests moeten worden uitgevoerd op back-ends die zijn gedefinieerd onder backendPools. Statustests kunnen alleen worden uitgeschakeld als er één ingeschakelde back-end is in een back-endpool met één ingeschakelde back-end.

Name	Type	Description
Disabled	string
Enabled	string

HealthProbeSettingsModel

Instellingen voor taakverdeling voor een back-endpool

Name	Type	Default value	Description
id	string		Resource-id.
name	string		Resourcenaam.
properties.enabledState	HealthProbeEnabled		Of statustests moeten worden uitgevoerd op back-ends die zijn gedefinieerd onder backendPools. Statustests kunnen alleen worden uitgeschakeld als er één ingeschakelde back-end is in een back-endpool met één ingeschakelde back-end.
properties.healthProbeMethod	FrontDoorHealthProbeMethod	HEAD	Hiermee configureert u welke HTTP-methode moet worden gebruikt om de back-ends te testen die zijn gedefinieerd onder backendPools.
properties.intervalInSeconds	integer		Het aantal seconden tussen statustests.
properties.path	string		Het pad dat moet worden gebruikt voor de statustest. De standaardwaarde is /
properties.protocol	FrontDoorProtocol		Protocolschema voor deze test
properties.resourceState	FrontDoorResourceState		Resourcestatus van de Front Door- of Front Door-subresource. Resourcestatus.
type	string		Resourcetype.

LoadBalancingSettingsModel

Instellingen voor taakverdeling voor een back-endpool

Name	Type	Description
id	string	Resource-id.
name	string	Resourcenaam.
properties.additionalLatencyMilliseconds	integer	De extra latentie in milliseconden voor tests die in de bucket met de laagste latentie vallen
properties.resourceState	FrontDoorResourceState	Resourcestatus van de Front Door- of Front Door-subresource. Resourcestatus.
properties.sampleSize	integer	Het aantal voorbeelden dat moet worden overwogen voor beslissingen over taakverdeling
properties.successfulSamplesRequired	integer	Het aantal steekproeven binnen de steekproefperiode dat moet slagen
type	string	Resourcetype.

MinimumTLSVersion

De minimale TLS-versie die van de clients is vereist om een SSL-handshake met Front Door tot stand te brengen.

Name	Type	Description
1.0	string
1.2	string

RedirectConfiguration

Beschrijft omleidingsroute.

Name	Type	Description
@odata.type	string: #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration
customFragment	string	Fragment dat moet worden toegevoegd aan de omleidings-URL. Fragment is het deel van de URL dat na #komt. Neem de #.
customHost	string	Host om om te leiden. Laat leeg om de binnenkomende host als doelhost te gebruiken.
customPath	string	Het volledige pad naar omleiding. Het pad mag niet leeg zijn en moet beginnen met /. Laat leeg om het binnenkomende pad als doelpad te gebruiken.
customQueryString	string	De set queryreeksen die in de omleidings-URL moet worden geplaatst. Als u deze waarde instelt, wordt elke bestaande queryreeks vervangen; laat dit leeg om de binnenkomende querytekenreeks te behouden. De querytekenreeks moet de indeling = hebben. De eerste ? en & automatisch worden toegevoegd, dus neem ze niet aan de voorzijde op, maar scheid meerdere queryreeksen met &.
redirectProtocol	FrontDoorRedirectProtocol	Het protocol van de bestemming waarnaar het verkeer wordt omgeleid
redirectType	FrontDoorRedirectType	Het omleidingstype dat de regel gebruikt bij het omleiden van verkeer.

RoutingRule

Een regel voor doorsturen vertegenwoordigt een specificatie voor verkeer dat moet worden behandeld en waar het moet worden verzonden, samen met statustestinformatie.

Name	Type	Description
id	string	Resource-id.
name	string	Resourcenaam.
properties.acceptedProtocols	FrontDoorProtocol[]	Protocolschema's die overeenkomen met deze regel
properties.enabledState	routingRuleEnabledState	Of het gebruik van deze regel moet worden ingeschakeld. Toegestane waarden zijn Ingeschakeld of Uitgeschakeld
properties.frontendEndpoints	SubResource[]	Front-end-eindpunten die aan deze regel zijn gekoppeld
properties.patternsToMatch	string[]	De routepatronen van de regel.
properties.resourceState	FrontDoorResourceState	Resourcestatus van de Front Door- of Front Door-subresource. Resourcestatus.
properties.routeConfiguration	RouteConfiguration: ForwardingConfiguration RedirectConfiguration	Een verwijzing naar de routeringsconfiguratie.
type	string	Resourcetype.

routingRuleEnabledState

Of het gebruik van deze regel moet worden ingeschakeld. Toegestane waarden zijn Ingeschakeld of Uitgeschakeld

Name	Type	Description
Disabled	string
Enabled	string

SessionAffinityEnabledState

Of sessieaffiniteit op deze host moet worden toegestaan. Geldige opties zijn Ingeschakeld of Uitgeschakeld

Name	Type	Description
Disabled	string
Enabled	string

SubResource

Verwijzing naar een andere subresource.

Name	Type	Description
id	string	Resource-id.

Vault

De Key Vault met het SSL-certificaat

Name	Type	Description
id	string	Resource-id.

WebApplicationFirewallPolicyLink

Definieert het Web Application Firewall beleid voor elke host (indien van toepassing)

Name	Type	Description
id	string	Resource-id.

Delen via

Front Doors - Create Or Update

URI-parameters

Aanvraagbody

Antwoorden

Beveiliging

azure_auth

Bereiken

Voorbeelden

Create or update specific Front Door

Voorbeeldaanvraag

Voorbeeldrespons

Definities

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

Aanvullende resources