Действия набора правил

Набор правил Azure Front Door состоит из правил с сочетанием условий соответствия и действий. В этой статье содержится подробное описание действий, которые можно использовать в наборе правил. Действие определяет поведение, применяемое к типу запроса, который идентифицируется условиями соответствия. В наборе правил правило может иметь до пяти действий. Front Door также поддерживает серверные переменные в действии набора правил.

Следующие действия доступны для использования в наборе правил:

Переопределение конфигурации маршрута

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

Вы также можете переопределить способ кэширования файлов для определенных запросов, в том числе:

• Переопределить поведение кэширования, заданное источником.
• Как параметры строки запроса используются для генерации ключа кэша запроса.
• Значение времени жизни (TTL) для управления продолжительностью хранения содержимого в кэше.

Свойства

Если для параметра Переопределить группу источников задано значение Да, установите следующие свойства:

Когда для параметра Кэширование задано значение Включено, установите следующие свойства:

Примеры

В этом примере мы направляем все совпадающие запросы в группу источников MyOriginGroup независимо от конфигурации в маршруте конечной точки Front Door.

{
  "name": "RouteConfigurationOverride",
  "parameters": {
    "originGroupOverride": {
      "originGroup": {
        "id": "/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/Microsoft.Cdn/profiles/<profile-name>/originGroups/MyOriginGroup"
      },
      "forwardingProtocol": "MatchRequest"
    },
    "cacheConfiguration": null,
    "typeName": "DeliveryRuleRouteConfigurationOverrideActionParameters"
  }
}

{
  name: 'RouteConfigurationOverride'
  parameters: {
    originGroupOverride: {
      originGroup: {
        id: '/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/Microsoft.Cdn/profiles/<profile-name>/originGroups/MyOriginGroup'
      }
      forwardingProtocol: 'MatchRequest'
    }
    cacheConfiguration: null
    typeName: 'DeliveryRuleRouteConfigurationOverrideActionParameters'
  }
}

В этом примере мы зададим ключ кэша, включив в него параметр строки запроса с именем customerId. Сжатие включено, и применяются политики кэширования источника.

{
  "name": "RouteConfigurationOverride",
  "parameters": {
    "cacheConfiguration": {
      "queryStringCachingBehavior": "IncludeSpecifiedQueryStrings",
      "queryParameters": "customerId",
      "isCompressionEnabled": "Enabled",
      "cacheBehavior": "HonorOrigin",
      "cacheDuration": null
    },
    "originGroupOverride": null,
    "typeName": "DeliveryRuleRouteConfigurationOverrideActionParameters"
  }
}

{
  name: 'RouteConfigurationOverride'
  parameters: {
    cacheConfiguration: {
      queryStringCachingBehavior: 'IncludeSpecifiedQueryStrings'
      queryParameters: 'customerId'
      isCompressionEnabled: 'Enabled'
      cacheBehavior: 'HonorOrigin'
      cacheDuration: null
    }
    originGroupOverride: null
    typeName: 'DeliveryRuleRouteConfigurationOverrideActionParameters'
  }
}

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

{
  "name": "RouteConfigurationOverride",
  "parameters": {
    "cacheConfiguration": {
      "queryStringCachingBehavior": "IgnoreQueryString",
      "cacheBehavior": "OverrideIfOriginMissing",
      "cacheDuration": "0.06:00:00",
    },
    "originGroupOverride": null,
    "typeName": "DeliveryRuleRouteConfigurationOverrideActionParameters"
  }
}

{
  name: 'RouteConfigurationOverride'
  parameters: {
    cacheConfiguration: {
      queryStringCachingBehavior: 'IgnoreQueryString'
      cacheBehavior: 'OverrideIfOriginMissing'
      cacheDuration: '0.06:00:00'
    }
    originGroupOverride: null
    typeName: 'DeliveryRuleRouteConfigurationOverrideActionParameters'
  }
}

Изменение заголовка запроса

Используйте действие изменить заголовок запроса, чтобы изменить заголовки в запросе при отправке к вашему источнику.

Свойства

Пример

В этом примере мы добавляем значение AdditionalValue в заголовок запроса MyRequestHeader. Если в источнике для заголовка ответа задано значение ValueSetByClient, то после применения этого действия заголовок запроса будет иметь значение ValueSetByClientAdditionalValue.

{
  "name": "ModifyRequestHeader",
  "parameters": {
    "headerAction": "Append",
    "headerName": "MyRequestHeader",
    "value": "AdditionalValue",
    "typeName": "DeliveryRuleHeaderActionParameters"
  }
}

{
  name: 'ModifyRequestHeader'
  parameters: {
    headerAction: 'Append'
    headerName: 'MyRequestHeader'
    value: 'AdditionalValue'
    typeName: 'DeliveryRuleHeaderActionParameters'
  }
}

