Front Doors - Create Or Update

Referenz

Service:: Front Door Service

API Version:: 2019-05-01

Erstellt eine neue Front Door-Instanz mit einem Front Door-Namen unter dem angegebenen Abonnement und der angegebenen Ressourcengruppe.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
frontDoorName	path	True	string	Der Name der Front Door-Instanz, die global eindeutig ist. Regex pattern: `^[a-zA-Z0-9]+([-a-zA-Z0-9]?[a-zA-Z0-9])*$`
resourceGroupName	path	True	string	Name der Ressourcengruppe innerhalb des Azure-Abonnements. Regex pattern: `^[a-zA-Z0-9_\-\.]*[^\.]$`
subscriptionId	path	True	string	Die Abonnementanmeldeinformationen, die das Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf.
api-version	query	True	string	Client-API-Version.

Anforderungstext

Name	Typ	Beschreibung
location	string	Ressourcenspeicherort
properties.backendPools	BackendPool[]	Back-End-Pools, die für Routingregeln verfügbar sind.
properties.backendPoolsSettings	BackendPoolsSettings	Einstellungen für alle Back-EndPools
properties.enabledState	FrontDoorEnabledState	Betriebsstatus des Front Door-Lastenausgleichs Zulässige Werte sind "Enabled" oder "Disabled".
properties.friendlyName	string	Ein Anzeigename für die FrontDoor
properties.frontendEndpoints	FrontendEndpoint[]	Front-End-Endpunkte, die für Routingregeln verfügbar sind.
properties.healthProbeSettings	HealthProbeSettingsModel[]	Dieser Front Door-Instanz zugeordnete Integritätstesteinstellungen
properties.loadBalancingSettings	LoadBalancingSettingsModel[]	Dieser Front Door-Instanz zugeordnete Lastenausgleichseinstellungen
properties.routingRules	RoutingRule[]	Routingregeln, die dieser Front Door-Instanz zugeordnet sind.
tags	object	Ressourcentags.

Antworten

Name	Typ	Beschreibung
200 OK	FrontDoor	OK. Die Anforderung war erfolgreich.
201 Created	FrontDoor	Erstellt. Die Anforderung wurde erfüllt, und es wurde eine neue Front Door-Instanz erstellt.
202 Accepted	FrontDoor	Akzeptiert: Die Anforderung wurde für die Verarbeitung akzeptiert, und der Vorgang wird asynchron abgeschlossen.
Other Status Codes	ErrorResponse	Front Door-Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

Beispiele

Create or update specific Front Door

Sample Request

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

Sample Response

Status code:: 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"
  }
}

Status code:: 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"
  }
}

Status code:: 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"
  }
}

Definitionen

