Front Doors - Create Or Update

Odwołanie

Usługa:: Front Door Service

Wersja interfejsu API:: 2019-05-01

Tworzy nową usługę Front Door z nazwą usługi Front Door w ramach określonej subskrypcji i grupy zasobów.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
frontDoorName	path	True	string	Nazwa usługi Front Door, która jest globalnie unikatowa. Wzorzec wyrażenia regularnego: `^[a-zA-Z0-9]+([-a-zA-Z0-9]?[a-zA-Z0-9])*$`
resourceGroupName	path	True	string	Nazwa grupy zasobów w ramach subskrypcji platformy Azure. Wzorzec wyrażenia regularnego: `^[a-zA-Z0-9_\-\.]*[^\.]$`
subscriptionId	path	True	string	Poświadczenia subskrypcji, które jednoznacznie identyfikują subskrypcję platformy Microsoft Azure. Identyfikator subskrypcji stanowi część identyfikatora URI dla każdego wywołania usługi.
api-version	query	True	string	Wersja interfejsu API klienta.

Treść żądania

Nazwa	Typ	Opis
location	string	Lokalizacja zasobu.
properties.backendPools	BackendPool[]	Pule zaplecza dostępne dla reguł routingu.
properties.backendPoolsSettings	BackendPoolsSettings	Ustawienia dla wszystkich puli zaplecza
properties.enabledState	FrontDoorEnabledState	Stan operacyjny modułu równoważenia obciążenia usługi Front Door. Dozwolone wartości to "Włączone" lub "Wyłączone"
properties.friendlyName	string	Przyjazna nazwa frontDoor
properties.frontendEndpoints	FrontendEndpoint[]	Punkty końcowe frontonu dostępne dla reguł routingu.
properties.healthProbeSettings	HealthProbeSettingsModel[]	Ustawienia sondy kondycji skojarzone z tym wystąpieniem usługi Front Door.
properties.loadBalancingSettings	LoadBalancingSettingsModel[]	Ustawienia równoważenia obciążenia skojarzone z tym wystąpieniem usługi Front Door.
properties.routingRules	RoutingRule[]	Reguły routingu skojarzone z tą usługą Front Door.
tags	object	Tagi zasobów.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	FrontDoor	OK. Żądanie zakończyło się pomyślnie.
201 Created	FrontDoor	Utworzone. Żądanie zostało spełnione i utworzono nową usługę Front Door.
202 Accepted	FrontDoor	Akceptowane. Żądanie zostało zaakceptowane do przetwarzania, a operacja zostanie ukończona asynchronicznie.
Other Status Codes	ErrorResponse	Odpowiedź na błąd usługi Front Door opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

Create or update specific Front Door

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:: 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"
  }
}

Kod stanu:: 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"
  }
}

Kod stanu:: 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"
  }
}

Definicje