Изменение заголовка ответа

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

Свойства

Пример

В этом примере мы удаляем заголовок с именем X-Powered-By из ответов, прежде чем они будут возвращены клиенту.

{
  "name": "ModifyResponseHeader",
  "parameters": {
    "headerAction": "Delete",
    "headerName": "X-Powered-By",
    "typeName": "DeliveryRuleHeaderActionParameters"
  }
}

{
  name: 'ModifyResponseHeader'
  parameters: {
    headerAction: 'Delete'
    headerName: 'X-Powered-By'
    typeName: 'DeliveryRuleHeaderActionParameters'
  }
}

Перенаправление URL-адреса

Используйте действие перенаправление URL-адреса для перенаправления клиентов на новый URL-адрес. Клиенты получают ответ перенаправления от Front Door. Azure Front Door поддерживает динамическое захват пути URL-адреса с помощью переменной сервера {url_path:seg#}, и преобразует путь URL-адреса в нижний регистр или верхний регистр с {url_path.tolower} или {url_path.toupper}. Дополнительные сведения см. в разделе "Переменные сервера".

Свойства

Пример

В этом примере мы перенаправим запрос в https://contoso.com/exampleredirection?clientIp={client_ip}, сохранив фрагмент. Используется временное перенаправление HTTP (307). IP-адрес клиента используется вместо маркера {client_ip} в URL-адресе с помощью client_ip.

{
  "name": "UrlRedirect",
  "parameters": {
    "redirectType": "TemporaryRedirect",
    "destinationProtocol": "Https",
    "customHostname": "contoso.com",
    "customPath": "/exampleredirection",
    "customQueryString": "clientIp={client_ip}",
    "typeName": "DeliveryRuleUrlRedirectActionParameters"
  }
}

{
  name: 'UrlRedirect'
  parameters: {
    redirectType: 'TemporaryRedirect'
    destinationProtocol: 'Https'
    customHostname: 'contoso.com'
    customPath: '/exampleredirection'
    customQueryString: 'clientIp={client_ip}'
    typeName: 'DeliveryRuleUrlRedirectActionParameters'
  }
}

Переопределение URL-адресов

Используйте действие переопределение URL-адресов, чтобы перезаписать путь в запросе, который поступает на ваш источник. Azure Front Door поддерживает динамическое захватывание пути URL-адреса с помощью переменной сервера {url_path:seg#} и преобразует путь URL-адреса в строчные или прописные буквы с {url_path.tolower} или {url_path.toupper}. Дополнительные сведения см. в разделе "Переменные сервера".

Свойства

Пример

В этом примере мы переписываем все запросы по пути /redirection, и не сохраняем оставшуюся часть пути.

{
  "name": "UrlRewrite",
  "parameters": {
    "sourcePattern": "/",
    "destination": "/redirection",
    "preserveUnmatchedPath": false,
    "typeName": "DeliveryRuleUrlRewriteActionParameters"
  }
}

{
  name: 'UrlRewrite'
  parameters: {
    sourcePattern: '/'
    destination: '/redirection'
    preserveUnmatchedPath: false
    typeName: 'DeliveryRuleUrlRewriteActionParameters'
  }
}

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

Действие определяет поведение, которое применяется к типу запроса, соответствующему условию или набору условий соответствия. В конфигурации обработчика правил правило может иметь до 10 условий соответствия и 5 действий. В одном правиле может быть только одно действие Переопределить конфигурацию маршрутизации.

Следующие действия доступны для использования в конфигурации обработчика правил.

Изменение заголовка запроса

Используйте эти действия для изменения заголовков, присутствующих в запросах, отправляемых в серверную часть.

Обязательные поля

Изменение заголовка ответа

Используйте эти действия для изменения заголовков, присутствующих в ответах, возвращаемых вашим клиентам.

Обязательные поля

Переопределение конфигурации маршрута

Тип маршрута: перенаправление

Используйте эти действия для перенаправления клиентов на новый URL-адрес.

Обязательные поля

Тип маршрута: прямой

Используйте эти действия для переадресации клиентов на новый URL-адрес. Эти действия также содержат поддействия для перезаписи и кэширования URL-адресов.

Переопределение URL-адресов

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

Кэширование

Используйте эти параметры, чтобы управлять кэшированием файлов для запросов, содержащих строки запросов. Следует ли кэшировать содержимое на основе всех параметров или выбранных параметров. Эти параметры можно использовать для перезаписи времени жизни (TTL) для управления временем хранения содержимого в кэше. Чтобы принудительно выполнить кэширование в качестве действия, задайте для поля "Кэширование" значение "Включено". При принудительном кэшировании отображаются следующие параметры: