Front Doors - Create Or Update

Служба:: Front Door Service

Версия API:: 2019-05-01

Создает новый Front Door с именем Front Door в указанной подписке и группе ресурсов.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
frontDoorName	path	True	string minLength: 5 maxLength: 64 pattern: ^[a-zA-Z0-9]+([-a-zA-Z0-9]?[a-zA-Z0-9])*$	Имя Front Door, которое является глобально уникальным.
resourceGroupName	path	True	string minLength: 1 maxLength: 80 pattern: ^[a-zA-Z0-9_\-\.]*[^\.]$	Имя группы ресурсов в подписке Azure.
subscriptionId	path	True	string	Учетные данные подписки, которые однозначно определяют подписку Microsoft Azure. Идентификатор подписки входит в состав URI для каждого вызова службы.
api-version	query	True	string	Версия КЛИЕНТСКОго API.

Текст запроса

Имя	Тип	Описание
location	string	Расположение ресурса.
properties.backendPools	BackendPool[]	Серверные пулы, доступные для правил маршрутизации.
properties.backendPoolsSettings	BackendPoolsSettings	Параметры для всех серверных пулов
properties.enabledState	FrontDoorEnabledState	Состояние работы подсистемы балансировки нагрузки Front Door. Допустимые значения: "Включено" или "Отключено"
properties.friendlyName	string	Понятное имя для frontDoor
properties.frontendEndpoints	FrontendEndpoint[]	Интерфейсные конечные точки, доступные для правил маршрутизации.
properties.healthProbeSettings	HealthProbeSettingsModel[]	Параметры пробы работоспособности, связанные с этим экземпляром Front Door.
properties.loadBalancingSettings	LoadBalancingSettingsModel[]	Параметры балансировки нагрузки, связанные с этим экземпляром Front Door.
properties.routingRules	RoutingRule[]	Правила маршрутизации, связанные с этой Front Door.
tags	object	Теги ресурсов.

Ответы

Имя	Тип	Описание
200 OK	FrontDoor	ХОРОШО. Запрос выполнен успешно.
201 Created	FrontDoor	Созданный. Запрос выполнен и был создан новый Front Door.
202 Accepted	FrontDoor	Принято. Запрос был принят для обработки, и операция завершится асинхронно.
Other Status Codes	ErrorResponse	Ответ об ошибке Front Door, описывающий причину сбоя операции.

Безопасность

azure_auth

Поток OAuth2 Azure Active Directory

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

Create or update specific Front Door

Образец запроса

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

Пример ответа

Код состояния:: 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"
  }
}

Код состояния:: 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"
  }
}

Код состояния:: 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"
  }
}

Определения

Имя	Описание
Backend	Внутренний адрес подсистемы балансировки нагрузки frontDoor.
backendEnabledState	Следует ли включить использование этой серверной части. Допустимые значения: "Включено" или "Отключено"
BackendPool	Серверный пул — это коллекция внутренних серверных компонентов, на которые можно направлять.
BackendPoolsSettings	Параметры, которые применяются ко всем серверным пулам.
CacheConfiguration	Параметры кэширования для маршрута типа кэширования. Чтобы отключить кэширование, не укажите объект cacheConfiguration.
CustomHttpsConfiguration	Параметры https для домена
CustomHttpsProvisioningState	Состояние подготовки настраиваемых https внешнего интерфейса.
CustomHttpsProvisioningSubstate	Подсостояние подготовки показывает ход выполнения пользовательского процесса включения и отключения HTTPS пошаговые шаги.
DynamicCompressionEnabled	Использование динамического сжатия для кэшированного содержимого
enforceCertificateNameCheckEnabledState	Следует ли применять проверку имени сертификата на HTTPS-запросы ко всем внутренним пулам. Не влияет на запросы, отличные от HTTPS.
ErrorResponse	Ответ на ошибку указывает, что служба Front Door не может обработать входящий запрос. Причина указана в сообщении об ошибке.
ForwardingConfiguration	Описание маршрута пересылки.
FrontDoor	Front Door представляет коллекцию внутренних конечных точек для маршрутизации трафика вместе с правилами, определяющими способ отправки трафика.
FrontDoorCertificateSource	Определяет источник SSL-сертификата
FrontDoorCertificateType	Определяет тип сертификата, используемого для безопасных подключений к интерфейснойEndpoint.
FrontDoorEnabledState	Состояние работы подсистемы балансировки нагрузки Front Door. Допустимые значения: "Включено" или "Отключено"
FrontDoorForwardingProtocol	Протокол, используемый этим правилом при переадресации трафика в серверные части.
FrontDoorHealthProbeMethod	Настраивает метод HTTP, используемый для проверки внутренних серверных компонентов, определенных в серверной части.
FrontDoorProtocol	Схемы протокола, соответствующие этому правилу
FrontDoorQuery	Обработка терминов URL-запросов при формировании ключа кэша.
FrontDoorRedirectProtocol	Протокол назначения, в который перенаправляется трафик
FrontDoorRedirectType	Тип перенаправления, используемый правилом при перенаправлении трафика.
FrontDoorResourceState	Состояние ресурса Front Door или Front Door SubResource.
FrontDoorTlsProtocolType	Определяет протокол расширения TLS, используемый для безопасной доставки
FrontendEndpoint	Интерфейсная конечная точка, используемая для маршрутизации.
HealthProbeEnabled	Следует ли включить пробы работоспособности для серверных серверных служб, определенных в серверной части. Пробы работоспособности могут быть отключены только в том случае, если в одном серверном пуле включена одна включенная серверная часть.
HealthProbeSettingsModel	Параметры балансировки нагрузки для внутреннего пула
LoadBalancingSettingsModel	Параметры балансировки нагрузки для внутреннего пула
MinimumTLSVersion	Минимальная версия TLS, требуемая от клиентов для установления подтверждения SSL с Front Door.
RedirectConfiguration	Описание маршрута перенаправления.
RoutingRule	Правило маршрутизации представляет спецификацию для обработки и отправки трафика, а также сведений о пробе работоспособности.
routingRuleEnabledState	Следует ли включить использование этого правила. Допустимые значения: "Включено" или "Отключено"
SessionAffinityEnabledState	Следует ли разрешать сходство сеансов на этом узле. Допустимые параметры: "Включено" или "Отключено"
SubResource	Ссылка на другой подресурс.
Vault	Хранилище ключей, содержащее SSL-сертификат
WebApplicationFirewallPolicyLink	Определяет политику брандмауэра веб-приложения для каждого узла (если применимо)