Name	Beschreibung
Backend	Back-End-Adresse eines FrontDoor-Lastenausgleichs.
backendEnabledState	Gibt an, ob die Verwendung dieses Back-Ends aktiviert werden soll. Zulässige Werte sind "Enabled" oder "Disabled".
BackendPool	Ein Back-End-Pool ist eine Sammlung von Back-Ends, an die weitergeleitet werden kann.
BackendPoolsSettings	Einstellungen, die für alle Back-End-Pools gelten.
CacheConfiguration	Zwischenspeicherungseinstellungen für eine Zwischenspeicherungsroute. Um die Zwischenspeicherung zu deaktivieren, geben Sie kein cacheConfiguration-Objekt an.
CustomHttpsConfiguration	HTTPS-Einstellungen für eine Domäne
CustomHttpsProvisioningState	Bereitstellung status von benutzerdefiniertem HTTPS des frontendEndpoints.
CustomHttpsProvisioningSubstate	Der Bereitstellungsunterzustand zeigt den Fortschritt des benutzerdefinierten HTTPS-Aktivierungs-/Deaktivierungsprozesses Schritt für Schritt an.
DynamicCompressionEnabled	Gibt an, ob die dynamische Komprimierung für zwischengespeicherte Inhalte verwendet werden soll
enforceCertificateNameCheckEnabledState	Gibt an, ob die Überprüfung des Zertifikatnamens für HTTPS-Anforderungen an alle Back-End-Pools erzwungen werden soll. Keine Auswirkung auf Nicht-HTTPS-Anforderungen.
ErrorResponse	Die Fehlerantwort gibt an, dass der Front Door-Dienst die eingehende Anforderung nicht verarbeiten kann. Der Grund wird in der Fehlermeldung angegeben.
ForwardingConfiguration	Beschreibt die Weiterleitungsroute.
FrontDoor	Front Door stellt eine Sammlung von Back-End-Endpunkten dar, an die Datenverkehr weitergeleitet werden soll, zusammen mit Regeln, die angeben, wie Datenverkehr dorthin gesendet wird.
FrontDoorCertificateSource	Definiert die Quelle des SSL-Zertifikats.
FrontDoorCertificateType	Definiert den Typ des Zertifikats, das für sichere Verbindungen mit einem frontendEndpoint verwendet wird.
FrontDoorEnabledState	Betriebsstatus des Front Door-Lastenausgleichs Zulässige Werte sind "Enabled" oder "Disabled".
FrontDoorForwardingProtocol	Das Protokoll, das diese Regel beim Weiterleiten von Datenverkehr an Back-Ends verwendet.
FrontDoorHealthProbeMethod	Konfiguriert, welche HTTP-Methode zum Testen der unter backPools definierten Back-Ends verwendet werden soll.
FrontDoorProtocol	Protokollschemas, die für diese Regel übereinstimmen
FrontDoorQuery	Behandlung von URL-Abfragebegriffen beim Erstellen des Cacheschlüssels.
FrontDoorRedirectProtocol	Das Protokoll des Ziels, an das der Datenverkehr umgeleitet wird
FrontDoorRedirectType	Der Umleitungstyp, den die Regel beim Umleiten von Datenverkehr verwendet.
FrontDoorResourceState	Ressourcen status der Unterressource Front Door oder Front Door.
FrontDoorTlsProtocolType	Definiert das TLS-Erweiterungsprotokoll, das für die sichere Übermittlung verwendet wird.
FrontendEndpoint	Ein Front-End-Endpunkt, der für das Routing verwendet wird.
HealthProbeEnabled	Gibt an, ob Integritätstests für Back-End-Instanzen aktiviert werden sollen, die unter backPools definiert sind. Integritätstests können nur deaktiviert werden, wenn ein einzelnes aktiviertes Back-End in einem einzelnen aktivierten Back-End-Pool vorhanden ist.
HealthProbeSettingsModel	Lastenausgleichseinstellungen für einen Back-End-Pool
LoadBalancingSettingsModel	Lastenausgleichseinstellungen für einen Back-End-Pool
MinimumTLSVersion	Die TLS-Mindestversion, die von den Clients benötigt wird, um einen SSL-Handshake mit Front Door einzurichten.
RedirectConfiguration	Beschreibt die Umleitungsroute.
RoutingRule	Eine Routingregel stellt eine Spezifikation für den zu behandelnden Datenverkehr und den Sendeort zusammen mit Integritätstestinformationen dar.
routingRuleEnabledState	Gibt an, ob die Verwendung dieser Regel aktiviert werden soll. Zulässige Werte sind "Aktiviert" oder "Deaktiviert".
SessionAffinityEnabledState	Angabe, ob Sitzungsaffinität auf diesem Host zugelassen wird. Gültige Optionen sind "Aktiviert" oder "Deaktiviert".
SubResource	Verweis auf eine andere Unterquelle.
Vault	Der Schlüsseltresor mit dem SSL-Zertifikat
WebApplicationFirewallPolicyLink	Definiert die Web Application Firewall richtlinie für jeden Host (falls zutreffend)

Backend

