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

az network front-door routing-rule

Note

This reference is part of the front-door extension for the Azure CLI (version 2.67.0 or higher). Расширение будет автоматически устанавливаться при первом запуске команды az network front-door routing-rule. Learn more about extensions.

Управление правилами маршрутизации Front Door.

Команды

Имя Описание Тип Состояние
az network front-door routing-rule create

Создайте правило маршрутизации Front Door.

 Extension GA
az network front-door routing-rule delete

Удалите правило маршрутизации Front Door.

 Extension GA
az network front-door routing-rule list

Список правил маршрутизации Front Door.

 Extension GA
az network front-door routing-rule show

Получение сведений о правиле маршрутизации Front Door.

 Extension GA
az network front-door routing-rule update

Обновите правило маршрутизации Front Door.

 Extension GA

az network front-door routing-rule create

Создайте правило маршрутизации Front Door.

Создайте правило маршрутизации Front Door, чтобы пересылать запросы на серверную часть или перенаправить пользователей на другой URL-адрес.

Пример 1. az network front-door routing-rule create -f frontdoor1 -g rg1 --frontend-endpoints DefaultFrontendEndPoint --route-type Forward --backend-pool DefaultBackendPool -n forwardRoutingrule1 --patterns /forward1

Пример 2. az network front-door routing-rule create -f frontdoor1 -g rg1 --frontend-endpoints DefaultFrontendEndPoint --route-type Redirect --custom-host redirecthost.com -n redirectRouteRule1 --patterns /redirect1 --custom-query-string querystring.

az network front-door routing-rule create --front-door-name
                                          --frontend-endpoints
                                          --name
                                          --resource-group
                                          --route-type {Forward, Redirect}
                                          [--accepted-protocols]
                                          [--backend-pool]
                                          [--cache-duration]
                                          [--caching {Disabled, Enabled}]
                                          [--custom-forwarding-path]
                                          [--custom-fragment]
                                          [--custom-host]
                                          [--custom-path]
                                          [--custom-query-string]
                                          [--disabled {false, true}]
                                          [--dynamic-compression {Disabled, Enabled}]
                                          [--forwarding-protocol {HttpOnly, HttpsOnly, MatchRequest}]
                                          [--patterns]
                                          [--query-parameter-strip-directive {StripAll, StripAllExcept, StripNone, StripOnly}]
                                          [--query-parameters]
                                          [--redirect-protocol {HttpOnly, HttpsOnly, MatchRequest}]
                                          [--redirect-type {Found, Moved, PermanentRedirect, TemporaryRedirect}]
                                          [--rules-engine]

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

--front-door-name -f

Имя Front Door.

--frontend-endpoints

Разделенный пробелами список имен внешних конечных точек или идентификаторов.

--name -n

Имя правила маршрутизации.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--route-type

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

Свойство Значение
Parameter group: Routing Rule Arguments
Допустимые значения: Forward, Redirect

Необязательные параметры

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--accepted-protocols

Разделенный пробелами список протоколов для принятия. Default: Http.

--backend-pool

Имя или идентификатор внутреннего пула. Для создания правила маршрутизации пересылки требуется.

Свойство Значение
Parameter group: Forward Routing Rule Arguments
--cache-duration

Длительность кэширования содержимого. Допустимый формат — длительность ISO 8601.

Свойство Значение
Parameter group: Forward Routing Rule Arguments
--caching

Следует ли включить кэширование для этого маршрута.

Свойство Значение
Parameter group: Forward Routing Rule Arguments
Допустимые значения: Disabled, Enabled
--custom-forwarding-path

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

Свойство Значение
Parameter group: Forward Routing Rule Arguments
--custom-fragment

Фрагмент для добавления в URL-адрес перенаправления. Фрагмент является частью URL-адреса, который поступает после #. Не включайте #.

Свойство Значение
Parameter group: Redirect Routing Rule Arguments
--custom-host

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

Свойство Значение
Parameter group: Redirect Routing Rule Arguments
--custom-path

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

Свойство Значение
Parameter group: Redirect Routing Rule Arguments
--custom-query-string