Nazwa	Opis
Backend	Adres zaplecza modułu równoważenia obciążenia frontDoor.
backendEnabledState	Czy włączyć korzystanie z tego zaplecza. Dozwolone wartości to "Włączone" lub "Wyłączone"
BackendPool	Pula zaplecza to kolekcja zaplecza, do których można kierować.
BackendPoolsSettings	Ustawienia, które mają zastosowanie do wszystkich pul zaplecza.
CacheConfiguration	Ustawienia buforowania dla trasy typu buforowania. Aby wyłączyć buforowanie, nie udostępniaj obiektu cacheConfiguration.
CustomHttpsConfiguration	Ustawienia https dla domeny
CustomHttpsProvisioningState	Stan aprowizacji niestandardowego https punktu końcowego frontonu.
CustomHttpsProvisioningSubstate	Podstan aprowizacji pokazuje postęp niestandardowego włączania/wyłączania procesu HTTPS krok po kroku.
DynamicCompressionEnabled	Czy używać kompresji dynamicznej dla buforowanej zawartości
enforceCertificateNameCheckEnabledState	Czy wymusić sprawdzanie nazwy certyfikatu na żądaniach HTTPS do wszystkich pul zaplecza. Brak wpływu na żądania inne niż HTTPS.
ErrorResponse	Odpowiedź na błąd wskazuje, że usługa Front Door nie może przetworzyć żądania przychodzącego. Przyczyna jest podana w komunikacie o błędzie.
ForwardingConfiguration	Opisuje trasę przekazywania.
FrontDoor	Usługa Front Door reprezentuje kolekcję punktów końcowych zaplecza, do których kierowany jest ruch wraz z regułami określającymi sposób wysyłania ruchu.
FrontDoorCertificateSource	Definiuje źródło certyfikatu SSL
FrontDoorCertificateType	Definiuje typ certyfikatu używanego do zabezpieczania połączeń z frontonemEndpoint
FrontDoorEnabledState	Stan operacyjny modułu równoważenia obciążenia usługi Front Door. Dozwolone wartości to "Włączone" lub "Wyłączone"
FrontDoorForwardingProtocol	Protokół tej reguły będzie używany podczas przekazywania ruchu do zaplecza.
FrontDoorHealthProbeMethod	Konfiguruje metodę HTTP używaną do sondowania zaplecza zdefiniowanych w obszarze backendPools.
FrontDoorProtocol	Schematy protokołów zgodne z tą regułą
FrontDoorQuery	Traktowanie terminów zapytania adresu URL podczas tworzenia klucza pamięci podręcznej.
FrontDoorRedirectProtocol	Protokół miejsca docelowego, do którego jest przekierowywany ruch
FrontDoorRedirectType	Typ przekierowania, który będzie używany podczas przekierowywania ruchu.
FrontDoorResourceState	Stan zasobu usługi Front Door lub usługi Front Door SubResource.
FrontDoorTlsProtocolType	Definiuje protokół rozszerzenia TLS używany do bezpiecznego dostarczania
FrontendEndpoint	Punkt końcowy frontonu używany do routingu.
HealthProbeEnabled	Czy włączyć sondy kondycji do tworzenia względem zaplecza zdefiniowanych w ramach puli zaplecza. Sondy kondycji można wyłączyć tylko wtedy, gdy w puli zaplecza z obsługą pojedynczego zaplecza jest włączona pojedyncza.
HealthProbeSettingsModel	Ustawienia równoważenia obciążenia dla puli zaplecza
LoadBalancingSettingsModel	Ustawienia równoważenia obciążenia dla puli zaplecza
MinimumTLSVersion	Minimalna wersja protokołu TLS wymagana od klientów do ustanowienia uzgadniania SSL z usługą Front Door.
RedirectConfiguration	Opisuje trasę przekierowania.
RoutingRule	Reguła routingu reprezentuje specyfikację ruchu, który ma być traktowany i gdzie go wysyłać, wraz z informacjami o sondie kondycji.
routingRuleEnabledState	Czy włączyć korzystanie z tej reguły. Dozwolone wartości to "Włączone" lub "Wyłączone"
SessionAffinityEnabledState	Czy zezwolić na koligację sesji na tym hoście. Prawidłowe opcje to "Włączone" lub "Wyłączone"
SubResource	Odwołanie do innego podźródła.
Vault	Key Vault zawierający certyfikat SSL
WebApplicationFirewallPolicyLink	Definiuje zasady Web Application Firewall dla każdego hosta (jeśli dotyczy)

Backend

Adres zaplecza modułu równoważenia obciążenia frontDoor.

Nazwa	Typ	Opis
address	string	Lokalizacja zaplecza (adres IP lub nazwa FQDN)
backendHostHeader	string	Wartość do użycia jako nagłówek hosta wysłany do zaplecza. Jeśli jest to puste lub nieokreślone, domyślnie jest to host przychodzący.
enabledState	backendEnabledState	Czy włączyć korzystanie z tego zaplecza. Dozwolone wartości to "Włączone" lub "Wyłączone"
httpPort	integer	Numer portu TCP PROTOKOŁU HTTP. Musi należeć do zakresu od 1 do 65535.
httpsPort	integer	Numer portu TCP PROTOKOŁU HTTPS. Musi należeć do zakresu od 1 do 65535.
priority	integer	Priorytet używany do równoważenia obciążenia. Wyższe priorytety nie będą używane do równoważenia obciążenia, jeśli zaplecze o niższym priorytcie jest w dobrej kondycji.
weight	integer	Waga tego punktu końcowego na potrzeby równoważenia obciążenia.

