Front Doors - Create Or Update

Referens

Tjänst:: Front Door Service

API-version:: 2019-05-01

Skapar en ny Front Door med ett Front Door-namn under den angivna prenumerationen och resursgruppen.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
frontDoorName	path	True	string minLength: 5 maxLength: 64 pattern: ^[a-zA-Z0-9]+([-a-zA-Z0-9]?[a-zA-Z0-9])*$	Namnet på Front Door som är globalt unikt.
resourceGroupName	path	True	string minLength: 1 maxLength: 80 pattern: ^[a-zA-Z0-9_\-\.]*[^\.]$	Namnet på resursgruppen i Azure-prenumerationen.
subscriptionId	path	True	string	Autentiseringsuppgifterna för prenumerationen som unikt identifierar Microsoft Azure-prenumerationen. Prenumerations-ID:t utgör en del av URI:n för varje tjänstanrop.
api-version	query	True	string	Klient-API-version.

Begärandetext

Name	Typ	Description
location	string	Resursplats.
properties.backendPools	BackendPool[]	Serverdelspooler som är tillgängliga för routningsregler.
properties.backendPoolsSettings	BackendPoolsSettings	Inställningar för alla serverdelspooler
properties.enabledState	FrontDoorEnabledState	Driftstatus för Front Door-lastbalanseraren. Tillåtna värden är "Aktiverade" eller "Inaktiverade"
properties.friendlyName	string	Ett eget namn för frontDoor
properties.frontendEndpoints	FrontendEndpoint[]	Klientdelsslutpunkter som är tillgängliga för routningsregler.
properties.healthProbeSettings	HealthProbeSettingsModel[]	Inställningar för hälsoavsökning som är associerade med den här Front Door-instansen.
properties.loadBalancingSettings	LoadBalancingSettingsModel[]	Belastningsutjämningsinställningar som är associerade med den här Front Door-instansen.
properties.routingRules	RoutingRule[]	Routningsregler som är associerade med denna Front Door.
tags	object	Resurstaggar.

Svar

Name	Typ	Description
200 OK	FrontDoor	OKEJ. Begäran har slutförts.
201 Created	FrontDoor	Skapad. Begäran har uppfyllts och en ny Front Door har skapats.
202 Accepted	FrontDoor	Accepterad. Begäran har godkänts för bearbetning och åtgärden slutförs asynkront.
Other Status Codes	ErrorResponse	Front Door-felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

Create or update specific Front Door

Exempelbegäran

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

Exempelsvar

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

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

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

Definitioner

