Front Doors - Create Or Update

Referenz

Dienst:: Front Door Service

API-Version:: 2019-05-01

Erstellt eine neue Front Door 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 minLength: 5 maxLength: 64 pattern: ^[a-zA-Z0-9]+([-a-zA-Z0-9]?[a-zA-Z0-9])*$	Name der Front Door, die global eindeutig ist.
resourceGroupName	path	True	string minLength: 1 maxLength: 80 pattern: ^[a-zA-Z0-9_\-\.]*[^\.]$	Name der Ressourcengruppe innerhalb des Azure-Abonnements.
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 für Routingregeln verfügbar.
properties.backendPoolsSettings	BackendPoolsSettings	Einstellungen für alle Back-EndPools
properties.enabledState	FrontDoorEnabledState	Betriebsstatus des Front Door Lastenausgleichsgeräts. Zulässige Werte sind "Enabled" oder "Disabled"
properties.friendlyName	string	Ein Anzeigename für die FrontDoor
properties.frontendEndpoints	FrontendEndpoint[]	Frontend-Endpunkte, die für Routingregeln verfügbar sind.
properties.healthProbeSettings	HealthProbeSettingsModel[]	Integritätssondeneinstellungen, die dieser Front Door-Instanz zugeordnet sind.
properties.loadBalancingSettings	LoadBalancingSettingsModel[]	Lastenausgleichseinstellungen, die dieser Front Door-Instanz zugeordnet sind.
properties.routingRules	RoutingRule[]	Routingregeln, die dieser Front door zugeordnet sind.
tags	object	Ressourcentags.

Antworten

Name	Typ	Beschreibung
200 OK	FrontDoor	OKAY. Die Anforderung ist erfolgreich.
201 Created	FrontDoor	Erstellt. Die Anforderung wurde erfüllt und eine neue Front Door wurde erstellt.
202 Accepted	FrontDoor	Angenommen. Die Anforderung wurde zur Verarbeitung akzeptiert, und der Vorgang wird asynchron abgeschlossen.
Other Status Codes	ErrorResponse	Fehlerantwort an der Fronttür, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

Create or update specific Front Door

Beispielanforderung

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

Beispiel für eine Antwort

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

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-End-Dateien, an die weitergeleitet werden kann.
BackendPoolsSettings	Einstellungen, die für alle Back-End-Pools gelten.
CacheConfiguration	Zwischenspeicherungseinstellungen für eine Zwischenspeicherungsartroute. Um die Zwischenspeicherung zu deaktivieren, stellen Sie kein cacheConfiguration-Objekt bereit.
CustomHttpsConfiguration	Https-Einstellungen für eine Domäne
CustomHttpsProvisioningState	Bereitstellungsstatus von "Custom Https" des frontendEndpoint.
CustomHttpsProvisioningSubstate	Der Unterstatus für die Bereitstellung zeigt den Fortschritt des benutzerdefinierten HTTPS-Aktivierungs-/Deaktivierungsprozesses schrittweise an.
DynamicCompressionEnabled	Gibt an, ob dynamische Komprimierung für zwischengespeicherte Inhalte verwendet werden soll.
enforceCertificateNameCheckEnabledState	Gibt an, ob die Zertifikatnamenüberprüfung für HTTPS-Anforderungen für alle Back-End-Pools erzwungen werden soll. Keine Auswirkung auf Nicht-HTTPS-Anforderungen.
ErrorResponse	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, um Datenverkehr zusammen mit Regeln zu leiten, 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 Lastenausgleichsgeräts. Zulässige Werte sind "Enabled" oder "Disabled"
FrontDoorForwardingProtocol	Protokollieren Sie diese Regel, wenn Sie Datenverkehr an Back-Ends weiterleiten.
FrontDoorHealthProbeMethod	Konfiguriert, welche HTTP-Methode verwendet werden soll, um die unter back-EndPools definierten Back-Ends zu untersuchen.
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	Ressourcenstatus der Unterressource "Front Door" oder "Front Door".
FrontDoorTlsProtocolType	Definiert das TLS-Erweiterungsprotokoll, das für die sichere Übermittlung verwendet wird.
FrontendEndpoint	Ein Frontend-Endpunkt, der für das Routing verwendet wird.
HealthProbeEnabled	Gibt an, ob Integritätsüberprüfungen für Back-End-Dateien aktiviert werden sollen, die unter back-EndPools definiert sind. Integritätssonden können nur deaktiviert werden, wenn ein einzelnes aktiviertes Back-End in einem einzigen aktivierten Back-End-Pool vorhanden ist.
HealthProbeSettingsModel	Lastenausgleichseinstellungen für einen Back-End-Pool
LoadBalancingSettingsModel	Lastenausgleichseinstellungen für einen Back-End-Pool
MinimumTLSVersion	Die mindeste TLS-Version, 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 deren Sendeort zusammen mit Integritätsprüfinformationen dar.
routingRuleEnabledState	Gibt an, ob die Verwendung dieser Regel aktiviert werden soll. Zulässige Werte sind "Enabled" oder "Disabled"
SessionAffinityEnabledState	Gibt an, ob Sitzungsaffinität auf diesem Host zugelassen werden soll. Gültige Optionen sind "Aktiviert" oder "Deaktiviert"
SubResource	Verweisen auf eine andere Unterressource.
Vault	Der Schlüsseltresor, der das SSL-Zertifikat enthält
WebApplicationFirewallPolicyLink	Definiert die Webanwendungsfirewallrichtlinie für jeden Host (falls zutreffend)