backendEnabledState

Czy włączyć korzystanie z tego zaplecza. Dozwolone wartości to "Włączone" lub "Wyłączone"

Nazwa	Typ	Opis
Disabled	string
Enabled	string

BackendPool

Pula zaplecza to kolekcja zaplecza, do których można kierować.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
name	string	Nazwa zasobu.
properties.backends	Backend[]	Zestaw zapleczy dla tej puli
properties.healthProbeSettings	SubResource	Ustawienia sondy kondycji L7 dla puli zaplecza
properties.loadBalancingSettings	SubResource	Ustawienia równoważenia obciążenia dla puli zaplecza
properties.resourceState	FrontDoorResourceState	Stan zasobu usługi Front Door lub usługi Front Door SubResource. Stan zasobu.
type	string	Typ zasobu.

BackendPoolsSettings

Ustawienia, które mają zastosowanie do wszystkich pul zaplecza.

Nazwa	Typ	Domyślna wartość	Opis
enforceCertificateNameCheck	enforceCertificateNameCheckEnabledState	Enabled	Czy wymusić sprawdzanie nazwy certyfikatu na żądaniach HTTPS do wszystkich pul zaplecza. Brak wpływu na żądania inne niż HTTPS.
sendRecvTimeoutSeconds	integer		Wysyłanie i odbieranie limitu czasu żądania przesyłania dalej do zaplecza. Po osiągnięciu limitu czasu żądanie kończy się niepowodzeniem i zwraca.

CacheConfiguration

Ustawienia buforowania dla trasy typu buforowania. Aby wyłączyć buforowanie, nie udostępniaj obiektu cacheConfiguration.

Nazwa	Typ	Opis
dynamicCompression	DynamicCompressionEnabled	Czy używać kompresji dynamicznej dla buforowanej zawartości
queryParameterStripDirective	FrontDoorQuery	Traktowanie terminów zapytania adresu URL podczas tworzenia klucza pamięci podręcznej.

CustomHttpsConfiguration

Ustawienia https dla domeny

Nazwa	Typ	Opis
certificateSource	FrontDoorCertificateSource	Definiuje źródło certyfikatu SSL
frontDoorCertificateSourceParameters.certificateType	FrontDoorCertificateType	Definiuje typ certyfikatu używanego do zabezpieczania połączeń z frontonemEndpoint
keyVaultCertificateSourceParameters.secretName	string	Nazwa wpisu tajnego Key Vault reprezentująca pełny certyfikat PFX
keyVaultCertificateSourceParameters.secretVersion	string	Wersja wpisu tajnego Key Vault reprezentująca pełny certyfikat PFX
keyVaultCertificateSourceParameters.vault	Vault	Key Vault zawierający certyfikat SSL
minimumTlsVersion	MinimumTLSVersion	Minimalna wersja protokołu TLS wymagana od klientów do ustanowienia uzgadniania SSL z usługą Front Door.
protocolType	FrontDoorTlsProtocolType	Definiuje protokół rozszerzenia TLS używany do bezpiecznego dostarczania

CustomHttpsProvisioningState

Stan aprowizacji niestandardowego https punktu końcowego frontonu.

Nazwa	Typ	Opis
Disabled	string
Disabling	string
Enabled	string
Enabling	string
Failed	string

CustomHttpsProvisioningSubstate

Podstan aprowizacji pokazuje postęp niestandardowego włączania/wyłączania procesu HTTPS krok po kroku.

Nazwa	Typ	Opis
CertificateDeleted	string
CertificateDeployed	string
DeletingCertificate	string
DeployingCertificate	string
DomainControlValidationRequestApproved	string
DomainControlValidationRequestRejected	string
DomainControlValidationRequestTimedOut	string
IssuingCertificate	string
PendingDomainControlValidationREquestApproval	string
SubmittingDomainControlValidationRequest	string

DynamicCompressionEnabled

Czy używać kompresji dynamicznej dla buforowanej zawartości

Nazwa	Typ	Opis
Disabled	string
Enabled	string

enforceCertificateNameCheckEnabledState