Name	Description
Backend	Serverdelsadress för en frontDoor-lastbalanserare.
backendEnabledState	Om du vill aktivera användning av den här serverdelen. Tillåtna värden är "Aktiverade" eller "Inaktiverade"
BackendPool	En serverdelspool är en samling serverdelar som kan dirigeras till.
BackendPoolsSettings	Inställningar som gäller för alla serverdelspooler.
CacheConfiguration	Cachelagringsinställningar för en väg av cachelagringstyp. Om du vill inaktivera cachelagring ska du inte ange ett cacheConfiguration-objekt.
CustomHttpsConfiguration	Https-inställningar för en domän
CustomHttpsProvisioningState	Etableringsstatus för anpassade https för klientdelenEndpoint.
CustomHttpsProvisioningSubstate	Etableringsundertillstånd visar förloppet för den anpassade HTTPS-aktiverings-/inaktiveringsprocessen steg för steg.
DynamicCompressionEnabled	Om dynamisk komprimering ska användas för cachelagrat innehåll
enforceCertificateNameCheckEnabledState	Om certifikatnamnskontroll ska tillämpas på HTTPS-begäranden till alla serverdelspooler. Ingen effekt på icke-HTTPS-begäranden.
ErrorResponse	Felsvaret anger att Front Door-tjänsten inte kan bearbeta den inkommande begäran. Orsaken anges i felmeddelandet.
ForwardingConfiguration	Beskriver vidarebefordran av väg.
FrontDoor	Front Door representerar en samling serverdelsslutpunkter för att dirigera trafik till tillsammans med regler som anger hur trafik skickas dit.
FrontDoorCertificateSource	Definierar källan för SSL-certifikatet
FrontDoorCertificateType	Definierar vilken typ av certifikat som används för säkra anslutningar till en klientdelSlutpunkt
FrontDoorEnabledState	Driftstatus för Front Door-lastbalanseraren. Tillåtna värden är "Aktiverade" eller "Inaktiverade"
FrontDoorForwardingProtocol	Protokoll som den här regeln använder vid vidarebefordran av trafik till serverdelar.
FrontDoorHealthProbeMethod	Konfigurerar vilken HTTP-metod som ska användas för att avsöka de serverdelar som definierats under backendPools.
FrontDoorProtocol	Protokollscheman som matchar för den här regeln
FrontDoorQuery	Behandling av URL-frågetermer när du bildar cachenyckeln.
FrontDoorRedirectProtocol	Protokollet för målet till där trafiken omdirigeras
FrontDoorRedirectType	Omdirigeringstypen som regeln ska använda vid omdirigering av trafik.
FrontDoorResourceState	Resursstatus för Front Door eller Front Door SubResource.
FrontDoorTlsProtocolType	Definierar TLS-tilläggsprotokollet som används för säker leverans
FrontendEndpoint	En klientdelsslutpunkt som används för routning.
HealthProbeEnabled	Om du vill aktivera hälsoavsökningar mot serverdelar som definierats under backendPools. Hälsoavsökningar kan bara inaktiveras om det finns en enda aktiverad serverdel i en enda aktiverad serverdelspool.
HealthProbeSettingsModel	Belastningsutjämningsinställningar för en serverdelspool
LoadBalancingSettingsModel	Belastningsutjämningsinställningar för en serverdelspool
MinimumTLSVersion	Den lägsta TLS-version som krävs från klienterna för att upprätta en SSL-handskakning med Front Door.
RedirectConfiguration	Beskriver omdirigeringsvägen.
RoutingRule	En routningsregel representerar en specifikation för trafik att behandla och var den ska skickas, tillsammans med hälsoavsökningsinformation.
routingRuleEnabledState	Om du vill aktivera användning av den här regeln. Tillåtna värden är "Aktiverade" eller "Inaktiverade"
SessionAffinityEnabledState	Om du vill tillåta sessionstillhörighet på den här värden. Giltiga alternativ är "Aktiverade" eller "Inaktiverade"
SubResource	Referens till en annan underresurs.
Vault	Nyckelvalvet som innehåller SSL-certifikatet
WebApplicationFirewallPolicyLink	Definierar brandväggsprincipen för webbprogram för varje värd (om tillämpligt)

Backend

Objekt

Serverdelsadress för en frontDoor-lastbalanserare.

Name	Typ	Description
address	string	Plats för serverdelen (IP-adress eller FQDN)
backendHostHeader	string	Värdet som ska användas som värdrubriken som skickas till serverdelen. Om det är tomt eller ospecificerat är detta standardvärdet för den inkommande värden.
enabledState	backendEnabledState	Om du vill aktivera användning av den här serverdelen. Tillåtna värden är "Aktiverade" eller "Inaktiverade"
httpPort	integer minimum: 1 maximum: 65535 exclusiveMinimum: False exclusiveMaximum: False	HTTP TCP-portnumret. Måste vara mellan 1 och 65535.
httpsPort	integer minimum: 1 maximum: 65535 exclusiveMinimum: False exclusiveMaximum: False	HTTPS TCP-portnumret. Måste vara mellan 1 och 65535.
priority	integer minimum: 1 maximum: 5	Prioritet att använda för belastningsutjämning. Högre prioriteter används inte för belastningsutjämning om serverdelen med lägre prioritet är felfri.
weight	integer minimum: 1 maximum: 1000	Den här slutpunktens vikt för belastningsutjämning.

