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


Интерфейсы Microsoft.Network 2021-06-01

Определение ресурсов Bicep

Тип ресурса frontDoors можно развернуть с помощью операций, предназначенных для следующих задач:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.Network/frontDoors, добавьте следующий Bicep в шаблон.

resource symbolicname 'Microsoft.Network/frontDoors@2021-06-01' = {
  location: 'string'
  name: 'string'
  properties: {
    backendPools: [
      {
        id: 'string'
        name: 'string'
        properties: {
          backends: [
            {
              address: 'string'
              backendHostHeader: 'string'
              enabledState: 'string'
              httpPort: int
              httpsPort: int
              priority: int
              privateLinkAlias: 'string'
              privateLinkApprovalMessage: 'string'
              privateLinkLocation: 'string'
              privateLinkResourceId: 'string'
              weight: int
            }
          ]
          healthProbeSettings: {
            id: 'string'
          }
          loadBalancingSettings: {
            id: 'string'
          }
        }
      }
    ]
    backendPoolsSettings: {
      enforceCertificateNameCheck: 'string'
      sendRecvTimeoutSeconds: int
    }
    enabledState: 'string'
    friendlyName: 'string'
    frontendEndpoints: [
      {
        id: 'string'
        name: 'string'
        properties: {
          hostName: 'string'
          sessionAffinityEnabledState: 'string'
          sessionAffinityTtlSeconds: int
          webApplicationFirewallPolicyLink: {
            id: 'string'
          }
        }
      }
    ]
    healthProbeSettings: [
      {
        id: 'string'
        name: 'string'
        properties: {
          enabledState: 'string'
          healthProbeMethod: 'string'
          intervalInSeconds: int
          path: 'string'
          protocol: 'string'
        }
      }
    ]
    loadBalancingSettings: [
      {
        id: 'string'
        name: 'string'
        properties: {
          additionalLatencyMilliseconds: int
          sampleSize: int
          successfulSamplesRequired: int
        }
      }
    ]
    routingRules: [
      {
        id: 'string'
        name: 'string'
        properties: {
          acceptedProtocols: [
            'string'
          ]
          enabledState: 'string'
          frontendEndpoints: [
            {
              id: 'string'
            }
          ]
          patternsToMatch: [
            'string'
          ]
          routeConfiguration: {
            @odata.type: 'string'
            // For remaining properties, see RouteConfiguration objects
          }
          rulesEngine: {
            id: 'string'
          }
          webApplicationFirewallPolicyLink: {
            id: 'string'
          }
        }
      }
    ]
  }
  tags: {
    {customized property}: 'string'
  }
}

Объекты RouteConfiguration

Задайте свойство @odata.type, чтобы указать тип объекта.

Для #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfigurationиспользуйте:

{
  @odata.type: '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration'
  backendPool: {
    id: 'string'
  }
  cacheConfiguration: {
    cacheDuration: 'string'
    dynamicCompression: 'string'
    queryParameters: 'string'
    queryParameterStripDirective: 'string'
  }
  customForwardingPath: 'string'
  forwardingProtocol: 'string'
}

Для #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfigurationиспользуйте:

{
  @odata.type: '#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration'
  customFragment: 'string'
  customHost: 'string'
  customPath: 'string'
  customQueryString: 'string'
  redirectProtocol: 'string'
  redirectType: 'string'
}

Значения свойств

Microsoft.Network/frontDoors

Имя Описание Ценность
местоположение Расположение ресурса. струна
имя Имя ресурса струна

Ограничения целостности:
Минимальная длина = 5
Максимальная длина = 64
Pattern = ^[a-zA-Z0-9]+([-a-zA-Z0-9]?[a-zA-Z0-9])*$ (обязательно)
свойства Свойства подсистемы балансировки нагрузки Front Door Свойства передней двери
Теги Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах

Серверная часть

Имя Описание Ценность
адрес Расположение серверной части (IP-адрес или полное доменное имя) струна
backendHostHeader Значение, используемое в качестве заголовка узла, отправленного серверной части. Если пустое или не указано, это по умолчанию используется для входящего узла. струна
enabledState Следует ли включить использование этой серверной части. Допустимые значения: "Включено" или "Отключено" "Отключено"
"Включено"
httpPort Номер TCP-порта HTTP. Должно быть от 1 до 65535. int

Ограничения целостности:
Минимальное значение = 1
Максимальное значение = 65535
Порт httpsPort Номер TCP-порта HTTPS. Должно быть от 1 до 65535. int

Ограничения целостности:
Минимальное значение = 1
Максимальное значение = 65535
приоритет Приоритет использования для балансировки нагрузки. Более высокие приоритеты не будут использоваться для балансировки нагрузки, если какая-либо серверная часть с более низким приоритетом работоспособна. int

Ограничения целостности:
Минимальное значение = 1
Максимальное значение = 5
privateLinkAlias Псевдоним ресурса Приватного канала. Заполнение этого необязательного поля указывает, что эта серверная часть является "Private" струна
privateLinkApprovalMessage Настраиваемое сообщение для включения в запрос утверждения для подключения к приватной ссылке струна
privateLinkLocation Расположение ресурса Приватного канала. Требуется только в том случае, если "privateLinkResourceId" заполняется струна
privateLinkResourceId Идентификатор ресурса ресурса Приватного канала. Заполнение этого необязательного поля указывает, что эта серверная часть является "Private" струна
вес Вес этой конечной точки для балансировки нагрузки. int

Ограничения целостности:
Минимальное значение = 1
Максимальное значение = 1000