Back-End-Adresse eines FrontDoor-Lastenausgleichs.

Name	Typ	Beschreibung
address	string	Position des Back-Ends (IP-Adresse oder FQDN)
backendHostHeader	string	Der Wert, der als Hostheader zum Senden an das Back-End verwendet werden soll. Wenn leer oder nicht angegeben, wird standardmäßig der eingehende Host verwendet.
enabledState	backendEnabledState	Gibt an, ob die Verwendung dieses Back-Ends aktiviert werden soll. Zulässige Werte sind "Enabled" oder "Disabled".
httpPort	integer	Die HTTP-TCP-Portnummer. Der Wert muss zwischen 1 und 65535 liegen.
httpsPort	integer	Die HTTPS-TCP-Portnummer. Der Wert muss zwischen 1 und 65535 liegen.
priority	integer	Die für den Lastenausgleich zu verwendende Priorität. Höhere Prioritäten werden nicht für den Lastenausgleich verwendet, wenn ein Back-End mit niedrigerer Priorität fehlerfrei ist.
weight	integer	Die Gewichtung dieses Endpunkts für den Lastenausgleich.

backendEnabledState

Gibt an, ob die Verwendung dieses Back-Ends aktiviert werden soll. Zulässige Werte sind "Enabled" oder "Disabled".

Name	Typ	Beschreibung
Disabled	string
Enabled	string

BackendPool

Ein Back-End-Pool ist eine Sammlung von Back-Ends, an die weitergeleitet werden kann.

Name	Typ	Beschreibung
id	string	Ressourcen-ID
name	string	Name der Ressource.
properties.backends	Backend[]	Die Back-End-Gruppe für diesen Pool
properties.healthProbeSettings	SubResource	L7-Integritätstesteinstellungen für einen Back-End-Pool
properties.loadBalancingSettings	SubResource	Lastenausgleichseinstellungen für einen Back-End-Pool
properties.resourceState	FrontDoorResourceState	Ressourcen status der Unterressource Front Door oder Front Door. Ressourcen status.
type	string	Der Ressourcentyp.

BackendPoolsSettings

Einstellungen, die für alle Back-End-Pools gelten.

Name	Typ	Standardwert	Beschreibung
enforceCertificateNameCheck	enforceCertificateNameCheckEnabledState	Enabled	Gibt an, ob die Überprüfung des Zertifikatnamens bei HTTPS-Anforderungen an alle Back-End-Pools erzwungen werden soll. Keine Auswirkung auf Nicht-HTTPS-Anforderungen.
sendRecvTimeoutSeconds	integer		Senden und Empfangen eines Timeouts für die Weiterleitungsanforderung an das Back-End. Wenn das Timeout erreicht ist, schlägt die Anforderung fehl und gibt zurück.

CacheConfiguration

Zwischenspeicherungseinstellungen für eine Zwischenspeicherungsroute. Um die Zwischenspeicherung zu deaktivieren, geben Sie kein cacheConfiguration-Objekt an.

Name	Typ	Beschreibung
dynamicCompression	DynamicCompressionEnabled	Gibt an, ob die dynamische Komprimierung für zwischengespeicherte Inhalte verwendet werden soll
queryParameterStripDirective	FrontDoorQuery	Behandlung von URL-Abfragebegriffen beim Erstellen des Cacheschlüssels.

CustomHttpsConfiguration

HTTPS-Einstellungen für eine Domäne