backendEnabledState

Uppräkning

Om du vill aktivera användning av den här serverdelen. Tillåtna värden är "Aktiverade" eller "Inaktiverade"

Värde	Description
Disabled
Enabled

BackendPool

Objekt

En serverdelspool är en samling serverdelar som kan dirigeras till.

Name	Typ	Description
id	string	Resurs-ID.
name	string	Resursnamn.
properties.backends	Backend[]	Uppsättningen serverdelar för den här poolen
properties.healthProbeSettings	SubResource	L7-hälsoavsökningsinställningar för en serverdelspool
properties.loadBalancingSettings	SubResource	Belastningsutjämningsinställningar för en serverdelspool
properties.resourceState	FrontDoorResourceState	Resursstatus för Front Door eller Front Door SubResource. Resursstatus.
type	string	Resurstyp.

BackendPoolsSettings

Objekt

Inställningar som gäller för alla serverdelspooler.

Name	Typ	Standardvärde	Description
enforceCertificateNameCheck	enforceCertificateNameCheckEnabledState	Enabled	Om certifikatnamnskontroll ska tillämpas på HTTPS-begäranden till alla serverdelspooler. Ingen effekt på icke-HTTPS-begäranden.
sendRecvTimeoutSeconds	integer minimum: 16 exclusiveMinimum: False		Tidsgränsen för att skicka och ta emot vid vidarebefordran av begäran till serverdelen. När tidsgränsen nås misslyckas begäran och returneras.

CacheConfiguration

Objekt

Cachelagringsinställningar för en väg av cachelagringstyp. Om du vill inaktivera cachelagring ska du inte ange ett cacheConfiguration-objekt.

Name	Typ	Description
dynamicCompression	DynamicCompressionEnabled	Om dynamisk komprimering ska användas för cachelagrat innehåll
queryParameterStripDirective	FrontDoorQuery	Behandling av URL-frågetermer när du bildar cachenyckeln.

CustomHttpsConfiguration

Objekt

Https-inställningar för en domän

Name	Typ	Description
certificateSource	FrontDoorCertificateSource	Definierar källan för SSL-certifikatet
frontDoorCertificateSourceParameters.certificateType	FrontDoorCertificateType	Definierar vilken typ av certifikat som används för säkra anslutningar till en klientdelSlutpunkt
keyVaultCertificateSourceParameters.secretName	string	Namnet på Key Vault-hemligheten som representerar det fullständiga certifikatet PFX
keyVaultCertificateSourceParameters.secretVersion	string	Versionen av Key Vault-hemligheten som representerar det fullständiga certifikatet PFX
keyVaultCertificateSourceParameters.vault	Vault	Nyckelvalvet som innehåller SSL-certifikatet
minimumTlsVersion	MinimumTLSVersion	Den lägsta TLS-version som krävs från klienterna för att upprätta en SSL-handskakning med Front Door.
protocolType	FrontDoorTlsProtocolType	Definierar TLS-tilläggsprotokollet som används för säker leverans

CustomHttpsProvisioningState

Uppräkning

Etableringsstatus för anpassade https för klientdelenEndpoint.

Värde	Description
Disabled
Disabling
Enabled
Enabling
Failed

CustomHttpsProvisioningSubstate

Uppräkning

Etableringsundertillstånd visar förloppet för den anpassade HTTPS-aktiverings-/inaktiveringsprocessen steg för steg.

Värde	Description
CertificateDeleted
CertificateDeployed
DeletingCertificate
DeployingCertificate
DomainControlValidationRequestApproved
DomainControlValidationRequestRejected
DomainControlValidationRequestTimedOut
IssuingCertificate
PendingDomainControlValidationREquestApproval
SubmittingDomainControlValidationRequest

DynamicCompressionEnabled

Uppräkning

Om dynamisk komprimering ska användas för cachelagrat innehåll

Värde	Description
Disabled
Enabled

enforceCertificateNameCheckEnabledState

Uppräkning