BackendPool

Имя Описание Ценность
идентификатор Идентификатор ресурса. струна
имя Имя ресурса. струна
свойства Свойства внутреннего пула Front Door BackendPoolProperties (Свойства BackendPool)

BackendPoolProperties (Свойства BackendPool)

Имя Описание Ценность
серверные части Набор серверных компонентов для этого пула серверной части[]
healthProbeSettings Параметры пробы работоспособности L7 для внутреннего пула Подресурс
loadBalancingSettings Параметры балансировки нагрузки для внутреннего пула Подресурс

BackendPoolsSettings (БэкендПулыНастройки)

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

Ограничения целостности:
Минимальное значение = 16

Конфигурация кэша

Имя Описание Ценность
cacheDuration (длительность) Длительность кэширования содержимого. Допустимый формат имеет формат ISO 8601 (http://en.wikipedia.org/wiki/ISO_8601#Durations). Http требует, чтобы значение не более года струна
DynamicCompression Использование динамического сжатия для кэшированного содержимого "Отключено"
"Включено"
queryParameters параметры запроса для включения или исключения (разделенные запятыми). струна
queryParameterStripДиректива Обработка терминов URL-запросов при формировании ключа кэша. "StripAll"
«ПолосаВсеКроме»
"StripNone"
"StripOnly"

Пересылка Конфигурации

Имя Описание Ценность
@odata.type "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration" (обязательно)
backendPool Ссылка на BackendPool, к которой направляется это правило. Подресурс
Конфигурация cache Конфигурация кэширования, связанная с этим правилом. Конфигурация кэша
customForwardingPath Пользовательский путь, используемый для перезаписи путей ресурсов, соответствующих этому правилу. Оставьте пустым путь для использования входящего пути. струна
пересылкаProtocol Протокол, используемый этим правилом при переадресации трафика в серверные части. HttpOnly
HttpsOnly
MatchRequest

Свойства передней двери

Имя Описание Ценность
серверные пулы Серверные пулы, доступные для правил маршрутизации. БэкендПул[]
backendPoolsSettings Параметры для всех серверных пулов BackendPoolsSettings (БэкендПулыНастройки)
enabledState Состояние работы подсистемы балансировки нагрузки Front Door. Допустимые значения: "Включено" или "Отключено" "Отключено"
"Включено"
дружественноеИмя Понятное имя для frontDoor струна
frontendEndpoints Интерфейсные конечные точки, доступные для правил маршрутизации. FrontendEndpoint[]
healthProbeSettings Параметры пробы работоспособности, связанные с этим экземпляром Front Door. HealthProbeSettingsModel[]
loadBalancingSettings Параметры балансировки нагрузки, связанные с этим экземпляром Front Door. LoadBalancingSettingsModel[]
routingRules Правила маршрутизации, связанные с этой Front Door. МаршрутизацияRule[]

FrontendEndpoint

Имя Описание Ценность
идентификатор Идентификатор ресурса. струна
имя Имя ресурса. струна
свойства Свойства конечной точки frontend FrontendPointProperties

Свойства FrontendEndpoint

Имя Описание Ценность
имя хоста Имя узла frontendEndpoint. Должно быть доменным именем. струна
sessionAffinityEnabledState Следует ли разрешать сходство сеансов на этом узле. Допустимые параметры: "Включено" или "Отключено" "Отключено"
"Включено"
sessionAffinityTtlSeconds НЕИСПОЛЬЗОВАННЫЙ. Это поле будет игнорироваться. TTL, используемый в секундах для сопоставления сеансов, если применимо. инт
webApplicationFirewallPolicyLink Определяет политику брандмауэра веб-приложения для каждого узла (если применимо) FrontendEndpointUpdateParametersWebApplicationFirewallPolicyLink
Имя Описание Ценность
идентификатор Идентификатор ресурса. струна

HealthProbeSettingsModel

Имя Описание Ценность
идентификатор Идентификатор ресурса. струна
имя Имя ресурса. струна
свойства Свойства параметров пробы работоспособности HealthProbeSettingsProperties

HealthProbeSettingsProperties

Имя Описание Ценность
enabledState Следует ли включить пробы работоспособности для серверных серверных служб, определенных в серверной части. Пробы работоспособности могут быть отключены только в том случае, если в одном серверном пуле включена одна включенная серверная часть. "Отключено"
"Включено"
метод healthProbeMethod Настраивает метод HTTP, используемый для проверки внутренних серверных компонентов, определенных в серверной части. Get
"HEAD"
интервалВСекундах Количество секунд между пробами работоспособности. инт
путь Путь к использованию для пробы работоспособности. Значение по умолчанию — // струна
протокол Схема протокола, используемая для этой пробы "Http"
"Https"

LoadBalancingSettingsModel

Имя Описание Ценность
идентификатор Идентификатор ресурса. струна
имя Имя ресурса. струна
свойства Свойства параметров балансировки нагрузки LoadBalancingSettingsProperties

LoadBalancingSettingsProperties

Имя Описание Ценность
additionalLatencyMilliseconds Дополнительная задержка в миллисекундах для зондов для падения в контейнер с наименьшей задержкой инт
sampleSize Количество примеров, которые следует учитывать при принятии решений по балансировке нагрузки инт
успешныеСэмплыОбязательные Количество выборок в течение примера периода, который должен завершиться успешно инт

ПеренаправлениеКонфигурация

Имя Описание Ценность
@odata.type "#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration" (обязательный)
пользовательский фрагмент Фрагмент для добавления в URL-адрес перенаправления. Фрагмент является частью URL-адреса, который поступает после #. Не включайте #. струна
customHost Узел для перенаправления. Оставьте пустым, чтобы использовать входящий узел в качестве конечного узла. струна
customPath Полный путь для перенаправления. Путь не может быть пустым и должен начинаться с /. Оставьте пустым путь, чтобы использовать входящий путь в качестве пути назначения. струна
customQueryString Набор строк запроса, которые необходимо поместить в URL-адрес перенаправления. Задание этого значения заменит любую существующую строку запроса; Оставьте пустым, чтобы сохранить входящие строки запроса. Строка запроса должна находиться в <ключе>=<формате>. Первый ? и & будут добавлены автоматически, поэтому не включать их в передний план, но разделяйте несколько строк запроса с &. струна
redirectProtocol Протокол назначения, в который перенаправляется трафик HttpOnly
HttpsOnly
MatchRequest
redirectType Тип перенаправления, используемый правилом при перенаправлении трафика. "Найдено"
"Перемещено"
"PermanentRedirect"
"ВременныйRedirect"

Теги ресурса

Имя Описание Ценность

Конфигурация маршрута

Имя Описание Ценность
@odata.type Установите значение "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration" для типа ForwardingConfiguration. Установите значение "#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration" для типа RedirectConfiguration. '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration'
"#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration" (обязательный)

Правило маршрутизации

Имя Описание Ценность
идентификатор Идентификатор ресурса. струна
имя Имя ресурса. струна
свойства Свойства правила маршрутизации Front Door Свойства правила маршрутизации

Свойства правила маршрутизации

Имя Описание Ценность
принятыПротоколы Схемы протокола, соответствующие этому правилу Массив строк, содержащий любой из:
"Http"
"Https"
enabledState Следует ли включить использование этого правила. Допустимые значения: "Включено" или "Отключено" "Отключено"
"Включено"
frontendEndpoints Интерфейсные конечные точки, связанные с этим правилом Подресурс[]
patternsToMatch Шаблоны маршрутов правила. строка[]
routeConfiguration Ссылка на конфигурацию маршрутизации. Конфигурация маршрута
rulesEngine Ссылка на определенную конфигурацию обработчика правил для применения к этому маршруту. Подресурс
webApplicationFirewallPolicyLink Определяет политику брандмауэра веб-приложения для каждого правила маршрутизации (если применимо) RoutingRuleUpdateParametersWebApplicationFirewallPolicyLink
Имя Описание Ценность
идентификатор Идентификатор ресурса. струна

Подресурс

Имя Описание Ценность
идентификатор Идентификатор ресурса. струна

Примеры использования

Проверенные модули Azure

Следующие проверенные модули Azure можно использовать для развертывания этого типа ресурсов.

Модуль Описание
Azure Front Door (передняя дверь Azure) Модуль ресурсов AVM для Azure Front Door

Примеры быстрого запуска Azure

Следующие шаблоны быстрого запуска Azure содержат примеры Bicep для развертывания этого типа ресурса.

Bicep-файл Описание
Добавление личного домена и пользовательского сертификата с помощью Front Door Этот шаблон подключен и защищает личный домен с помощью Front Door с помощью сертификата, управляемого клиентом.
Добавление личного домена и управляемого сертификата с помощью Front Door Этот шаблон подключен и защищает личный домен с помощью Front Door
контроль работоспособности для серверных элементов в Front Door Этот шаблон обновляет Front Door, чтобы изменить параметры пробы работоспособности, задав путь пробы, а также интервалы, в которых будут отправляться пробы.
создание базовой Front Door Этот шаблон создает базовую конфигурацию Front Door с одной серверной частью.
создание Front Door с помощью HTTP-перенаправления по ПРОТОКОЛу HTTPS Этот шаблон создает конфигурацию Front Door для перенаправления HTTP в HTTPS.

Определение ресурса шаблона ARM

Тип ресурса frontDoors можно развернуть с помощью операций, предназначенных для следующих задач:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.Network/frontDoors, добавьте следующий код JSON в шаблон.

{
  "type": "Microsoft.Network/frontDoors",
  "apiVersion": "2021-06-01",
  "name": "string",
  "location": "string",
  "properties": {
    "backendPools": [
      {
        "id": "string",
        "name": "string",
        "properties": {
          "backends": [
            {
              "address": "string",
              "backendHostHeader": "string",
              "enabledState": "string",
              "httpPort": "int",
              "httpsPort": "int",
              "priority": "int",
              "privateLinkAlias": "string",
              "privateLinkApprovalMessage": "string",
              "privateLinkLocation": "string",
              "privateLinkResourceId": "string",
              "weight": "int"
            }
          ],
          "healthProbeSettings": {
            "id": "string"
          },
          "loadBalancingSettings": {
            "id": "string"
          }
        }
      }
    ],
    "backendPoolsSettings": {
      "enforceCertificateNameCheck": "string",
      "sendRecvTimeoutSeconds": "int"
    },
    "enabledState": "string",
    "friendlyName": "string",
    "frontendEndpoints": [
      {
        "id": "string",
        "name": "string",
        "properties": {
          "hostName": "string",
          "sessionAffinityEnabledState": "string",
          "sessionAffinityTtlSeconds": "int",
          "webApplicationFirewallPolicyLink": {
            "id": "string"
          }
        }
      }
    ],
    "healthProbeSettings": [
      {
        "id": "string",
        "name": "string",
        "properties": {
          "enabledState": "string",
          "healthProbeMethod": "string",
          "intervalInSeconds": "int",
          "path": "string",
          "protocol": "string"
        }
      }
    ],
    "loadBalancingSettings": [
      {
        "id": "string",
        "name": "string",
        "properties": {
          "additionalLatencyMilliseconds": "int",
          "sampleSize": "int",
          "successfulSamplesRequired": "int"
        }
      }
    ],
    "routingRules": [
      {
        "id": "string",
        "name": "string",
        "properties": {
          "acceptedProtocols": [ "string" ],
          "enabledState": "string",
          "frontendEndpoints": [
            {
              "id": "string"
            }
          ],
          "patternsToMatch": [ "string" ],
          "routeConfiguration": {
            "@odata.type": "string"
            // For remaining properties, see RouteConfiguration objects
          },
          "rulesEngine": {
            "id": "string"
          },
          "webApplicationFirewallPolicyLink": {
            "id": "string"
          }
        }
      }
    ]
  },
  "tags": {
    "{customized property}": "string"
  }
}

Объекты RouteConfiguration

Задайте свойство @odata.type, чтобы указать тип объекта.

Для #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfigurationиспользуйте:

{
  "@odata.type": "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration",
  "backendPool": {
    "id": "string"
  },
  "cacheConfiguration": {
    "cacheDuration": "string",
    "dynamicCompression": "string",
    "queryParameters": "string",
    "queryParameterStripDirective": "string"
  },
  "customForwardingPath": "string",
  "forwardingProtocol": "string"
}

Для #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfigurationиспользуйте:

{
  "@odata.type": "#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration",
  "customFragment": "string",
  "customHost": "string",
  "customPath": "string",
  "customQueryString": "string",
  "redirectProtocol": "string",
  "redirectType": "string"
}

Значения свойств

Microsoft.Network/frontDoors

Имя Описание Ценность
apiVersion Версия API '2021-06-01'
местоположение Расположение ресурса. струна
имя Имя ресурса струна

Ограничения целостности:
Минимальная длина = 5
Максимальная длина = 64
Pattern = ^[a-zA-Z0-9]+([-a-zA-Z0-9]?[a-zA-Z0-9])*$ (обязательно)
свойства Свойства подсистемы балансировки нагрузки Front Door Свойства передней двери
Теги Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах
тип Тип ресурса "Microsoft.Network/frontDoors"

Серверная часть

Имя Описание Ценность
адрес Расположение серверной части (IP-адрес или полное доменное имя) струна
backendHostHeader Значение, используемое в качестве заголовка узла, отправленного серверной части. Если пустое или не указано, это по умолчанию используется для входящего узла. струна
enabledState Следует ли включить использование этой серверной части. Допустимые значения: "Включено" или "Отключено" "Отключено"
"Включено"
httpPort Номер TCP-порта HTTP. Должно быть от 1 до 65535. int

Ограничения целостности:
Минимальное значение = 1
Максимальное значение = 65535
Порт httpsPort Номер TCP-порта HTTPS. Должно быть от 1 до 65535. int

Ограничения целостности:
Минимальное значение = 1
Максимальное значение = 65535
приоритет Приоритет использования для балансировки нагрузки. Более высокие приоритеты не будут использоваться для балансировки нагрузки, если какая-либо серверная часть с более низким приоритетом работоспособна. int

Ограничения целостности:
Минимальное значение = 1
Максимальное значение = 5
privateLinkAlias Псевдоним ресурса Приватного канала. Заполнение этого необязательного поля указывает, что эта серверная часть является "Private" струна
privateLinkApprovalMessage Настраиваемое сообщение для включения в запрос утверждения для подключения к приватной ссылке струна
privateLinkLocation Расположение ресурса Приватного канала. Требуется только в том случае, если "privateLinkResourceId" заполняется струна
privateLinkResourceId Идентификатор ресурса ресурса Приватного канала. Заполнение этого необязательного поля указывает, что эта серверная часть является "Private" струна
вес Вес этой конечной точки для балансировки нагрузки. int

Ограничения целостности:
Минимальное значение = 1
Максимальное значение = 1000

BackendPool

Имя Описание Ценность
идентификатор Идентификатор ресурса. струна
имя Имя ресурса. струна
свойства Свойства внутреннего пула Front Door BackendPoolProperties (Свойства BackendPool)

BackendPoolProperties (Свойства BackendPool)

Имя Описание Ценность
серверные части Набор серверных компонентов для этого пула серверной части[]
healthProbeSettings Параметры пробы работоспособности L7 для внутреннего пула Подресурс
loadBalancingSettings Параметры балансировки нагрузки для внутреннего пула Подресурс

BackendPoolsSettings (БэкендПулыНастройки)

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

Ограничения целостности:
Минимальное значение = 16

Конфигурация кэша

Имя Описание Ценность
cacheDuration (длительность) Длительность кэширования содержимого. Допустимый формат имеет формат ISO 8601 (http://en.wikipedia.org/wiki/ISO_8601#Durations). Http требует, чтобы значение не более года струна
DynamicCompression Использование динамического сжатия для кэшированного содержимого "Отключено"
"Включено"
queryParameters параметры запроса для включения или исключения (разделенные запятыми). струна
queryParameterStripДиректива Обработка терминов URL-запросов при формировании ключа кэша. "StripAll"
«ПолосаВсеКроме»
"StripNone"
"StripOnly"

Пересылка Конфигурации

Имя Описание Ценность
@odata.type "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration" (обязательно)
backendPool Ссылка на BackendPool, к которой направляется это правило. Подресурс
Конфигурация cache Конфигурация кэширования, связанная с этим правилом. Конфигурация кэша
customForwardingPath Пользовательский путь, используемый для перезаписи путей ресурсов, соответствующих этому правилу. Оставьте пустым путь для использования входящего пути. струна
пересылкаProtocol Протокол, используемый этим правилом при переадресации трафика в серверные части. HttpOnly
HttpsOnly
MatchRequest

Свойства передней двери

Имя Описание Ценность
серверные пулы Серверные пулы, доступные для правил маршрутизации. БэкендПул[]
backendPoolsSettings Параметры для всех серверных пулов BackendPoolsSettings (БэкендПулыНастройки)
enabledState Состояние работы подсистемы балансировки нагрузки Front Door. Допустимые значения: "Включено" или "Отключено" "Отключено"
"Включено"
дружественноеИмя Понятное имя для frontDoor струна
frontendEndpoints Интерфейсные конечные точки, доступные для правил маршрутизации. FrontendEndpoint[]
healthProbeSettings Параметры пробы работоспособности, связанные с этим экземпляром Front Door. HealthProbeSettingsModel[]
loadBalancingSettings Параметры балансировки нагрузки, связанные с этим экземпляром Front Door. LoadBalancingSettingsModel[]
routingRules Правила маршрутизации, связанные с этой Front Door. МаршрутизацияRule[]

FrontendEndpoint

Имя Описание Ценность
идентификатор Идентификатор ресурса. струна
имя Имя ресурса. струна
свойства Свойства конечной точки frontend FrontendPointProperties

Свойства FrontendEndpoint

Имя Описание Ценность
имя хоста Имя узла frontendEndpoint. Должно быть доменным именем. струна
sessionAffinityEnabledState Следует ли разрешать сходство сеансов на этом узле. Допустимые параметры: "Включено" или "Отключено" "Отключено"
"Включено"
sessionAffinityTtlSeconds НЕИСПОЛЬЗОВАННЫЙ. Это поле будет игнорироваться. TTL, используемый в секундах для сопоставления сеансов, если применимо. инт
webApplicationFirewallPolicyLink Определяет политику брандмауэра веб-приложения для каждого узла (если применимо) FrontendEndpointUpdateParametersWebApplicationFirewallPolicyLink
Имя Описание Ценность
идентификатор Идентификатор ресурса. струна

HealthProbeSettingsModel

Имя Описание Ценность
идентификатор Идентификатор ресурса. струна
имя Имя ресурса. струна
свойства Свойства параметров пробы работоспособности HealthProbeSettingsProperties

HealthProbeSettingsProperties

Имя Описание Ценность
enabledState Следует ли включить пробы работоспособности для серверных серверных служб, определенных в серверной части. Пробы работоспособности могут быть отключены только в том случае, если в одном серверном пуле включена одна включенная серверная часть. "Отключено"
"Включено"
метод healthProbeMethod Настраивает метод HTTP, используемый для проверки внутренних серверных компонентов, определенных в серверной части. Get
"HEAD"
интервалВСекундах Количество секунд между пробами работоспособности. инт
путь Путь к использованию для пробы работоспособности. Значение по умолчанию — // струна
протокол Схема протокола, используемая для этой пробы "Http"
"Https"

LoadBalancingSettingsModel

Имя Описание Ценность
идентификатор Идентификатор ресурса. струна
имя Имя ресурса. струна
свойства Свойства параметров балансировки нагрузки LoadBalancingSettingsProperties

LoadBalancingSettingsProperties

Имя Описание Ценность
additionalLatencyMilliseconds Дополнительная задержка в миллисекундах для зондов для падения в контейнер с наименьшей задержкой инт
sampleSize Количество примеров, которые следует учитывать при принятии решений по балансировке нагрузки инт
успешныеСэмплыОбязательные Количество выборок в течение примера периода, который должен завершиться успешно инт

ПеренаправлениеКонфигурация

Имя Описание Ценность
@odata.type "#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration" (обязательный)
пользовательский фрагмент Фрагмент для добавления в URL-адрес перенаправления. Фрагмент является частью URL-адреса, который поступает после #. Не включайте #. струна
customHost Узел для перенаправления. Оставьте пустым, чтобы использовать входящий узел в качестве конечного узла. струна
customPath Полный путь для перенаправления. Путь не может быть пустым и должен начинаться с /. Оставьте пустым путь, чтобы использовать входящий путь в качестве пути назначения. струна
customQueryString Набор строк запроса, которые необходимо поместить в URL-адрес перенаправления. Задание этого значения заменит любую существующую строку запроса; Оставьте пустым, чтобы сохранить входящие строки запроса. Строка запроса должна находиться в <ключе>=<формате>. Первый ? и & будут добавлены автоматически, поэтому не включать их в передний план, но разделяйте несколько строк запроса с &. струна
redirectProtocol Протокол назначения, в который перенаправляется трафик HttpOnly
HttpsOnly
MatchRequest
redirectType Тип перенаправления, используемый правилом при перенаправлении трафика. "Найдено"
"Перемещено"
"PermanentRedirect"
"ВременныйRedirect"

Теги ресурса

Имя Описание Ценность

Конфигурация маршрута

Имя Описание Ценность
@odata.type Установите значение "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration" для типа ForwardingConfiguration. Установите значение "#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration" для типа RedirectConfiguration. '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration'
"#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration" (обязательный)

Правило маршрутизации

Имя Описание Ценность
идентификатор Идентификатор ресурса. струна
имя Имя ресурса. струна
свойства Свойства правила маршрутизации Front Door Свойства правила маршрутизации

Свойства правила маршрутизации

Имя Описание Ценность
принятыПротоколы Схемы протокола, соответствующие этому правилу Массив строк, содержащий любой из:
"Http"
"Https"
enabledState Следует ли включить использование этого правила. Допустимые значения: "Включено" или "Отключено" "Отключено"
"Включено"
frontendEndpoints Интерфейсные конечные точки, связанные с этим правилом Подресурс[]
patternsToMatch Шаблоны маршрутов правила. строка[]
routeConfiguration Ссылка на конфигурацию маршрутизации. Конфигурация маршрута
rulesEngine Ссылка на определенную конфигурацию обработчика правил для применения к этому маршруту. Подресурс
webApplicationFirewallPolicyLink Определяет политику брандмауэра веб-приложения для каждого правила маршрутизации (если применимо) RoutingRuleUpdateParametersWebApplicationFirewallPolicyLink
Имя Описание Ценность
идентификатор Идентификатор ресурса. струна

Подресурс

Имя Описание Ценность
идентификатор Идентификатор ресурса. струна

Примеры использования

Шаблоны быстрого запуска Azure

Следующие шаблоны быстрого запуска Azure развернуть этот тип ресурса.

Шаблон Описание
Добавление личного домена и пользовательского сертификата с помощью Front Door

развертывание в Azure
Этот шаблон подключен и защищает личный домен с помощью Front Door с помощью сертификата, управляемого клиентом.
Добавление личного домена и управляемого сертификата с помощью Front Door

развертывание в Azure
Этот шаблон подключен и защищает личный домен с помощью Front Door
Настройка сопоставления сеансов для имен узлов Front Door

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

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

развертывание в Azure
Этот шаблон создает базовую конфигурацию Front Door с одной серверной частью.
создание Front Door с помощью HTTP-перенаправления по ПРОТОКОЛу HTTPS

развертывание в Azure
Этот шаблон создает конфигурацию Front Door для перенаправления HTTP в HTTPS.
Создание Front Door с несколькими серверными и внутренними пулами

развертывание в Azure
Этот шаблон создает Front Door с балансировкой нагрузки, настроенной для нескольких внутренних серверов в серверном пуле, а также между внутренними пулами на основе URL-пути.
создание Azure Front Door перед управления API Azure

развертывание в Azure
В этом примере показано, как использовать Azure Front Door в качестве глобальной подсистемы балансировки нагрузки перед управлением API Azure.
Создание Front Door с Active-Standby конфигурации

развертывание в Azure
Этот шаблон создает Front Door, демонстрирующий маршрутизацию на основе приоритетов для топологии приложений Active-Standby.
Создание Front Door с поддержкой кэширования для определенных маршрутов

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

Определение ресурса Terraform (поставщик AzAPI)

Тип ресурса frontDoors можно развернуть с помощью операций, предназначенных для следующих задач:

  • групп ресурсов

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.Network/frontDoors, добавьте следующий объект Terraform в шаблон.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/frontDoors@2021-06-01"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      backendPools = [
        {
          id = "string"
          name = "string"
          properties = {
            backends = [
              {
                address = "string"
                backendHostHeader = "string"
                enabledState = "string"
                httpPort = int
                httpsPort = int
                priority = int
                privateLinkAlias = "string"
                privateLinkApprovalMessage = "string"
                privateLinkLocation = "string"
                privateLinkResourceId = "string"
                weight = int
              }
            ]
            healthProbeSettings = {
              id = "string"
            }
            loadBalancingSettings = {
              id = "string"
            }
          }
        }
      ]
      backendPoolsSettings = {
        enforceCertificateNameCheck = "string"
        sendRecvTimeoutSeconds = int
      }
      enabledState = "string"
      friendlyName = "string"
      frontendEndpoints = [
        {
          id = "string"
          name = "string"
          properties = {
            hostName = "string"
            sessionAffinityEnabledState = "string"
            sessionAffinityTtlSeconds = int
            webApplicationFirewallPolicyLink = {
              id = "string"
            }
          }
        }
      ]
      healthProbeSettings = [
        {
          id = "string"
          name = "string"
          properties = {
            enabledState = "string"
            healthProbeMethod = "string"
            intervalInSeconds = int
            path = "string"
            protocol = "string"
          }
        }
      ]
      loadBalancingSettings = [
        {
          id = "string"
          name = "string"
          properties = {
            additionalLatencyMilliseconds = int
            sampleSize = int
            successfulSamplesRequired = int
          }
        }
      ]
      routingRules = [
        {
          id = "string"
          name = "string"
          properties = {
            acceptedProtocols = [
              "string"
            ]
            enabledState = "string"
            frontendEndpoints = [
              {
                id = "string"
              }
            ]
            patternsToMatch = [
              "string"
            ]
            routeConfiguration = {
              @odata.type = "string"
              // For remaining properties, see RouteConfiguration objects
            }
            rulesEngine = {
              id = "string"
            }
            webApplicationFirewallPolicyLink = {
              id = "string"
            }
          }
        }
      ]
    }
  }
}