Name	Typ	Beschreibung
certificateSource	FrontDoorCertificateSource	Definiert die Quelle des SSL-Zertifikats.
frontDoorCertificateSourceParameters.certificateType	FrontDoorCertificateType	Definiert den Typ des Zertifikats, das für sichere Verbindungen mit einem frontendEndpoint verwendet wird.
keyVaultCertificateSourceParameters.secretName	string	Der Name des Key Vault-Geheimnisses, das die vollständige Zertifikat-PFX darstellt
keyVaultCertificateSourceParameters.secretVersion	string	Die Version des Key Vault-Geheimnisses, das die vollständige Zertifikat-PFX darstellt
keyVaultCertificateSourceParameters.vault	Vault	Der Schlüsseltresor mit dem SSL-Zertifikat
minimumTlsVersion	MinimumTLSVersion	Die TLS-Mindestversion, die von den Clients benötigt wird, um einen SSL-Handshake mit Front Door einzurichten.
protocolType	FrontDoorTlsProtocolType	Definiert das TLS-Erweiterungsprotokoll, das für die sichere Übermittlung verwendet wird.

CustomHttpsProvisioningState

Bereitstellung status von benutzerdefiniertem HTTPS des frontendEndpoints.

Name	Typ	Beschreibung
Disabled	string
Disabling	string
Enabled	string
Enabling	string
Failed	string

CustomHttpsProvisioningSubstate

Der Bereitstellungsunterzustand zeigt den Fortschritt des benutzerdefinierten HTTPS-Aktivierungs-/Deaktivierungsprozesses Schritt für Schritt an.

Name	Typ	Beschreibung
CertificateDeleted	string
CertificateDeployed	string
DeletingCertificate	string
DeployingCertificate	string
DomainControlValidationRequestApproved	string
DomainControlValidationRequestRejected	string
DomainControlValidationRequestTimedOut	string
IssuingCertificate	string
PendingDomainControlValidationREquestApproval	string
SubmittingDomainControlValidationRequest	string

DynamicCompressionEnabled

Gibt an, ob die dynamische Komprimierung für zwischengespeicherte Inhalte verwendet werden soll

Name	Typ	Beschreibung
Disabled	string
Enabled	string

enforceCertificateNameCheckEnabledState

Gibt an, ob die Überprüfung des Zertifikatnamens für HTTPS-Anforderungen an alle Back-End-Pools erzwungen werden soll. Keine Auswirkung auf Nicht-HTTPS-Anforderungen.

Name	Typ	Beschreibung
Disabled	string
Enabled	string

ErrorResponse

Die Fehlerantwort gibt an, dass der Front Door-Dienst die eingehende Anforderung nicht verarbeiten kann. Der Grund wird in der Fehlermeldung angegeben.

Name	Typ	Beschreibung
code	string	Fehlercode
message	string	Eine Fehlermeldung, die angibt, warum der Vorgang fehlgeschlagen ist.

ForwardingConfiguration

Beschreibt die Weiterleitungsroute.

Name	Typ	Beschreibung
@odata.type	string: #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration
backendPool	SubResource	Ein Verweis auf den Back-EndPool, an den diese Regel weitergeleitet wird.
cacheConfiguration	CacheConfiguration	Die dieser Regel zugeordnete Zwischenspeicherungskonfiguration.
customForwardingPath	string	Ein benutzerdefinierter Pfad, der zum erneuten Generieren von Ressourcenpfaden verwendet wird, die von dieser Regel abgeglichen werden. Machen Sie keine Angabe, um einen eingehenden Pfad zu verwenden.
forwardingProtocol	FrontDoorForwardingProtocol	Das Protokoll, das diese Regel beim Weiterleiten von Datenverkehr an Back-Ends verwendet.

FrontDoor

Front Door stellt eine Sammlung von Back-End-Endpunkten dar, an die Datenverkehr weitergeleitet werden soll, zusammen mit Regeln, die angeben, wie Datenverkehr dorthin gesendet wird.