Om certifikatnamnskontroll ska tillämpas på HTTPS-begäranden till alla serverdelspooler. Ingen effekt på icke-HTTPS-begäranden.

Värde	Description
Disabled
Enabled

ErrorResponse

Objekt

Felsvaret anger att Front Door-tjänsten inte kan bearbeta den inkommande begäran. Orsaken anges i felmeddelandet.

Name	Typ	Description
code	string	Felkod.
message	string	Felmeddelande som anger varför åtgärden misslyckades.

ForwardingConfiguration

Objekt

Beskriver vidarebefordran av väg.

Name	Typ	Description
@odata.type	string: #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration
backendPool	SubResource	En referens till backendPool som den här regeln dirigerar till.
cacheConfiguration	CacheConfiguration	Cachelagringskonfigurationen som är associerad med den här regeln.
customForwardingPath	string	En anpassad sökväg som används för att skriva om resurssökvägar som matchas av den här regeln. Låt vara tom om du vill använda inkommande sökväg.
forwardingProtocol	FrontDoorForwardingProtocol	Protokoll som den här regeln använder vid vidarebefordran av trafik till serverdelar.

FrontDoor

Objekt

Front Door representerar en samling serverdelsslutpunkter för att dirigera trafik till tillsammans med regler som anger hur trafik skickas dit.

Name	Typ	Description
id	string	Resurs-ID.
location	string	Resursplats.
name	string	Resursnamn.
properties.backendPools	BackendPool[]	Serverdelspooler som är tillgängliga för routningsregler.
properties.backendPoolsSettings	BackendPoolsSettings	Inställningar för alla serverdelspooler
properties.cname	string	Den värd som varje klientdelEndpoint måste CNAME till.
properties.enabledState	FrontDoorEnabledState	Driftstatus för Front Door-lastbalanseraren. Tillåtna värden är "Aktiverade" eller "Inaktiverade"
properties.friendlyName	string	Ett eget namn för frontDoor
properties.frontendEndpoints	FrontendEndpoint[]	Klientdelsslutpunkter som är tillgängliga för routningsregler.
properties.healthProbeSettings	HealthProbeSettingsModel[]	Inställningar för hälsoavsökning som är associerade med den här Front Door-instansen.
properties.loadBalancingSettings	LoadBalancingSettingsModel[]	Belastningsutjämningsinställningar som är associerade med den här Front Door-instansen.
properties.provisioningState	string	Etableringstillstånd för Front Door.
properties.resourceState	FrontDoorResourceState	Resursstatus för Front Door eller Front Door SubResource. Resursstatus för Front Door.
properties.routingRules	RoutingRule[]	Routningsregler som är associerade med denna Front Door.
tags	object	Resurstaggar.
type	string	Resurstyp.

FrontDoorCertificateSource

Uppräkning

Definierar källan för SSL-certifikatet

Värde	Description
AzureKeyVault
FrontDoor

FrontDoorCertificateType

Uppräkning

Definierar vilken typ av certifikat som används för säkra anslutningar till en klientdelSlutpunkt

Värde	Description
Dedicated

FrontDoorEnabledState

Uppräkning

Driftstatus för Front Door-lastbalanseraren. Tillåtna värden är "Aktiverade" eller "Inaktiverade"

Värde	Description
Disabled
Enabled

FrontDoorForwardingProtocol

Uppräkning

Protokoll som den här regeln använder vid vidarebefordran av trafik till serverdelar.

Värde	Description
HttpOnly
HttpsOnly
MatchRequest

FrontDoorHealthProbeMethod

Uppräkning

Konfigurerar vilken HTTP-metod som ska användas för att avsöka de serverdelar som definierats under backendPools.

Värde	Description
GET
HEAD

FrontDoorProtocol

Uppräkning

Protokollscheman som matchar för den här regeln

Värde	Description
Http
Https

FrontDoorQuery

Uppräkning

Behandling av URL-frågetermer när du bildar cachenyckeln.

Värde	Description
StripAll
StripNone