Czy wymusić sprawdzanie nazwy certyfikatu na żądaniach HTTPS do wszystkich pul zaplecza. Brak wpływu na żądania inne niż HTTPS.

Nazwa	Typ	Opis
Disabled	string
Enabled	string

ErrorResponse

Odpowiedź na błąd wskazuje, że usługa Front Door nie może przetworzyć żądania przychodzącego. Przyczyna jest podana w komunikacie o błędzie.

Nazwa	Typ	Opis
code	string	Kod błędu.
message	string	Komunikat o błędzie wskazujący, dlaczego operacja nie powiodła się.

ForwardingConfiguration

Opisuje trasę przekazywania.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration
backendPool	SubResource	Odwołanie do puli zaplecza, do której ta reguła kieruje.
cacheConfiguration	CacheConfiguration	Konfiguracja buforowania skojarzona z tą regułą.
customForwardingPath	string	Ścieżka niestandardowa używana do ponownego zapisywania ścieżek zasobów pasowanych przez tę regułę. Pozostaw wartość pustą, aby użyć ścieżki przychodzącej.
forwardingProtocol	FrontDoorForwardingProtocol	Protokół tej reguły będzie używany podczas przekazywania ruchu do zaplecza.

FrontDoor

Usługa Front Door reprezentuje kolekcję punktów końcowych zaplecza, do których kierowany jest ruch wraz z regułami określającymi sposób wysyłania ruchu.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
location	string	Lokalizacja zasobu.
name	string	Nazwa zasobu.
properties.backendPools	BackendPool[]	Pule zaplecza dostępne dla reguł routingu.
properties.backendPoolsSettings	BackendPoolsSettings	Ustawienia dla wszystkich puli zaplecza
properties.cname	string	Host, do którego każdy punkt frontonEndpoint musi mieć wartość CNAME.
properties.enabledState	FrontDoorEnabledState	Stan operacyjny modułu równoważenia obciążenia usługi Front Door. Dozwolone wartości to "Włączone" lub "Wyłączone"
properties.friendlyName	string	Przyjazna nazwa frontDoor
properties.frontendEndpoints	FrontendEndpoint[]	Punkty końcowe frontonu dostępne dla reguł routingu.
properties.healthProbeSettings	HealthProbeSettingsModel[]	Ustawienia sondy kondycji skojarzone z tym wystąpieniem usługi Front Door.
properties.loadBalancingSettings	LoadBalancingSettingsModel[]	Ustawienia równoważenia obciążenia skojarzone z tym wystąpieniem usługi Front Door.
properties.provisioningState	string	Stan aprowizacji usługi Front Door.
properties.resourceState	FrontDoorResourceState	Stan zasobu usługi Front Door lub usługi Front Door SubResource. Stan zasobu usługi Front Door.
properties.routingRules	RoutingRule[]	Reguły routingu skojarzone z tą usługą Front Door.
tags	object	Tagi zasobów.
type	string	Typ zasobu.

FrontDoorCertificateSource

Definiuje źródło certyfikatu SSL

Nazwa	Typ	Opis
AzureKeyVault	string
FrontDoor	string

FrontDoorCertificateType

Definiuje typ certyfikatu używanego do zabezpieczania połączeń z frontonemEndpoint

Nazwa	Typ	Opis
Dedicated	string

FrontDoorEnabledState

Stan operacyjny modułu równoważenia obciążenia usługi Front Door. Dozwolone wartości to "Włączone" lub "Wyłączone"

Nazwa	Typ	Opis
Disabled	string
Enabled	string

FrontDoorForwardingProtocol

Protokół tej reguły będzie używany podczas przekazywania ruchu do zaplecza.

Nazwa	Typ	Opis
HttpOnly	string
HttpsOnly	string
MatchRequest	string

FrontDoorHealthProbeMethod

Konfiguruje metodę HTTP używaną do sondowania zaplecza zdefiniowanych w obszarze backendPools.

Nazwa	Typ	Opis
GET	string
HEAD	string

FrontDoorProtocol

Schematy protokołów zgodne z tą regułą

Nazwa	Typ	Opis
Http	string
Https	string

FrontDoorQuery

Traktowanie terminów zapytania adresu URL podczas tworzenia klucza pamięci podręcznej.