Набор строк запроса, которые необходимо поместить в URL-адрес перенаправления. Задание этого значения заменит любую существующую строку запроса; Оставьте пустым, чтобы сохранить входящие строки запроса. Строка запроса должна быть в формате <key>=<value>. Первый ? и & будут добавлены автоматически, поэтому не включать их в передний план, но разделяйте несколько строк запроса с &.

Свойство Значение
Parameter group: Redirect Routing Rule Arguments
--disabled

Создайте в отключенном состоянии.

Свойство Значение
Допустимые значения: false, true
--dynamic-compression

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

Свойство Значение
Parameter group: Forward Routing Rule Arguments
Допустимые значения: Disabled, Enabled
--forwarding-protocol

Протокол для переадресации трафика.

Свойство Значение
Parameter group: Forward Routing Rule Arguments
Допустимые значения: HttpOnly, HttpsOnly, MatchRequest
--patterns

Разделенный пробелами список шаблонов для сопоставления. Default: '/*'.

--query-parameter-strip-directive

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

Свойство Значение
Parameter group: Forward Routing Rule Arguments
Допустимые значения: StripAll, StripAllExcept, StripNone, StripOnly
--query-parameters

Параметры запроса, которые необходимо включить или исключить (разделенные запятыми) при использовании типа StripAllExcept или StripOnly соответственно с помощью параметра query-parameter-strip-директивы.

Свойство Значение
Parameter group: Forward Routing Rule Arguments
--redirect-protocol

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

Свойство Значение
Parameter group: Redirect Routing Rule Arguments
Default value: MatchRequest
Допустимые значения: HttpOnly, HttpsOnly, MatchRequest
--redirect-type

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

Свойство Значение
Parameter group: Redirect Routing Rule Arguments
Default value: Moved
Допустимые значения: Found, Moved, PermanentRedirect, TemporaryRedirect
--rules-engine

Имя или идентификатор конфигурации обработчика правил. Чтобы отменить связывание свойства, "-remove rulesEngine".

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

Output format.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az network front-door routing-rule delete

Удалите правило маршрутизации Front Door.

az network front-door routing-rule delete --front-door-name
                                          --name
                                          --resource-group

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

--front-door-name -f

Имя Front Door.

--name -n

Имя правила маршрутизации.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

Output format.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az network front-door routing-rule list

Список правил маршрутизации Front Door.

az network front-door routing-rule list --front-door-name
                                        --resource-group

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

--front-door-name -f

Имя Front Door.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

Output format.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az network front-door routing-rule show

Получение сведений о правиле маршрутизации Front Door.

az network front-door routing-rule show --front-door-name
                                        --name
                                        --resource-group

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

--front-door-name -f

Имя Front Door.

--name -n

Имя правила маршрутизации.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

Output format.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az network front-door routing-rule update

Обновите правило маршрутизации Front Door.

az network front-door routing-rule update --front-door-name
                                          --name
                                          --resource-group
                                          [--accepted-protocols]
                                          [--add]
                                          [--backend-pool]
                                          [--cache-duration]
                                          [--caching {Disabled, Enabled}]
                                          [--custom-forwarding-path]
                                          [--custom-fragment]
                                          [--custom-host]
                                          [--custom-path]
                                          [--custom-query-string]
                                          [--dynamic-compression {Disabled, Enabled}]
                                          [--enabled {Disabled, Enabled}]
                                          [--force-string]
                                          [--forwarding-protocol {HttpOnly, HttpsOnly, MatchRequest}]
                                          [--frontend-endpoints]
                                          [--patterns]
                                          [--query-parameter-strip-directive {StripAll, StripAllExcept, StripNone, StripOnly}]
                                          [--query-parameters]
                                          [--redirect-protocol {HttpOnly, HttpsOnly, MatchRequest}]
                                          [--redirect-type {Found, Moved, PermanentRedirect, TemporaryRedirect}]
                                          [--remove]
                                          [--rules-engine]
                                          [--set]

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

--front-door-name -f

Имя Front Door.