FrontDoorRedirectProtocol

Uppräkning

Protokollet för målet till där trafiken omdirigeras

Värde	Description
HttpOnly
HttpsOnly
MatchRequest

FrontDoorRedirectType

Uppräkning

Omdirigeringstypen som regeln ska använda vid omdirigering av trafik.

Värde	Description
Found
Moved
PermanentRedirect
TemporaryRedirect

FrontDoorResourceState

Uppräkning

Resursstatus för Front Door eller Front Door SubResource.

Värde	Description
Creating
Deleting
Disabled
Disabling
Enabled
Enabling

FrontDoorTlsProtocolType

Uppräkning

Definierar TLS-tilläggsprotokollet som används för säker leverans

Värde	Description
ServerNameIndication

FrontendEndpoint

Objekt

En klientdelsslutpunkt som används för routning.

Name	Typ	Description
id	string	Resurs-ID.
name	string	Resursnamn.
properties.customHttpsConfiguration	CustomHttpsConfiguration	Konfigurationen som anger hur HTTPS ska aktiveras
properties.customHttpsProvisioningState	CustomHttpsProvisioningState	Etableringsstatus för anpassade https för klientdelenEndpoint.
properties.customHttpsProvisioningSubstate	CustomHttpsProvisioningSubstate	Etableringsundertillstånd visar förloppet för den anpassade HTTPS-aktiverings-/inaktiveringsprocessen steg för steg.
properties.hostName	string	Värdnamnet för klientdelenEndpoint. Måste vara ett domännamn.
properties.resourceState	FrontDoorResourceState	Resursstatus för Front Door eller Front Door SubResource. Resursstatus.
properties.sessionAffinityEnabledState	SessionAffinityEnabledState	Om du vill tillåta sessionstillhörighet på den här värden. Giltiga alternativ är "Aktiverade" eller "Inaktiverade"
properties.sessionAffinityTtlSeconds	integer	OANVÄND. Det här fältet ignoreras. Den TTL som ska användas i sekunder för sessionstillhörighet, om tillämpligt.
properties.webApplicationFirewallPolicyLink	WebApplicationFirewallPolicyLink	Definierar brandväggsprincipen för webbprogram för varje värd (om tillämpligt)
type	string	Resurstyp.

HealthProbeEnabled

Uppräkning

Om du vill aktivera hälsoavsökningar mot serverdelar som definierats under backendPools. Hälsoavsökningar kan bara inaktiveras om det finns en enda aktiverad serverdel i en enda aktiverad serverdelspool.

Värde	Description
Disabled
Enabled

HealthProbeSettingsModel

Objekt

Belastningsutjämningsinställningar för en serverdelspool

Name	Typ	Standardvärde	Description
id	string		Resurs-ID.
name	string		Resursnamn.
properties.enabledState	HealthProbeEnabled		Om du vill aktivera hälsoavsökningar mot serverdelar som definierats under backendPools. Hälsoavsökningar kan bara inaktiveras om det finns en enda aktiverad serverdel i en enda aktiverad serverdelspool.
properties.healthProbeMethod	FrontDoorHealthProbeMethod	HEAD	Konfigurerar vilken HTTP-metod som ska användas för att avsöka de serverdelar som definierats under backendPools.
properties.intervalInSeconds	integer		Antalet sekunder mellan hälsoavsökningar.
properties.path	string		Sökvägen som ska användas för hälsoavsökningen. Standardvärdet är/
properties.protocol	FrontDoorProtocol		Protokollschema som ska användas för den här avsökningen
properties.resourceState	FrontDoorResourceState		Resursstatus för Front Door eller Front Door SubResource. Resursstatus.
type	string		Resurstyp.

LoadBalancingSettingsModel

Objekt

Belastningsutjämningsinställningar för en serverdelspool

Name	Typ	Description
id	string	Resurs-ID.
name	string	Resursnamn.
properties.additionalLatencyMilliseconds	integer	Den ytterligare svarstiden i millisekunder för att avsökningar ska hamna i bucketen med lägsta svarstid
properties.resourceState	FrontDoorResourceState	Resursstatus för Front Door eller Front Door SubResource. Resursstatus.
properties.sampleSize	integer	Antalet exempel att överväga för beslut om belastningsutjämning
properties.successfulSamplesRequired	integer	Antalet exempel inom exempelperioden som måste lyckas
type	string	Resurstyp.

MinimumTLSVersion

Uppräkning

Den lägsta TLS-version som krävs från klienterna för att upprätta en SSL-handskakning med Front Door.

Värde	Description
1.0
1.2

RedirectConfiguration

Objekt

Beskriver omdirigeringsvägen.

Name	Typ	Description
@odata.type	string: #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration
customFragment	string	Fragment som ska läggas till i omdirigerings-URL:en. Fragment är den del av URL:en som kommer efter #. Ta inte med #.
customHost	string	Värd för omdirigering. Låt vara tom om du vill använda den inkommande värden som målvärd.
customPath	string	Den fullständiga sökvägen till omdirigering. Sökvägen får inte vara tom och måste börja med /. Lämna tom om du vill använda den inkommande sökvägen som målsökväg.
customQueryString	string	Den uppsättning frågesträngar som ska placeras i omdirigerings-URL:en. Om du anger det här värdet ersätts alla befintliga frågesträngar. lämna tom för att bevara den inkommande frågesträngen. Frågesträngen måste vara i = format. Den första? och & läggs till automatiskt så ta inte med dem i fronten, men separera flera frågesträngar med &.
redirectProtocol	FrontDoorRedirectProtocol	Protokollet för målet till där trafiken omdirigeras
redirectType	FrontDoorRedirectType	Omdirigeringstypen som regeln ska använda vid omdirigering av trafik.

RoutingRule

Objekt

En routningsregel representerar en specifikation för trafik att behandla och var den ska skickas, tillsammans med hälsoavsökningsinformation.

Name	Typ	Description
id	string	Resurs-ID.
name	string	Resursnamn.
properties.acceptedProtocols	FrontDoorProtocol[]	Protokollscheman som matchar för den här regeln
properties.enabledState	routingRuleEnabledState	Om du vill aktivera användning av den här regeln. Tillåtna värden är "Aktiverade" eller "Inaktiverade"
properties.frontendEndpoints	SubResource[]	Klientdelsslutpunkter som är associerade med den här regeln
properties.patternsToMatch	string[]	Regelns vägmönster.
properties.resourceState	FrontDoorResourceState	Resursstatus för Front Door eller Front Door SubResource. Resursstatus.
properties.routeConfiguration	RouteConfiguration: ForwardingConfiguration RedirectConfiguration	En referens till routningskonfigurationen.
type	string	Resurstyp.

routingRuleEnabledState

Uppräkning

Om du vill aktivera användning av den här regeln. Tillåtna värden är "Aktiverade" eller "Inaktiverade"

Värde	Description
Disabled
Enabled

SessionAffinityEnabledState

Uppräkning

Om du vill tillåta sessionstillhörighet på den här värden. Giltiga alternativ är "Aktiverade" eller "Inaktiverade"

Värde	Description
Disabled
Enabled

SubResource

Objekt

Referens till en annan underresurs.

Name	Typ	Description
id	string	Resurs-ID.

Vault

Objekt

Nyckelvalvet som innehåller SSL-certifikatet

Name	Typ	Description
id	string	Resurs-ID.

WebApplicationFirewallPolicyLink

Objekt

Definierar brandväggsprincipen för webbprogram för varje värd (om tillämpligt)

Name	Typ	Description
id	string	Resurs-ID.

Dela via

Front Doors - Create Or Update

URI-parametrar

Begärandetext

Svar

Säkerhet

azure_auth

Omfattningar

Exempel

Create or update specific Front Door

Exempelbegäran

Exempelsvar

Definitioner

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

Ytterligare resurser