Backend

Object

Внутренний адрес подсистемы балансировки нагрузки frontDoor.

Имя	Тип	Описание
address	string	Расположение серверной части (IP-адрес или полное доменное имя)
backendHostHeader	string	Значение, используемое в качестве заголовка узла, отправленного серверной части. Если пустое или не указано, это по умолчанию используется для входящего узла.
enabledState	backendEnabledState	Следует ли включить использование этой серверной части. Допустимые значения: "Включено" или "Отключено"
httpPort	integer minimum: 1 maximum: 65535 exclusiveMinimum: False exclusiveMaximum: False	Номер TCP-порта HTTP. Должно быть от 1 до 65535.
httpsPort	integer minimum: 1 maximum: 65535 exclusiveMinimum: False exclusiveMaximum: False	Номер TCP-порта HTTPS. Должно быть от 1 до 65535.
priority	integer minimum: 1 maximum: 5	Приоритет использования для балансировки нагрузки. Более высокие приоритеты не будут использоваться для балансировки нагрузки, если какая-либо серверная часть с более низким приоритетом работоспособна.
weight	integer minimum: 1 maximum: 1000	Вес этой конечной точки для балансировки нагрузки.

backendEnabledState

Перечисление

Следует ли включить использование этой серверной части. Допустимые значения: "Включено" или "Отключено"

Значение	Описание
Enabled
Disabled

BackendPool

Object

Серверный пул — это коллекция внутренних серверных компонентов, на которые можно направлять.

Имя	Тип	Описание
id	string	Идентификатор ресурса.
name	string	Имя ресурса.
properties.backends	Backend[]	Набор серверных компонентов для этого пула
properties.healthProbeSettings	SubResource	Параметры пробы работоспособности L7 для внутреннего пула
properties.loadBalancingSettings	SubResource	Параметры балансировки нагрузки для внутреннего пула
properties.resourceState	FrontDoorResourceState	Состояние ресурса Front Door или Front Door SubResource. Состояние ресурса.
type	string	Тип ресурса.

BackendPoolsSettings

Object

Параметры, которые применяются ко всем серверным пулам.

Имя	Тип	Default value	Описание
enforceCertificateNameCheck	enforceCertificateNameCheckEnabledState	Enabled	Следует ли применять проверку имени сертификата на HTTPS-запросы ко всем внутренним пулам. Не влияет на запросы, отличные от HTTPS.
sendRecvTimeoutSeconds	integer minimum: 16 exclusiveMinimum: False		Отправка и получение времени ожидания при переадресации запроса на серверную часть. По достижении времени ожидания запрос завершается ошибкой и возвращается.

CacheConfiguration

Object