Объекты RouteConfiguration

Задайте свойство @odata.type, чтобы указать тип объекта.

Для #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfigurationиспользуйте:

{
  @odata.type = "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration"
  backendPool = {
    id = "string"
  }
  cacheConfiguration = {
    cacheDuration = "string"
    dynamicCompression = "string"
    queryParameters = "string"
    queryParameterStripDirective = "string"
  }
  customForwardingPath = "string"
  forwardingProtocol = "string"
}

Для #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfigurationиспользуйте:

{
  @odata.type = "#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration"
  customFragment = "string"
  customHost = "string"
  customPath = "string"
  customQueryString = "string"
  redirectProtocol = "string"
  redirectType = "string"
}

Значения свойств

Microsoft.Network/frontDoors

Имя Описание Ценность
местоположение Расположение ресурса. струна
имя Имя ресурса струна

Ограничения целостности:
Минимальная длина = 5
Максимальная длина = 64
Pattern = ^[a-zA-Z0-9]+([-a-zA-Z0-9]?[a-zA-Z0-9])*$ (обязательно)
свойства Свойства подсистемы балансировки нагрузки Front Door Свойства передней двери
Теги Теги ресурсов Словарь имен и значений тегов.
тип Тип ресурса "Microsoft.Network/frontDoors@2021-06-01"