Name	Typ	Beschreibung
id	string	Ressourcen-ID
location	string	Ressourcenspeicherort
name	string	Name der Ressource.
properties.backendPools	BackendPool[]	Back-End-Pools, die für Routingregeln verfügbar sind.
properties.backendPoolsSettings	BackendPoolsSettings	Einstellungen für alle back-EndPools
properties.cname	string	Der Host, für den jeder front-EndEndpoint CNAME verwenden muss.
properties.enabledState	FrontDoorEnabledState	Betriebsstatus des Front Door-Lastenausgleichs Zulässige Werte sind "Aktiviert" oder "Deaktiviert".
properties.friendlyName	string	Ein Anzeigename für die FrontDoor
properties.frontendEndpoints	FrontendEndpoint[]	Front-End-Endpunkte, die für Routingregeln verfügbar sind.
properties.healthProbeSettings	HealthProbeSettingsModel[]	Dieser Front Door-Instanz zugeordnete Integritätstesteinstellungen
properties.loadBalancingSettings	LoadBalancingSettingsModel[]	Dieser Front Door-Instanz zugeordnete Lastenausgleichseinstellungen
properties.provisioningState	string	Bereitstellungsstatus der Front Door.
properties.resourceState	FrontDoorResourceState	Ressourcen status der Unterressource Front Door oder Front Door. Ressourcen status der Front Door.
properties.routingRules	RoutingRule[]	Routingregeln, die dieser Front Door zugeordnet sind.
tags	object	Ressourcentags.
type	string	Der Ressourcentyp.

FrontDoorCertificateSource

Definiert die Quelle des SSL-Zertifikats.

Name	Typ	Beschreibung
AzureKeyVault	string
FrontDoor	string

FrontDoorCertificateType

Definiert den Typ des Zertifikats, das für sichere Verbindungen mit einem frontendEndpoint verwendet wird.

Name	Typ	Beschreibung
Dedicated	string

FrontDoorEnabledState

Betriebsstatus des Front Door-Lastenausgleichs Zulässige Werte sind "Enabled" oder "Disabled".

Name	Typ	Beschreibung
Disabled	string
Enabled	string

FrontDoorForwardingProtocol

Das Protokoll, das diese Regel beim Weiterleiten von Datenverkehr an Back-Ends verwendet.

Name	Typ	Beschreibung
HttpOnly	string
HttpsOnly	string
MatchRequest	string

FrontDoorHealthProbeMethod

Konfiguriert, welche HTTP-Methode zum Testen der unter backPools definierten Back-Ends verwendet werden soll.

Name	Typ	Beschreibung
GET	string
HEAD	string

FrontDoorProtocol

Protokollschemas, die für diese Regel übereinstimmen

Name	Typ	Beschreibung
Http	string
Https	string

FrontDoorQuery

Behandlung von URL-Abfragebegriffen beim Erstellen des Cacheschlüssels.

Name	Typ	Beschreibung
StripAll	string
StripNone	string

FrontDoorRedirectProtocol

Das Protokoll des Ziels, an das der Datenverkehr umgeleitet wird

Name	Typ	Beschreibung
HttpOnly	string
HttpsOnly	string
MatchRequest	string

FrontDoorRedirectType

Der Umleitungstyp, den die Regel beim Umleiten von Datenverkehr verwendet.

Name	Typ	Beschreibung
Found	string
Moved	string
PermanentRedirect	string
TemporaryRedirect	string

FrontDoorResourceState

Ressourcen status der Unterressource Front Door oder Front Door.

Name	Typ	Beschreibung
Creating	string
Deleting	string
Disabled	string
Disabling	string
Enabled	string
Enabling	string

FrontDoorTlsProtocolType

Definiert das TLS-Erweiterungsprotokoll, das für die sichere Übermittlung verwendet wird.

Name	Typ	Beschreibung
ServerNameIndication	string

FrontendEndpoint

Ein Front-End-Endpunkt, der für das Routing verwendet wird.