Backend

Objekt

Back-End-Adresse eines FrontDoor-Lastenausgleichs.

Name	Typ	Beschreibung
address	string	Speicherort des Back-End (IP-Adresse oder FQDN)
backendHostHeader	string	Der Wert, der als Hostheader verwendet werden soll, der an das Back-End gesendet wird. Wenn leer oder nicht angegeben, wird dieser Standardwert für den eingehenden Host verwendet.
enabledState	backendEnabledState	Gibt an, ob die Verwendung dieses Back-Ends aktiviert werden soll. Zulässige Werte sind "Enabled" oder "Disabled"
httpPort	integer minimum: 1 maximum: 65535 exclusiveMinimum: False exclusiveMaximum: False	Die HTTP-TCP-Portnummer. Muss zwischen 1 und 65535 sein.
httpsPort	integer minimum: 1 maximum: 65535 exclusiveMinimum: False exclusiveMaximum: False	Die HTTPS-TCP-Portnummer. Muss zwischen 1 und 65535 sein.
priority	integer minimum: 1 maximum: 5	Priorität für den Lastenausgleich. Höhere Prioritäten werden nicht für den Lastenausgleich verwendet, wenn ein Back-End mit niedrigerer Priorität fehlerfrei ist.
weight	integer minimum: 1 maximum: 1000	Gewichtung dieses Endpunkts für Lastenausgleichszwecke.

backendEnabledState

Enumeration

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

Wert	Beschreibung
Disabled
Enabled

BackendPool

Objekt

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

Name	Typ	Beschreibung
id	string	Ressourcen-ID.
name	string	Ressourcenname.
properties.backends	Backend[]	Der Satz von Back-Ends für diesen Pool
properties.healthProbeSettings	SubResource	L7-Integritätssondeneinstellungen für einen Back-End-Pool
properties.loadBalancingSettings	SubResource	Lastenausgleichseinstellungen für einen Back-End-Pool
properties.resourceState	FrontDoorResourceState	Ressourcenstatus der Unterressource "Front Door" oder "Front Door". Ressourcenstatus.
type	string	Ressourcentyp.

BackendPoolsSettings

Objekt

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

Name	Typ	Standardwert	Beschreibung
enforceCertificateNameCheck	enforceCertificateNameCheckEnabledState	Enabled	Gibt an, ob die Zertifikatnamenüberprüfung für HTTPS-Anforderungen für alle Back-End-Pools erzwungen werden soll. Keine Auswirkung auf Nicht-HTTPS-Anforderungen.
sendRecvTimeoutSeconds	integer minimum: 16 exclusiveMinimum: False		Timeout beim Senden und Empfangen von Weiterleitungsanforderungen an das Back-End. Wenn timeout erreicht ist, schlägt die Anforderung fehl und gibt diese zurück.

CacheConfiguration