Серверная часть

Имя Описание Ценность
адрес Расположение серверной части (IP-адрес или полное доменное имя) струна
backendHostHeader Значение, используемое в качестве заголовка узла, отправленного серверной части. Если пустое или не указано, это по умолчанию используется для входящего узла. струна
enabledState Следует ли включить использование этой серверной части. Допустимые значения: "Включено" или "Отключено" "Отключено"
"Включено"
httpPort Номер TCP-порта HTTP. Должно быть от 1 до 65535. int

Ограничения целостности:
Минимальное значение = 1
Максимальное значение = 65535
Порт httpsPort Номер TCP-порта HTTPS. Должно быть от 1 до 65535. int

Ограничения целостности:
Минимальное значение = 1
Максимальное значение = 65535
приоритет Приоритет использования для балансировки нагрузки. Более высокие приоритеты не будут использоваться для балансировки нагрузки, если какая-либо серверная часть с более низким приоритетом работоспособна. int

Ограничения целостности:
Минимальное значение = 1
Максимальное значение = 5
privateLinkAlias Псевдоним ресурса Приватного канала. Заполнение этого необязательного поля указывает, что эта серверная часть является "Private" струна
privateLinkApprovalMessage Настраиваемое сообщение для включения в запрос утверждения для подключения к приватной ссылке струна
privateLinkLocation Расположение ресурса Приватного канала. Требуется только в том случае, если "privateLinkResourceId" заполняется струна
privateLinkResourceId Идентификатор ресурса ресурса Приватного канала. Заполнение этого необязательного поля указывает, что эта серверная часть является "Private" струна
вес Вес этой конечной точки для балансировки нагрузки. int