Параметры кэширования для маршрута типа кэширования. Чтобы отключить кэширование, не укажите объект cacheConfiguration.

Имя	Тип	Описание
dynamicCompression	DynamicCompressionEnabled	Использование динамического сжатия для кэшированного содержимого
queryParameterStripDirective	FrontDoorQuery	Обработка терминов URL-запросов при формировании ключа кэша.

CustomHttpsConfiguration

Object

Параметры https для домена

Имя	Тип	Описание
certificateSource	FrontDoorCertificateSource	Определяет источник SSL-сертификата
frontDoorCertificateSourceParameters.certificateType	FrontDoorCertificateType	Определяет тип сертификата, используемого для безопасных подключений к интерфейснойEndpoint.
keyVaultCertificateSourceParameters.secretName	string	Имя секрета Key Vault, представляющего полный сертификат PFX
keyVaultCertificateSourceParameters.secretVersion	string	Версия секрета Key Vault, представляющая полный сертификат PFX
keyVaultCertificateSourceParameters.vault	Vault	Хранилище ключей, содержащее SSL-сертификат
minimumTlsVersion	MinimumTLSVersion	Минимальная версия TLS, требуемая от клиентов для установления подтверждения SSL с Front Door.
protocolType	FrontDoorTlsProtocolType	Определяет протокол расширения TLS, используемый для безопасной доставки

CustomHttpsProvisioningState

Перечисление

Состояние подготовки настраиваемых https внешнего интерфейса.

Значение	Описание
Enabling
Enabled
Disabling
Disabled
Failed

CustomHttpsProvisioningSubstate

Перечисление

Подсостояние подготовки показывает ход выполнения пользовательского процесса включения и отключения HTTPS пошаговые шаги.

Значение	Описание
SubmittingDomainControlValidationRequest
PendingDomainControlValidationREquestApproval
DomainControlValidationRequestApproved
DomainControlValidationRequestRejected
DomainControlValidationRequestTimedOut
IssuingCertificate
DeployingCertificate
CertificateDeployed
DeletingCertificate
CertificateDeleted

DynamicCompressionEnabled

Перечисление

Использование динамического сжатия для кэшированного содержимого

Значение	Описание
Enabled
Disabled

enforceCertificateNameCheckEnabledState

Перечисление

Следует ли применять проверку имени сертификата на HTTPS-запросы ко всем внутренним пулам. Не влияет на запросы, отличные от HTTPS.

Значение	Описание
Enabled
Disabled

ErrorResponse

Object

Ответ на ошибку указывает, что служба Front Door не может обработать входящий запрос. Причина указана в сообщении об ошибке.

Имя	Тип	Описание
code	string	Код ошибки.
message	string	Сообщение об ошибке, указывающее, почему операция завершилась ошибкой.

ForwardingConfiguration

Object

Описание маршрута пересылки.

Имя	Тип	Описание
@odata.type	string: #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration
backendPool	SubResource	Ссылка на BackendPool, к которой направляется это правило.
cacheConfiguration	CacheConfiguration	Конфигурация кэширования, связанная с этим правилом.
customForwardingPath	string	Пользовательский путь, используемый для перезаписи путей ресурсов, соответствующих этому правилу. Оставьте пустым путь для использования входящего пути.
forwardingProtocol	FrontDoorForwardingProtocol	Протокол, используемый этим правилом при переадресации трафика в серверные части.

FrontDoor

Object

Front Door представляет коллекцию внутренних конечных точек для маршрутизации трафика вместе с правилами, определяющими способ отправки трафика.

Имя	Тип	Описание
id	string	Идентификатор ресурса.
location	string	Расположение ресурса.
name	string	Имя ресурса.
properties.backendPools	BackendPool[]	Серверные пулы, доступные для правил маршрутизации.
properties.backendPoolsSettings	BackendPoolsSettings	Параметры для всех серверных пулов
properties.cname	string	Узел, которому каждый интерфейсныйendPoint должен иметь значение CNAME.
properties.enabledState	FrontDoorEnabledState	Состояние работы подсистемы балансировки нагрузки Front Door. Допустимые значения: "Включено" или "Отключено"
properties.friendlyName	string	Понятное имя для frontDoor
properties.frontendEndpoints	FrontendEndpoint[]	Интерфейсные конечные точки, доступные для правил маршрутизации.
properties.healthProbeSettings	HealthProbeSettingsModel[]	Параметры пробы работоспособности, связанные с этим экземпляром Front Door.
properties.loadBalancingSettings	LoadBalancingSettingsModel[]	Параметры балансировки нагрузки, связанные с этим экземпляром Front Door.
properties.provisioningState	string	Состояние подготовки Front Door.
properties.resourceState	FrontDoorResourceState	Состояние ресурса Front Door или Front Door SubResource. Состояние ресурса Front Door.
properties.routingRules	RoutingRule[]	Правила маршрутизации, связанные с этой Front Door.
tags	object	Теги ресурсов.
type	string	Тип ресурса.

