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	Имя Front Door, которое является глобально уникальным. Шаблон регулярного выражения: `^[a-zA-Z0-9]+([-a-zA-Z0-9]?[a-zA-Z0-9])*$`
resourceGroupName	path	True	string	Имя группы ресурсов в подписке Azure. Шаблон регулярного выражения: `^[a-zA-Z0-9_\-\.]*[^\.]$`
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. Допустимые значения: Enabled или Disabled.
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	Позволяет разрешить или запретить использование этого внутреннего сервера. Допустимые значения: Enabled или Disabled.
BackendPool	Внутренний пул — это коллекция внутренних серверов, в которую можно перенаправляться.
BackendPoolsSettings	Параметры, применяемые ко всем внутренним пулам.
CacheConfiguration	Параметры кэширования для маршрута типа кэширования. Чтобы отключить кэширование, не предоставляйте объект cacheConfiguration.
CustomHttpsConfiguration	Параметры HTTPS для домена
CustomHttpsProvisioningState	Состояние подготовки пользовательских https frontendEndpoint.
CustomHttpsProvisioningSubstate	Подсостояние подготовки показывает ход выполнения пользовательского процесса включения или отключения HTTPS шаг за шагом.
DynamicCompressionEnabled	Следует ли использовать динамическое сжатие для кэшированного содержимого
enforceCertificateNameCheckEnabledState	Следует ли применять имя сертификата проверка в HTTPS-запросах ко всем внутренним пулам. Не влияет на запросы, отличные от HTTPS.
ErrorResponse	Ответ об ошибке указывает, что служба Front Door не может обработать входящий запрос. Причина указана в сообщении об ошибке.
ForwardingConfiguration	Описывает маршрут переадресации.
FrontDoor	Front Door представляет коллекцию конечных точек серверной части для маршрутизации трафика, а также правила, определяющие способ отправки трафика.
FrontDoorCertificateSource	Определяет источник SSL-сертификата.
FrontDoorCertificateType	Определяет тип сертификата, используемого для безопасных подключений к интерфейсной конечной точке.
FrontDoorEnabledState	Рабочее состояние подсистемы балансировки нагрузки Front Door. Допустимые значения: Enabled или Disabled.
FrontDoorForwardingProtocol	Протокол, который будет использоваться этим правилом при переадресации трафика на серверные серверы.
FrontDoorHealthProbeMethod	Настраивает метод HTTP, используемый для проверки серверных компонентов, определенных в разделе backendPools.
FrontDoorProtocol	Схемы протоколов, соответствующие этому правилу
FrontDoorQuery	Обработка терминов ЗАПРОСА URL-адреса при формировании ключа кэша.
FrontDoorRedirectProtocol	Протокол назначения, в который перенаправляется трафик
FrontDoorRedirectType	Тип перенаправления, который будет использоваться правилом при перенаправлении трафика.
FrontDoorResourceState	Состояние ресурса Front Door или SubResource Front Door.
FrontDoorTlsProtocolType	Определяет протокол расширения TLS, используемый для безопасной доставки.
FrontendEndpoint	Интерфейсная конечная точка, используемая для маршрутизации.
HealthProbeEnabled	Следует ли включить проверку работоспособности для серверных компонентов, определенных в разделе backendPools. Пробы работоспособности можно отключить, только если в одном серверном пуле есть одна включенная серверная часть.
HealthProbeSettingsModel	Параметры балансировки нагрузки для серверного пула
LoadBalancingSettingsModel	Параметры балансировки нагрузки для серверного пула
MinimumTLSVersion	Минимальная версия TLS, необходимая клиентам для подтверждения SSL с Front Door.
RedirectConfiguration	Описывает маршрут перенаправления.
RoutingRule	Правило маршрутизации представляет спецификацию трафика для обработки и места его отправки, а также сведения о пробах работоспособности.
routingRuleEnabledState	Позволяет включить это правило. Допустимые значения: Enabled или Disabled.
SessionAffinityEnabledState	Позволяет разрешить или запретить использование сходства сеансов на этом узле. Допустимые параметры: "Включено" или "Отключено".
SubResource	Ссылка на другой подресурс.
Vault	Хранилище Key Vault, содержащее SSL-сертификат.
WebApplicationFirewallPolicyLink	Определяет политику Брандмауэр веб-приложений для каждого узла (если применимо).

Backend

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

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

backendEnabledState