--name -n

Имя правила маршрутизации.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Необязательные параметры

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--accepted-protocols

Разделенный пробелами список протоколов для принятия. Default: Http.

--add

Добавьте объект в список объектов, указав пары пути и значения ключа. Пример: --add property.listProperty <key=value, string or JSON string>.

Свойство Значение
Parameter group: Generic Update Arguments
Default value: []
--backend-pool

Имя или идентификатор внутреннего пула. Для создания правила маршрутизации пересылки требуется.

Свойство Значение
Parameter group: Forward Routing Rule Arguments
--cache-duration

Длительность кэширования содержимого. Допустимый формат — длительность ISO 8601.

Свойство Значение
Parameter group: Forward Routing Rule Arguments
--caching

Следует ли включить кэширование для этого маршрута.

Свойство Значение
Parameter group: Forward Routing Rule Arguments
Допустимые значения: Disabled, Enabled
--custom-forwarding-path

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

Свойство Значение
Parameter group: Forward Routing Rule Arguments
--custom-fragment

Фрагмент для добавления в URL-адрес перенаправления. Фрагмент является частью URL-адреса, который поступает после #. Не включайте #.

Свойство Значение
Parameter group: Redirect Routing Rule Arguments
--custom-host

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

Свойство Значение
Parameter group: Redirect Routing Rule Arguments
--custom-path

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

Свойство Значение
Parameter group: Redirect Routing Rule Arguments
--custom-query-string

Набор строк запроса, которые необходимо поместить в URL-адрес перенаправления. Задание этого значения заменит любую существующую строку запроса; Оставьте пустым, чтобы сохранить входящие строки запроса. Строка запроса должна быть в формате <key>=<value>. Первый ? и & будут добавлены автоматически, поэтому не включать их в передний план, но разделяйте несколько строк запроса с &.

Свойство Значение
Parameter group: Redirect Routing Rule Arguments
--dynamic-compression

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

Свойство Значение
Parameter group: Forward Routing Rule Arguments
Допустимые значения: Disabled, Enabled
--enabled

Enabled status.

Свойство Значение
Parameter group: Probe Setting Arguments
Допустимые значения: Disabled, Enabled
--force-string

При использовании "set" или "add" сохраняйте строковые литералы вместо попытки преобразовать в JSON.

Свойство Значение
Parameter group: Generic Update Arguments
Default value: False
--forwarding-protocol

Протокол для переадресации трафика.

Свойство Значение
Parameter group: Forward Routing Rule Arguments
Допустимые значения: HttpOnly, HttpsOnly, MatchRequest
--frontend-endpoints

Разделенный пробелами список имен внешних конечных точек или идентификаторов.

--patterns

Разделенный пробелами список шаблонов для сопоставления. Default: '/*'.

--query-parameter-strip-directive

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

Свойство Значение
Parameter group: Forward Routing Rule Arguments
Допустимые значения: StripAll, StripAllExcept, StripNone, StripOnly
--query-parameters

Параметры запроса, которые необходимо включить или исключить (разделенные запятыми) при использовании типа StripAllExcept или StripOnly соответственно с помощью параметра query-parameter-strip-директивы.

Свойство Значение
Parameter group: Forward Routing Rule Arguments
--redirect-protocol

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

Свойство Значение
Parameter group: Redirect Routing Rule Arguments
Допустимые значения: HttpOnly, HttpsOnly, MatchRequest
--redirect-type

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

Свойство Значение
Parameter group: Redirect Routing Rule Arguments
Допустимые значения: Found, Moved, PermanentRedirect, TemporaryRedirect
--remove

Удалите свойство или элемент из списка. Пример: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Свойство Значение
Parameter group: Generic Update Arguments
Default value: []
--rules-engine

Имя или идентификатор конфигурации обработчика правил. Чтобы отменить связывание свойства, "-remove rulesEngine".

--set

Обновите объект, указав путь к свойству и значение для задания. Пример: --set property1.property2=<value>.

Свойство Значение
Parameter group: Generic Update Arguments
Default value: []
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

Output format.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False