FrontDoorCertificateSource

Перечисление

Определяет источник SSL-сертификата

Значение	Описание
AzureKeyVault
FrontDoor

FrontDoorCertificateType

Перечисление

Определяет тип сертификата, используемого для безопасных подключений к интерфейснойEndpoint.

Значение	Описание
Dedicated

FrontDoorEnabledState

Перечисление

Состояние работы подсистемы балансировки нагрузки Front Door. Допустимые значения: "Включено" или "Отключено"

Значение	Описание
Enabled
Disabled

FrontDoorForwardingProtocol

Перечисление

Протокол, используемый этим правилом при переадресации трафика в серверные части.

Значение	Описание
HttpOnly
HttpsOnly
MatchRequest

FrontDoorHealthProbeMethod

Перечисление

Настраивает метод HTTP, используемый для проверки внутренних серверных компонентов, определенных в серверной части.

Значение	Описание
GET
HEAD

FrontDoorProtocol

Перечисление

Схемы протокола, соответствующие этому правилу

Значение	Описание
Http
Https

FrontDoorQuery

Перечисление

Обработка терминов URL-запросов при формировании ключа кэша.

Значение	Описание
StripNone
StripAll

FrontDoorRedirectProtocol

Перечисление

Протокол назначения, в который перенаправляется трафик

Значение	Описание
HttpOnly
HttpsOnly
MatchRequest

FrontDoorRedirectType

Перечисление

Тип перенаправления, используемый правилом при перенаправлении трафика.

Значение	Описание
Moved
Found
TemporaryRedirect
PermanentRedirect

FrontDoorResourceState

Перечисление

Состояние ресурса Front Door или Front Door SubResource.

Значение	Описание
Creating
Enabling
Enabled
Disabling
Disabled
Deleting

FrontDoorTlsProtocolType

Перечисление

Определяет протокол расширения TLS, используемый для безопасной доставки

Значение	Описание
ServerNameIndication

FrontendEndpoint

Object

Интерфейсная конечная точка, используемая для маршрутизации.

Имя	Тип	Описание
id	string	Идентификатор ресурса.
name	string	Имя ресурса.
properties.customHttpsConfiguration	CustomHttpsConfiguration	Конфигурация, указывающая, как включить HTTPS
properties.customHttpsProvisioningState	CustomHttpsProvisioningState	Состояние подготовки настраиваемых https внешнего интерфейса.
properties.customHttpsProvisioningSubstate	CustomHttpsProvisioningSubstate	Подсостояние подготовки показывает ход выполнения пользовательского процесса включения и отключения HTTPS пошаговые шаги.
properties.hostName	string	Имя узла frontendEndpoint. Должно быть доменным именем.
properties.resourceState	FrontDoorResourceState	Состояние ресурса Front Door или Front Door SubResource. Состояние ресурса.
properties.sessionAffinityEnabledState	SessionAffinityEnabledState	Следует ли разрешать сходство сеансов на этом узле. Допустимые параметры: "Включено" или "Отключено"
properties.sessionAffinityTtlSeconds	integer	НЕИСПОЛЬЗОВАННЫЙ. Это поле будет игнорироваться. TTL, используемый в секундах для сопоставления сеансов, если применимо.
properties.webApplicationFirewallPolicyLink	WebApplicationFirewallPolicyLink	Определяет политику брандмауэра веб-приложения для каждого узла (если применимо)
type	string	Тип ресурса.

HealthProbeEnabled

Перечисление

Следует ли включить пробы работоспособности для серверных серверных служб, определенных в серверной части. Пробы работоспособности могут быть отключены только в том случае, если в одном серверном пуле включена одна включенная серверная часть.

Значение	Описание
Enabled
Disabled

HealthProbeSettingsModel

Object

Параметры балансировки нагрузки для внутреннего пула

Имя	Тип	Default value	Описание
id	string		Идентификатор ресурса.
name	string		Имя ресурса.
properties.enabledState	HealthProbeEnabled		Следует ли включить пробы работоспособности для серверных серверных служб, определенных в серверной части. Пробы работоспособности могут быть отключены только в том случае, если в одном серверном пуле включена одна включенная серверная часть.
properties.healthProbeMethod	FrontDoorHealthProbeMethod	HEAD	Настраивает метод HTTP, используемый для проверки внутренних серверных компонентов, определенных в серверной части.
properties.intervalInSeconds	integer		Количество секунд между пробами работоспособности.
properties.path	string		Путь к использованию для пробы работоспособности. Значение по умолчанию — //
properties.protocol	FrontDoorProtocol		Схема протокола, используемая для этой пробы
properties.resourceState	FrontDoorResourceState		Состояние ресурса Front Door или Front Door SubResource. Состояние ресурса.
type	string		Тип ресурса.

LoadBalancingSettingsModel

Object

Параметры балансировки нагрузки для внутреннего пула

Имя	Тип	Описание
id	string	Идентификатор ресурса.
name	string	Имя ресурса.
properties.additionalLatencyMilliseconds	integer	Дополнительная задержка в миллисекундах для зондов для падения в контейнер с наименьшей задержкой
properties.resourceState	FrontDoorResourceState	Состояние ресурса Front Door или Front Door SubResource. Состояние ресурса.
properties.sampleSize	integer	Количество примеров, которые следует учитывать при принятии решений по балансировке нагрузки
properties.successfulSamplesRequired	integer	Количество выборок в течение примера периода, который должен завершиться успешно
type	string	Тип ресурса.

MinimumTLSVersion

Перечисление

Минимальная версия TLS, требуемая от клиентов для установления подтверждения SSL с Front Door.

Значение	Описание
1.0
1.2

RedirectConfiguration

Object

Описание маршрута перенаправления.

Имя	Тип	Описание
@odata.type	string: #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration
customFragment	string	Фрагмент для добавления в URL-адрес перенаправления. Фрагмент является частью URL-адреса, который поступает после #. Не включайте #.
customHost	string	Узел для перенаправления. Оставьте пустым, чтобы использовать входящий узел в качестве конечного узла.
customPath	string	Полный путь для перенаправления. Путь не может быть пустым и должен начинаться с /. Оставьте пустым путь, чтобы использовать входящий путь в качестве пути назначения.
customQueryString	string	Набор строк запроса, которые необходимо поместить в URL-адрес перенаправления. Задание этого значения заменит любую существующую строку запроса; Оставьте пустым, чтобы сохранить входящие строки запроса. Строка запроса должна быть в <формате key>=<value> . Первый ? и & будут добавлены автоматически, поэтому не включать их в передний план, но разделяйте несколько строк запроса с &.
redirectProtocol	FrontDoorRedirectProtocol	Протокол назначения, в который перенаправляется трафик
redirectType	FrontDoorRedirectType	Тип перенаправления, используемый правилом при перенаправлении трафика.

RoutingRule

Object

Правило маршрутизации представляет спецификацию для обработки и отправки трафика, а также сведений о пробе работоспособности.

Имя	Тип	Описание
id	string	Идентификатор ресурса.
name	string	Имя ресурса.
properties.acceptedProtocols	FrontDoorProtocol[]	Схемы протокола, соответствующие этому правилу
properties.enabledState	routingRuleEnabledState	Следует ли включить использование этого правила. Допустимые значения: "Включено" или "Отключено"
properties.frontendEndpoints	SubResource[]	Интерфейсные конечные точки, связанные с этим правилом
properties.patternsToMatch	string[]	Шаблоны маршрутов правила.
properties.resourceState	FrontDoorResourceState	Состояние ресурса Front Door или Front Door SubResource. Состояние ресурса.
properties.routeConfiguration	RouteConfiguration: ForwardingConfiguration RedirectConfiguration	Ссылка на конфигурацию маршрутизации.
type	string	Тип ресурса.

routingRuleEnabledState

Перечисление

Следует ли включить использование этого правила. Допустимые значения: "Включено" или "Отключено"

Значение	Описание
Enabled
Disabled

SessionAffinityEnabledState

Перечисление

Следует ли разрешать сходство сеансов на этом узле. Допустимые параметры: "Включено" или "Отключено"

Значение	Описание
Enabled
Disabled

SubResource

Object

Ссылка на другой подресурс.

Имя	Тип	Описание
id	string	Идентификатор ресурса.

Vault

Object

Хранилище ключей, содержащее SSL-сертификат

Имя	Тип	Описание
id	string	Идентификатор ресурса.

WebApplicationFirewallPolicyLink

Object

Определяет политику брандмауэра веб-приложения для каждого узла (если применимо)

Имя	Тип	Описание
id	string	Идентификатор ресурса.

Поделиться через

Front Doors - Create Or Update

Параметры URI

Текст запроса

Ответы

Безопасность

azure_auth

Области

Примеры

Create or update specific Front Door

Образец запроса

Пример ответа

Определения

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