Позволяет разрешить или запретить использование этого внутреннего сервера. Допустимые значения: Enabled или Disabled.

Имя	Тип	Описание
Disabled	string
Enabled	string

BackendPool

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

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

BackendPoolsSettings

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

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

CacheConfiguration

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

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

CustomHttpsConfiguration

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

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

CustomHttpsProvisioningState

Состояние подготовки пользовательских https frontendEndpoint.

Имя	Тип	Описание
Disabled	string
Disabling	string
Enabled	string
Enabling	string
Failed	string

CustomHttpsProvisioningSubstate

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

Имя	Тип	Описание
CertificateDeleted	string
CertificateDeployed	string
DeletingCertificate	string
DeployingCertificate	string
DomainControlValidationRequestApproved	string
DomainControlValidationRequestRejected	string
DomainControlValidationRequestTimedOut	string
IssuingCertificate	string
PendingDomainControlValidationREquestApproval	string
SubmittingDomainControlValidationRequest	string

DynamicCompressionEnabled

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

Имя	Тип	Описание
Disabled	string
Enabled	string

enforceCertificateNameCheckEnabledState

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

Имя	Тип	Описание
Disabled	string
Enabled	string

ErrorResponse

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

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

ForwardingConfiguration

Описывает маршрут переадресации.

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

FrontDoor

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

Имя	Тип	Описание
id	string	Идентификатор ресурса.
location	string	Расположение ресурса.
name	string	Имя ресурса.
properties.backendPools	BackendPool[]	Внутренние пулы, доступные для правил маршрутизации.
properties.backendPoolsSettings	BackendPoolsSettings	Параметры для всех внутренних пулов
properties.cname	string	Узел, которому должна быть каждая интерфейсная точка CNAME.
properties.enabledState	FrontDoorEnabledState	Рабочее состояние подсистемы балансировки нагрузки Front Door. Допустимые значения: Enabled или Disabled.
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 или SubResource Front Door. Состояние ресурса Front Door.
properties.routingRules	RoutingRule[]	Правила маршрутизации, связанные с этим Front Door.
tags	object	Теги ресурсов.
type	string	Тип ресурса.

FrontDoorCertificateSource

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

Имя	Тип	Описание
AzureKeyVault	string
FrontDoor	string

FrontDoorCertificateType

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

Имя	Тип	Описание
Dedicated	string

FrontDoorEnabledState

Рабочее состояние подсистемы балансировки нагрузки Front Door. Допустимые значения: Enabled или Disabled.

Имя	Тип	Описание
Disabled	string
Enabled	string

FrontDoorForwardingProtocol

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

Имя	Тип	Описание
HttpOnly	string
HttpsOnly	string
MatchRequest	string

FrontDoorHealthProbeMethod

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

Имя	Тип	Описание
GET	string
HEAD	string

FrontDoorProtocol

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

Имя	Тип	Описание
Http	string
Https	string

FrontDoorQuery

Обработка терминов ЗАПРОСА URL-адреса при формировании ключа кэша.

Имя	Тип	Описание
StripAll	string
StripNone	string

FrontDoorRedirectProtocol

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

Имя	Тип	Описание
HttpOnly	string
HttpsOnly	string
MatchRequest	string

FrontDoorRedirectType

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

Имя	Тип	Описание
Found	string
Moved	string
PermanentRedirect	string
TemporaryRedirect	string

FrontDoorResourceState

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

Имя	Тип	Описание
Creating	string
Deleting	string
Disabled	string
Disabling	string
Enabled	string
Enabling	string

FrontDoorTlsProtocolType

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

Имя	Тип	Описание
ServerNameIndication	string

FrontendEndpoint

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

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

HealthProbeEnabled

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

Имя	Тип	Описание
Disabled	string
Enabled	string

HealthProbeSettingsModel

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

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

LoadBalancingSettingsModel

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

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

MinimumTLSVersion

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

Имя	Тип	Описание
1.0	string
1.2	string

RedirectConfiguration

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

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

RoutingRule

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

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

routingRuleEnabledState

Позволяет включить это правило. Допустимые значения: Enabled или Disabled.

Имя	Тип	Описание
Disabled	string
Enabled	string

SessionAffinityEnabledState

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

Имя	Тип	Описание
Disabled	string
Enabled	string

SubResource

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

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

Vault

Хранилище Key Vault, содержащее SSL-сертификат.

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

WebApplicationFirewallPolicyLink

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

Имя	Тип	Описание
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

Дополнительные ресурсы