Objekt

Zwischenspeicherungseinstellungen für eine Zwischenspeicherungsartroute. Um die Zwischenspeicherung zu deaktivieren, stellen Sie kein cacheConfiguration-Objekt bereit.

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

CustomHttpsConfiguration

Objekt

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 Schlüsseltresorschlüssels, der den vollständigen PFX-Zertifikat darstellt
keyVaultCertificateSourceParameters.secretVersion	string	Die Version des Schlüsseltresorschlüssels, der das vollständige Zertifikat PFX darstellt
keyVaultCertificateSourceParameters.vault	Vault	Der Schlüsseltresor, der das SSL-Zertifikat enthält
minimumTlsVersion	MinimumTLSVersion	Die mindeste TLS-Version, 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

Enumeration

Bereitstellungsstatus von "Custom Https" des frontendEndpoint.

Wert	Beschreibung
Disabled
Disabling
Enabled
Enabling
Failed

CustomHttpsProvisioningSubstate

Enumeration

Der Unterstatus für die Bereitstellung zeigt den Fortschritt des benutzerdefinierten HTTPS-Aktivierungs-/Deaktivierungsprozesses schrittweise an.

Wert	Beschreibung
CertificateDeleted
CertificateDeployed
DeletingCertificate
DeployingCertificate
DomainControlValidationRequestApproved
DomainControlValidationRequestRejected
DomainControlValidationRequestTimedOut
IssuingCertificate
PendingDomainControlValidationREquestApproval
SubmittingDomainControlValidationRequest

DynamicCompressionEnabled

Enumeration

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

Wert	Beschreibung
Disabled
Enabled

enforceCertificateNameCheckEnabledState

Enumeration

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

Wert	Beschreibung
Disabled
Enabled

ErrorResponse

Objekt

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	Fehlermeldung, die angibt, warum der Vorgang fehlgeschlagen ist.

ForwardingConfiguration

Objekt

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 Umschreiben von Ressourcenpfaden verwendet wird, die mit dieser Regel übereinstimmen. Lassen Sie leer, um den eingehenden Pfad zu verwenden.
forwardingProtocol	FrontDoorForwardingProtocol	Protokollieren Sie diese Regel, wenn Sie Datenverkehr an Back-Ends weiterleiten.

FrontDoor

Objekt

Front Door stellt eine Sammlung von Back-End-Endpunkten dar, um Datenverkehr zusammen mit Regeln zu leiten, die angeben, wie Datenverkehr dorthin gesendet wird.

Name	Typ	Beschreibung
id	string	Ressourcen-ID.
location	string	Ressourcenspeicherort.
name	string	Ressourcenname.
properties.backendPools	BackendPool[]	Back-End-Pools für Routingregeln verfügbar.
properties.backendPoolsSettings	BackendPoolsSettings	Einstellungen für alle Back-EndPools
properties.cname	string	Der Host, auf den jeder frontendEndpoint CNAME muss.
properties.enabledState	FrontDoorEnabledState	Betriebsstatus des Front Door Lastenausgleichsgeräts. Zulässige Werte sind "Enabled" oder "Disabled"
properties.friendlyName	string	Ein Anzeigename für die FrontDoor
properties.frontendEndpoints	FrontendEndpoint[]	Frontend-Endpunkte, die für Routingregeln verfügbar sind.
properties.healthProbeSettings	HealthProbeSettingsModel[]	Integritätssondeneinstellungen, die dieser Front Door-Instanz zugeordnet sind.
properties.loadBalancingSettings	LoadBalancingSettingsModel[]	Lastenausgleichseinstellungen, die dieser Front Door-Instanz zugeordnet sind.
properties.provisioningState	string	Bereitstellungszustand der Tür.
properties.resourceState	FrontDoorResourceState	Ressourcenstatus der Unterressource "Front Door" oder "Front Door". Ressourcenstatus der Tür.
properties.routingRules	RoutingRule[]	Routingregeln, die dieser Front door zugeordnet sind.
tags	object	Ressourcentags.
type	string	Ressourcentyp.

FrontDoorCertificateSource

Enumeration

Definiert die Quelle des SSL-Zertifikats.

Wert	Beschreibung
AzureKeyVault
FrontDoor

FrontDoorCertificateType

Enumeration

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

Wert	Beschreibung
Dedicated

FrontDoorEnabledState

Enumeration

Betriebsstatus des Front Door Lastenausgleichsgeräts. Zulässige Werte sind "Enabled" oder "Disabled"

Wert	Beschreibung
Disabled
Enabled

FrontDoorForwardingProtocol

Enumeration

Protokollieren Sie diese Regel, wenn Sie Datenverkehr an Back-Ends weiterleiten.

Wert	Beschreibung
HttpOnly
HttpsOnly
MatchRequest

FrontDoorHealthProbeMethod

Enumeration

Konfiguriert, welche HTTP-Methode verwendet werden soll, um die unter back-EndPools definierten Back-Ends zu untersuchen.

Wert	Beschreibung
GET
HEAD

FrontDoorProtocol

Enumeration

Protokollschemas, die für diese Regel übereinstimmen

Wert	Beschreibung
Http
Https

FrontDoorQuery

Enumeration

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

Wert	Beschreibung
StripAll
StripNone

FrontDoorRedirectProtocol

Enumeration

Das Protokoll des Ziels, an das der Datenverkehr umgeleitet wird

Wert	Beschreibung
HttpOnly
HttpsOnly
MatchRequest

FrontDoorRedirectType

Enumeration

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

Wert	Beschreibung
Found
Moved
PermanentRedirect
TemporaryRedirect

FrontDoorResourceState

Enumeration

Ressourcenstatus der Unterressource "Front Door" oder "Front Door".

Wert	Beschreibung
Creating
Deleting
Disabled
Disabling
Enabled
Enabling

FrontDoorTlsProtocolType

Enumeration

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

Wert	Beschreibung
ServerNameIndication

FrontendEndpoint

Objekt

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

Name	Typ	Beschreibung
id	string	Ressourcen-ID.
name	string	Ressourcenname.
properties.customHttpsConfiguration	CustomHttpsConfiguration	Die Konfiguration, die angibt, wie HTTPS aktiviert werden soll
properties.customHttpsProvisioningState	CustomHttpsProvisioningState	Bereitstellungsstatus von "Custom Https" des frontendEndpoint.
properties.customHttpsProvisioningSubstate	CustomHttpsProvisioningSubstate	Der Unterstatus für die Bereitstellung zeigt den Fortschritt des benutzerdefinierten HTTPS-Aktivierungs-/Deaktivierungsprozesses schrittweise an.
properties.hostName	string	Der Hostname des frontendEndpoint. Muss ein Domänenname sein.
properties.resourceState	FrontDoorResourceState	Ressourcenstatus der Unterressource "Front Door" oder "Front Door". Ressourcenstatus.
properties.sessionAffinityEnabledState	SessionAffinityEnabledState	Gibt an, ob Sitzungsaffinität auf diesem Host zugelassen werden soll. Gültige Optionen sind "Aktiviert" oder "Deaktiviert"
properties.sessionAffinityTtlSeconds	integer	UNBENUTZT. Dieses Feld wird ignoriert. Die TTL, die in Sekunden für die Sitzungsaffinität verwendet werden soll, falls zutreffend.
properties.webApplicationFirewallPolicyLink	WebApplicationFirewallPolicyLink	Definiert die Webanwendungsfirewallrichtlinie für jeden Host (falls zutreffend)
type	string	Ressourcentyp.

HealthProbeEnabled

Enumeration

Gibt an, ob Integritätsüberprüfungen für Back-End-Dateien aktiviert werden sollen, die unter back-EndPools definiert sind. Integritätssonden können nur deaktiviert werden, wenn ein einzelnes aktiviertes Back-End in einem einzigen aktivierten Back-End-Pool vorhanden ist.

Wert	Beschreibung
Disabled
Enabled

HealthProbeSettingsModel

Objekt

Lastenausgleichseinstellungen für einen Back-End-Pool

Name	Typ	Standardwert	Beschreibung
id	string		Ressourcen-ID.
name	string		Ressourcenname.
properties.enabledState	HealthProbeEnabled		Gibt an, ob Integritätsüberprüfungen für Back-End-Dateien aktiviert werden sollen, die unter back-EndPools definiert sind. Integritätssonden können nur deaktiviert werden, wenn ein einzelnes aktiviertes Back-End in einem einzigen aktivierten Back-End-Pool vorhanden ist.
properties.healthProbeMethod	FrontDoorHealthProbeMethod	HEAD	Konfiguriert, welche HTTP-Methode verwendet werden soll, um die unter back-EndPools definierten Back-Ends zu untersuchen.
properties.intervalInSeconds	integer		Die Anzahl der Sekunden zwischen Integritätssonden.
properties.path	string		Der Pfad, der für die Integritätssonde verwendet werden soll. Standard ist /
properties.protocol	FrontDoorProtocol		Für diese Probe zu verwendende Protokollschema
properties.resourceState	FrontDoorResourceState		Ressourcenstatus der Unterressource "Front Door" oder "Front Door". Ressourcenstatus.
type	string		Ressourcentyp.

LoadBalancingSettingsModel

Objekt

Lastenausgleichseinstellungen für einen Back-End-Pool

Name	Typ	Beschreibung
id	string	Ressourcen-ID.
name	string	Ressourcenname.
properties.additionalLatencyMilliseconds	integer	Die zusätzliche Latenz in Millisekunden für Probes, die in den niedrigsten Latenz-Bucket fallen
properties.resourceState	FrontDoorResourceState	Ressourcenstatus der Unterressource "Front Door" oder "Front Door". Ressourcenstatus.
properties.sampleSize	integer	Die Anzahl der Beispiele, die für Lastenausgleichsentscheidungen berücksichtigt werden sollen
properties.successfulSamplesRequired	integer	Die Anzahl der Proben innerhalb des Stichprobenzeitraums, die erfolgreich sein müssen
type	string	Ressourcentyp.

MinimumTLSVersion

Enumeration

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

Wert	Beschreibung
1.0
1.2

RedirectConfiguration

Objekt

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, die nach #kommt. Schließen Sie die Datei "#" nicht ein.
customHost	string	Host, der umgeleitet werden soll. Lassen Sie leer, um den eingehenden Host als Zielhost zu verwenden.
customPath	string	Der vollständige Pfad zur Umleitung. 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 & werden automatisch hinzugefügt, sodass sie nicht in den Vordergrund eingeschlossen werden, 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

Objekt

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

Name	Typ	Beschreibung
id	string	Ressourcen-ID.
name	string	Ressourcenname.
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 "Enabled" oder "Disabled"
properties.frontendEndpoints	SubResource[]	Front-End-Endpunkte, die dieser Regel zugeordnet sind
properties.patternsToMatch	string[]	Die Routenmuster der Regel.
properties.resourceState	FrontDoorResourceState	Ressourcenstatus der Unterressource "Front Door" oder "Front Door". Ressourcenstatus.
properties.routeConfiguration	RouteConfiguration: ForwardingConfiguration RedirectConfiguration	Ein Verweis auf die Routingkonfiguration.
type	string	Ressourcentyp.

routingRuleEnabledState

Enumeration

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

Wert	Beschreibung
Disabled
Enabled

SessionAffinityEnabledState

Enumeration

Gibt an, ob Sitzungsaffinität auf diesem Host zugelassen werden soll. Gültige Optionen sind "Aktiviert" oder "Deaktiviert"

Wert	Beschreibung
Disabled
Enabled

SubResource

Objekt

Verweisen auf eine andere Unterressource.

Name	Typ	Beschreibung
id	string	Ressourcen-ID.

Vault

Objekt

Der Schlüsseltresor, der das SSL-Zertifikat enthält

Name	Typ	Beschreibung
id	string	Ressourcen-ID.

WebApplicationFirewallPolicyLink

Objekt

Definiert die Webanwendungsfirewallrichtlinie für jeden Host (falls zutreffend)

Name	Typ	Beschreibung
id	string	Ressourcen-ID.

Freigeben über

Front Doors - Create Or Update

URI-Parameter

Anforderungstext

Antworten

Sicherheit

azure_auth

Bereiche

Beispiele

Create or update specific Front Door

Beispielanforderung

Beispiel für eine Antwort

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