Nazwa	Typ	Opis
StripAll	string
StripNone	string

FrontDoorRedirectProtocol

Protokół miejsca docelowego, do którego jest przekierowywany ruch

Nazwa	Typ	Opis
HttpOnly	string
HttpsOnly	string
MatchRequest	string

FrontDoorRedirectType

Typ przekierowania, który będzie używany podczas przekierowywania ruchu.

Nazwa	Typ	Opis
Found	string
Moved	string
PermanentRedirect	string
TemporaryRedirect	string

FrontDoorResourceState

Stan zasobu usługi Front Door lub usługi Front Door SubResource.

Nazwa	Typ	Opis
Creating	string
Deleting	string
Disabled	string
Disabling	string
Enabled	string
Enabling	string

FrontDoorTlsProtocolType

Definiuje protokół rozszerzenia TLS używany do bezpiecznego dostarczania

Nazwa	Typ	Opis
ServerNameIndication	string

FrontendEndpoint

Punkt końcowy frontonu używany do routingu.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
name	string	Nazwa zasobu.
properties.customHttpsConfiguration	CustomHttpsConfiguration	Konfiguracja określająca sposób włączania protokołu HTTPS
properties.customHttpsProvisioningState	CustomHttpsProvisioningState	Stan aprowizacji niestandardowego https punktu końcowego frontonu.
properties.customHttpsProvisioningSubstate	CustomHttpsProvisioningSubstate	Podstan aprowizacji pokazuje postęp niestandardowego włączania/wyłączania procesu HTTPS krok po kroku.
properties.hostName	string	Nazwa hosta frontonuEndpoint. Musi być nazwą domeny.
properties.resourceState	FrontDoorResourceState	Stan zasobu usługi Front Door lub usługi Front Door SubResource. Stan zasobu.
properties.sessionAffinityEnabledState	SessionAffinityEnabledState	Czy zezwolić na koligację sesji na tym hoście. Prawidłowe opcje to "Włączone" lub "Wyłączone"
properties.sessionAffinityTtlSeconds	integer	NIEUŻYWANE. To pole zostanie zignorowane. Czas wygaśnięcia używany w sekundach dla koligacji sesji, jeśli ma to zastosowanie.
properties.webApplicationFirewallPolicyLink	WebApplicationFirewallPolicyLink	Definiuje zasady Web Application Firewall dla każdego hosta (jeśli dotyczy)
type	string	Typ zasobu.

HealthProbeEnabled

Czy włączyć sondy kondycji do tworzenia względem zaplecza zdefiniowanych w ramach puli zaplecza. Sondy kondycji można wyłączyć tylko wtedy, gdy w puli zaplecza z obsługą pojedynczego zaplecza jest włączona pojedyncza.

Nazwa	Typ	Opis
Disabled	string
Enabled	string

HealthProbeSettingsModel

Ustawienia równoważenia obciążenia dla puli zaplecza

Nazwa	Typ	Domyślna wartość	Opis
id	string		Identyfikator zasobu.
name	string		Nazwa zasobu.
properties.enabledState	HealthProbeEnabled		Czy włączyć sondy kondycji do tworzenia względem zaplecza zdefiniowanych w ramach puli zaplecza. Sondy kondycji można wyłączyć tylko wtedy, gdy w puli zaplecza z obsługą pojedynczego zaplecza jest włączona pojedyncza.
properties.healthProbeMethod	FrontDoorHealthProbeMethod	HEAD	Konfiguruje metodę HTTP używaną do sondowania zaplecza zdefiniowanych w obszarze backendPools.
properties.intervalInSeconds	integer		Liczba sekund między sondami kondycji.
properties.path	string		Ścieżka do użycia dla sondy kondycji. Wartość domyślna to /
properties.protocol	FrontDoorProtocol		Schemat protokołu do użycia dla tej sondy
properties.resourceState	FrontDoorResourceState		Stan zasobu usługi Front Door lub usługi Front Door SubResource. Stan zasobu.
type	string		Typ zasobu.

LoadBalancingSettingsModel