Name	Typ	Beschreibung
id	string	Ressourcen-ID
name	string	Name der Ressource.
properties.customHttpsConfiguration	CustomHttpsConfiguration	Die Konfiguration, die angibt, wie HTTPS aktiviert werden soll
properties.customHttpsProvisioningState	CustomHttpsProvisioningState	Bereitstellung status von benutzerdefiniertem HTTPS des frontendEndpoint.
properties.customHttpsProvisioningSubstate	CustomHttpsProvisioningSubstate	Der Bereitstellungsunterzustand zeigt den Fortschritt des benutzerdefinierten HTTPS-Aktivierungs-/Deaktivierungsprozesses Schritt für Schritt an.
properties.hostName	string	Der Hostname für den frontendEndpoint. Dies muss ein Domänenname sein.
properties.resourceState	FrontDoorResourceState	Ressourcen status der Unterressource Front Door oder Front Door. Ressourcen status.
properties.sessionAffinityEnabledState	SessionAffinityEnabledState	Angabe, ob Sitzungsaffinität auf diesem Host zugelassen wird. Gültige Optionen sind "Aktiviert" oder "Deaktiviert".
properties.sessionAffinityTtlSeconds	integer	UNBENUTZTE. Dieses Feld wird ignoriert. Die Gültigkeitsdauer in Sekunden, die für die Sitzungsaffinität verwendet werden soll, falls zutreffend.
properties.webApplicationFirewallPolicyLink	WebApplicationFirewallPolicyLink	Definiert die Web Application Firewall-Richtlinie für jeden Host (falls zutreffend).
type	string	Der Ressourcentyp.

HealthProbeEnabled

Gibt an, ob Integritätstests für Back-End-Instanzen aktiviert werden sollen, die unter backPools definiert sind. Integritätstests können nur deaktiviert werden, wenn ein einzelnes aktiviertes Back-End in einem einzelnen aktivierten Back-End-Pool vorhanden ist.

Name	Typ	Beschreibung
Disabled	string
Enabled	string

HealthProbeSettingsModel

Lastenausgleichseinstellungen für einen Back-End-Pool

Name	Typ	Standardwert	Beschreibung
id	string		Ressourcen-ID
name	string		Name der Ressource.
properties.enabledState	HealthProbeEnabled		Gibt an, ob Integritätstests für Back-End-Instanzen aktiviert werden sollen, die unter backPools definiert sind. Integritätstests können nur deaktiviert werden, wenn ein einzelnes aktiviertes Back-End in einem einzelnen aktivierten Back-End-Pool vorhanden ist.
properties.healthProbeMethod	FrontDoorHealthProbeMethod	HEAD	Konfiguriert, welche HTTP-Methode zum Testen der unter backPools definierten Back-Ends verwendet werden soll.
properties.intervalInSeconds	integer		Die Anzahl von Sekunden zwischen Integritätstests.
properties.path	string		Der Pfad für den Integritätstest. Standardwert: /
properties.protocol	FrontDoorProtocol		Protokollschema, das für diesen Test verwendet werden soll
properties.resourceState	FrontDoorResourceState		Ressourcen status der Unterressource Front Door oder Front Door. Ressourcen status.
type	string		Der Ressourcentyp.

LoadBalancingSettingsModel

Lastenausgleichseinstellungen für einen Back-End-Pool

Name	Typ	Beschreibung
id	string	Ressourcen-ID
name	string	Name der Ressource.
properties.additionalLatencyMilliseconds	integer	Die zusätzliche Latenzzeit in Millisekunden für Tests, die in den Bucket mit der niedrigsten Latenz fallen
properties.resourceState	FrontDoorResourceState	Ressourcen status der Unterressource Front Door oder Front Door. Ressourcen status.
properties.sampleSize	integer	Die Anzahl der Beispiele, die bei Lastenausgleichsentscheidungen berücksichtigt werden sollen
properties.successfulSamplesRequired	integer	Die Anzahl der Stichproben innerhalb des Beispielzeitraums, die erfolgreich sein müssen
type	string	Der Ressourcentyp.

MinimumTLSVersion

Die TLS-Mindestversion, die von den Clients benötigt wird, um einen SSL-Handshake mit Front Door einzurichten.