Ограничения целостности:
Минимальное значение = 1
Максимальное значение = 1000

BackendPool

Имя Описание Ценность
идентификатор Идентификатор ресурса. струна
имя Имя ресурса. струна
свойства Свойства внутреннего пула Front Door BackendPoolProperties (Свойства BackendPool)

BackendPoolProperties (Свойства BackendPool)

Имя Описание Ценность
серверные части Набор серверных компонентов для этого пула серверной части[]
healthProbeSettings Параметры пробы работоспособности L7 для внутреннего пула Подресурс
loadBalancingSettings Параметры балансировки нагрузки для внутреннего пула Подресурс

BackendPoolsSettings (БэкендПулыНастройки)

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

Ограничения целостности:
Минимальное значение = 16

Конфигурация кэша

Имя Описание Ценность
cacheDuration (длительность) Длительность кэширования содержимого. Допустимый формат имеет формат ISO 8601 (http://en.wikipedia.org/wiki/ISO_8601#Durations). Http требует, чтобы значение не более года струна
DynamicCompression Использование динамического сжатия для кэшированного содержимого "Отключено"
"Включено"
queryParameters параметры запроса для включения или исключения (разделенные запятыми). струна
queryParameterStripДиректива Обработка терминов URL-запросов при формировании ключа кэша. "StripAll"
«ПолосаВсеКроме»
"StripNone"
"StripOnly"

Пересылка Конфигурации

Имя Описание Ценность
@odata.type "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration" (обязательно)
backendPool Ссылка на BackendPool, к которой направляется это правило. Подресурс
Конфигурация cache Конфигурация кэширования, связанная с этим правилом. Конфигурация кэша
customForwardingPath Пользовательский путь, используемый для перезаписи путей ресурсов, соответствующих этому правилу. Оставьте пустым путь для использования входящего пути. струна
пересылкаProtocol Протокол, используемый этим правилом при переадресации трафика в серверные части. HttpOnly
HttpsOnly
MatchRequest

Свойства передней двери

Имя Описание Ценность
серверные пулы Серверные пулы, доступные для правил маршрутизации. БэкендПул[]
backendPoolsSettings Параметры для всех серверных пулов BackendPoolsSettings (БэкендПулыНастройки)
enabledState Состояние работы подсистемы балансировки нагрузки Front Door. Допустимые значения: "Включено" или "Отключено" "Отключено"
"Включено"
дружественноеИмя Понятное имя для frontDoor струна
frontendEndpoints Интерфейсные конечные точки, доступные для правил маршрутизации. FrontendEndpoint[]
healthProbeSettings Параметры пробы работоспособности, связанные с этим экземпляром Front Door. HealthProbeSettingsModel[]
loadBalancingSettings Параметры балансировки нагрузки, связанные с этим экземпляром Front Door. LoadBalancingSettingsModel[]
routingRules Правила маршрутизации, связанные с этой Front Door. МаршрутизацияRule[]

FrontendEndpoint

Имя Описание Ценность
идентификатор Идентификатор ресурса. струна
имя Имя ресурса. струна
свойства Свойства конечной точки frontend FrontendPointProperties

Свойства FrontendEndpoint

Имя Описание Ценность
имя хоста Имя узла frontendEndpoint. Должно быть доменным именем. струна
sessionAffinityEnabledState Следует ли разрешать сходство сеансов на этом узле. Допустимые параметры: "Включено" или "Отключено" "Отключено"
"Включено"
sessionAffinityTtlSeconds НЕИСПОЛЬЗОВАННЫЙ. Это поле будет игнорироваться. TTL, используемый в секундах для сопоставления сеансов, если применимо. инт
webApplicationFirewallPolicyLink Определяет политику брандмауэра веб-приложения для каждого узла (если применимо) FrontendEndpointUpdateParametersWebApplicationFirewallPolicyLink
Имя Описание Ценность
идентификатор Идентификатор ресурса. струна

HealthProbeSettingsModel

Имя Описание Ценность
идентификатор Идентификатор ресурса. струна
имя Имя ресурса. струна
свойства Свойства параметров пробы работоспособности HealthProbeSettingsProperties

HealthProbeSettingsProperties

Имя Описание Ценность
enabledState Следует ли включить пробы работоспособности для серверных серверных служб, определенных в серверной части. Пробы работоспособности могут быть отключены только в том случае, если в одном серверном пуле включена одна включенная серверная часть. "Отключено"
"Включено"
метод healthProbeMethod Настраивает метод HTTP, используемый для проверки внутренних серверных компонентов, определенных в серверной части. Get
"HEAD"
интервалВСекундах Количество секунд между пробами работоспособности. инт
путь Путь к использованию для пробы работоспособности. Значение по умолчанию — // струна
протокол Схема протокола, используемая для этой пробы "Http"
"Https"

LoadBalancingSettingsModel

Имя Описание Ценность
идентификатор Идентификатор ресурса. струна
имя Имя ресурса. струна
свойства Свойства параметров балансировки нагрузки LoadBalancingSettingsProperties

LoadBalancingSettingsProperties

Имя Описание Ценность
additionalLatencyMilliseconds Дополнительная задержка в миллисекундах для зондов для падения в контейнер с наименьшей задержкой инт
sampleSize Количество примеров, которые следует учитывать при принятии решений по балансировке нагрузки инт
успешныеСэмплыОбязательные Количество выборок в течение примера периода, который должен завершиться успешно инт

ПеренаправлениеКонфигурация

Имя Описание Ценность
@odata.type "#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration" (обязательный)
пользовательский фрагмент Фрагмент для добавления в URL-адрес перенаправления. Фрагмент является частью URL-адреса, который поступает после #. Не включайте #. струна
customHost Узел для перенаправления. Оставьте пустым, чтобы использовать входящий узел в качестве конечного узла. струна
customPath Полный путь для перенаправления. Путь не может быть пустым и должен начинаться с /. Оставьте пустым путь, чтобы использовать входящий путь в качестве пути назначения. струна
customQueryString Набор строк запроса, которые необходимо поместить в URL-адрес перенаправления. Задание этого значения заменит любую существующую строку запроса; Оставьте пустым, чтобы сохранить входящие строки запроса. Строка запроса должна находиться в <ключе>=<формате>. Первый ? и & будут добавлены автоматически, поэтому не включать их в передний план, но разделяйте несколько строк запроса с &. струна
redirectProtocol Протокол назначения, в который перенаправляется трафик HttpOnly
HttpsOnly
MatchRequest
redirectType Тип перенаправления, используемый правилом при перенаправлении трафика. "Найдено"
"Перемещено"
"PermanentRedirect"
"ВременныйRedirect"

Теги ресурса

Имя Описание Ценность

Конфигурация маршрута

Имя Описание Ценность
@odata.type Установите значение "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration" для типа ForwardingConfiguration. Установите значение "#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration" для типа RedirectConfiguration. '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration'
"#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration" (обязательный)

Правило маршрутизации

Имя Описание Ценность
идентификатор Идентификатор ресурса. струна
имя Имя ресурса. струна
свойства Свойства правила маршрутизации Front Door Свойства правила маршрутизации

Свойства правила маршрутизации

Имя Описание Ценность
принятыПротоколы Схемы протокола, соответствующие этому правилу Массив строк, содержащий любой из:
"Http"
"Https"
enabledState Следует ли включить использование этого правила. Допустимые значения: "Включено" или "Отключено" "Отключено"
"Включено"
frontendEndpoints Интерфейсные конечные точки, связанные с этим правилом Подресурс[]
patternsToMatch Шаблоны маршрутов правила. строка[]
routeConfiguration Ссылка на конфигурацию маршрутизации. Конфигурация маршрута
rulesEngine Ссылка на определенную конфигурацию обработчика правил для применения к этому маршруту. Подресурс
webApplicationFirewallPolicyLink Определяет политику брандмауэра веб-приложения для каждого правила маршрутизации (если применимо) RoutingRuleUpdateParametersWebApplicationFirewallPolicyLink
Имя Описание Ценность
идентификатор Идентификатор ресурса. струна

Подресурс

Имя Описание Ценность
идентификатор Идентификатор ресурса. струна