Ustawienia równoważenia obciążenia dla puli zaplecza

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
name	string	Nazwa zasobu.
properties.additionalLatencyMilliseconds	integer	Dodatkowe opóźnienie w milisekundach dla sond w celu uwzględnienia najniższego opóźnienia zasobnika
properties.resourceState	FrontDoorResourceState	Stan zasobu usługi Front Door lub usługi Front Door SubResource. Stan zasobu.
properties.sampleSize	integer	Liczba przykładów, które należy wziąć pod uwagę podczas podejmowania decyzji dotyczących równoważenia obciążenia
properties.successfulSamplesRequired	integer	Liczba próbek w okresie próbnym, które muszą zakończyć się powodzeniem
type	string	Typ zasobu.

MinimumTLSVersion

Minimalna wersja protokołu TLS wymagana od klientów do ustanowienia uzgadniania SSL z usługą Front Door.

Nazwa	Typ	Opis
1.0	string
1.2	string

RedirectConfiguration

Opisuje trasę przekierowania.

Nazwa	Typ	Opis
@odata.type	string: #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration
customFragment	string	Fragment do dodania do adresu URL przekierowania. Fragment jest częścią adresu URL, który pochodzi po pliku #. Nie dołączaj pliku #.
customHost	string	Host do przekierowania. Pozostaw wartość pustą, aby użyć hosta przychodzącego jako hosta docelowego.
customPath	string	Pełna ścieżka do przekierowania. Ścieżka nie może być pusta i musi zaczynać się od /. Pozostaw wartość pustą, aby użyć ścieżki przychodzącej jako ścieżki docelowej.
customQueryString	string	Zestaw ciągów zapytania do umieszczenia w adresie URL przekierowania. Ustawienie tej wartości spowoduje zastąpienie wszystkich istniejących ciągów zapytania; pozostaw wartość pustą, aby zachować przychodzący ciąg zapytania. Ciąg zapytania musi być w formacie = . Pierwszy ? i & zostaną dodane automatycznie, więc nie dołączają ich do przodu, ale oddzielają wiele ciągów zapytania za pomocą &.
redirectProtocol	FrontDoorRedirectProtocol	Protokół miejsca docelowego, do którego jest przekierowywany ruch
redirectType	FrontDoorRedirectType	Typ przekierowania, który będzie używany podczas przekierowywania ruchu.

RoutingRule

Reguła routingu reprezentuje specyfikację ruchu, który ma być traktowany i gdzie go wysyłać, wraz z informacjami o sondie kondycji.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
name	string	Nazwa zasobu.
properties.acceptedProtocols	FrontDoorProtocol[]	Schematy protokołów zgodne z tą regułą
properties.enabledState	routingRuleEnabledState	Czy włączyć korzystanie z tej reguły. Dozwolone wartości to "Włączone" lub "Wyłączone"
properties.frontendEndpoints	SubResource[]	Punkty końcowe frontonu skojarzone z tą regułą
properties.patternsToMatch	string[]	Wzorce tras reguły.
properties.resourceState	FrontDoorResourceState	Stan zasobu usługi Front Door lub usługi Front Door SubResource. Stan zasobu.
properties.routeConfiguration	RouteConfiguration: ForwardingConfiguration RedirectConfiguration	Odwołanie do konfiguracji routingu.
type	string	Typ zasobu.

routingRuleEnabledState

Czy włączyć korzystanie z tej reguły. Dozwolone wartości to "Włączone" lub "Wyłączone"

Nazwa	Typ	Opis
Disabled	string
Enabled	string

SessionAffinityEnabledState

Czy zezwolić na koligację sesji na tym hoście. Prawidłowe opcje to "Włączone" lub "Wyłączone"

Nazwa	Typ	Opis
Disabled	string
Enabled	string

SubResource

Odwołanie do innego podźródła.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.

Vault

Key Vault zawierający certyfikat SSL

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.

WebApplicationFirewallPolicyLink

Definiuje zasady Web Application Firewall dla każdego hosta (jeśli dotyczy)

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.

Udostępnij za pośrednictwem

Front Doors - Create Or Update

Parametry identyfikatora URI

Treść żądania

Odpowiedzi

Zabezpieczenia

azure_auth

Zakresy

Przykłady

Create or update specific Front Door

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

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

Dodatkowe zasoby