Name	Typ	Beschreibung
1.0	string
1.2	string

RedirectConfiguration

Beschreibt die Umleitungsroute.

Name	Typ	Beschreibung
@odata.type	string: #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration
customFragment	string	Fragment, das der Umleitungs-URL hinzugefügt werden soll. Fragment ist der Teil der URL nach #. Schließen Sie die #-Datei nicht ein.
customHost	string	Host für die Umleitung. Lassen Sie leer, um den eingehenden Host als Zielhost zu verwenden.
customPath	string	Der vollständige Umleitungspfad. Der Pfad darf nicht leer sein und muss mit /beginnen. Lassen Sie leer, um den eingehenden Pfad als Zielpfad zu verwenden.
customQueryString	string	Der Satz von Abfragezeichenfolgen, die in der Umleitungs-URL platziert werden sollen. Durch festlegen dieses Werts würde jede vorhandene Abfragezeichenfolge ersetzt. Lassen Sie leer, um die eingehende Abfragezeichenfolge beizubehalten. Die Abfragezeichenfolge muss im Format = vorliegen. Die erste ? und & automatisch hinzugefügt, schließen Sie sie also nicht in den Vordergrund ein, sondern trennen Sie mehrere Abfragezeichenfolgen mit &.
redirectProtocol	FrontDoorRedirectProtocol	Das Protokoll des Ziels, an das der Datenverkehr umgeleitet wird
redirectType	FrontDoorRedirectType	Der Umleitungstyp, den die Regel beim Umleiten von Datenverkehr verwendet.

RoutingRule

Eine Routingregel stellt eine Spezifikation für den zu behandelnden Datenverkehr und den Sendeort zusammen mit Integritätstestinformationen dar.

Name	Typ	Beschreibung
id	string	Ressourcen-ID
name	string	Name der Ressource.
properties.acceptedProtocols	FrontDoorProtocol[]	Protokollschemas, die für diese Regel übereinstimmen
properties.enabledState	routingRuleEnabledState	Gibt an, ob die Verwendung dieser Regel aktiviert werden soll. Zulässige Werte sind "Aktiviert" oder "Deaktiviert".
properties.frontendEndpoints	SubResource[]	Front-End-Endpunkte, die dieser Regel zugeordnet sind
properties.patternsToMatch	string[]	Die Routenmuster der Regel.
properties.resourceState	FrontDoorResourceState	Ressourcen status der Unterressource Front Door oder Front Door. Ressourcen status.
properties.routeConfiguration	RouteConfiguration: ForwardingConfiguration RedirectConfiguration	Ein Verweis auf die Routingkonfiguration.
type	string	Der Ressourcentyp.

routingRuleEnabledState

Gibt an, ob die Verwendung dieser Regel aktiviert werden soll. Zulässige Werte sind "Aktiviert" oder "Deaktiviert".

Name	Typ	Beschreibung
Disabled	string
Enabled	string

SessionAffinityEnabledState

Angabe, ob Sitzungsaffinität auf diesem Host zugelassen wird. Gültige Optionen sind "Aktiviert" oder "Deaktiviert".

Name	Typ	Beschreibung
Disabled	string
Enabled	string

SubResource

Verweis auf eine andere Unterquelle.

Name	Typ	Beschreibung
id	string	Ressourcen-ID

Vault

Der Schlüsseltresor mit dem SSL-Zertifikat

Name	Typ	Beschreibung
id	string	Ressourcen-ID

WebApplicationFirewallPolicyLink

Definiert die Web Application Firewall richtlinie für jeden Host (falls zutreffend)

Name	Typ	Beschreibung
id	string	Ressourcen-ID

Front Doors - Create Or Update

URI-Parameter

Anforderungstext

Antworten

Sicherheit

azure_auth

Scopes

Beispiele

Create or update specific Front Door

Sample Request

Sample Response

Definitionen

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

Zusätzliche Ressourcen