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

az afd rule

Управление правилами доставки в указанном наборе правил.

Команды

Имя Описание Тип Состояние
az afd rule action

Управление правилами доставки в указанном наборе правил.

 Core GA
az afd rule action add

Обновите новое правило доставки в указанном наборе правил.

 Core GA
az afd rule action list

Получение существующего правила доставки в наборе правил.

 Core GA
az afd rule action remove

Обновите новое правило доставки в указанном наборе правил.

 Core GA
az afd rule condition

Управление правилами доставки в указанном наборе правил.

 Core GA
az afd rule condition add

Обновите новое правило доставки в указанном наборе правил.

 Core GA
az afd rule condition list

Получение существующего правила доставки в наборе правил.

 Core GA
az afd rule condition remove

Обновите новое правило доставки в указанном наборе правил.

 Core GA
az afd rule create

Создайте новое правило доставки в указанном наборе правил.

 Core GA
az afd rule delete

Удалите существующее правило доставки в наборе правил.

 Core GA
az afd rule list

Список всех существующих правил доставки в наборе правил.

 Core GA
az afd rule show

Получение существующего правила доставки в наборе правил.

 Core GA
az afd rule update

Обновите новое правило доставки в указанном наборе правил.

 Core GA
az afd rule wait

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

 Core GA

az afd rule create

Создайте новое правило доставки в указанном наборе правил.

az afd rule create --name --rule-name
                   --profile-name
                   --resource-group
                   --rule-set-name
                   [--action-name]
                   [--cache-behavior]
                   [--cache-duration]
                   [--custom-fragment]
                   [--custom-hostname]
                   [--custom-path]
                   [--custom-querystring]
                   [--destination]
                   [--enable-caching {0, 1, f, false, n, no, t, true, y, yes}]
                   [--enable-compression {0, 1, f, false, n, no, t, true, y, yes}]
                   [--forwarding-protocol]
                   [--header-action]
                   [--header-name]
                   [--header-value]
                   [--match-processing-behavior {Continue, Stop}]
                   [--match-values]
                   [--match-variable]
                   [--negate-condition {0, 1, f, false, n, no, t, true, y, yes}]
                   [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                   [--operator]
                   [--order]
                   [--origin-group]
                   [--preserve-unmatched-path {0, 1, f, false, n, no, t, true, y, yes}]
                   [--query-parameters]
                   [--query-string-caching-behavior]
                   [--redirect-protocol]
                   [--redirect-type]
                   [--selector]
                   [--source-pattern]
                   [--transforms]

Примеры

Создайте правило, чтобы добавить заголовок ответа для запросов из Таиланда.

az afd rule create -g group --rule-set-name ruleset1 --profile-name profile --order 2 --match-variable RemoteAddress --operator GeoMatch --match-values TH --rule-name disablecaching --action-name ModifyResponseHeader --header-action Append --header-name X-CDN --header-value AFDX

Создание правила для перенаправления http в https

az afd rule create -g group --rule-set-name ruleset1 --profile-name profile --order 1 --rule-name "redirect" --match-variable RequestScheme --operator Equal --match-values HTTP --action-name "UrlRedirect" --redirect-protocol Https --redirect-type Moved

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

--name --rule-name -n

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

--profile-name

Имя профиля Azure Front Door standard или Azure Front Door Premium, уникальное в группе ресурсов.

--resource-group -g

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

--rule-set-name

Имя набора правил в профиле.

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

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

--action-name

Имя действия для правила доставки: https://learn.microsoft.com/en-us/azure/frontdoor/front-door-rules-engine-actions.

--cache-behavior

Поведение кэширования для запросов.

--cache-duration

Длительность кэширования содержимого. Допустимый формат — hh:mm:ss.xxxxxx.

--custom-fragment

Фрагмент для добавления в URL-адрес перенаправления.

--custom-hostname

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

--custom-path

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

--custom-querystring

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

--destination

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

--enable-caching

Указывает, следует ли включить кэширование в маршруте.

Свойство Значение
Допустимые значения: 0, 1, f, false, n, no, t, true, y, yes
--enable-compression

Указывает, включена ли сжатие содержимого в AzureFrontDoor. Значение по умолчанию — false. Если сжатие включено, содержимое будет использоваться в виде сжатия, если запросы пользователей к сжатой версии. Содержимое не сжимается в запрошенном содержимом AzureFrontDoorwhen меньше 8 МБ или больше 1 КБ.

Свойство Значение
Допустимые значения: 0, 1, f, false, n, no, t, true, y, yes
--forwarding-protocol

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

--header-action

Действие заголовка для запросов.

--header-name

Имя заголовка для изменения.

--header-value

Значение заголовка.

--match-processing-behavior

Если это правило соответствует, если подсистема правил продолжит выполнять оставшиеся правила или остановить. Если он отсутствует, по умолчанию используется значение "Продолжить".

Свойство Значение
Группа параметров: Properties Arguments
Default value: Continue
Допустимые значения: Continue, Stop
--match-values

Совпадение значений условия соответствия. Например, разделенные пробелами значения GET 'HTTP'. Поддержка сокращенного синтаксиса, json-file и yaml-file. Попробуйте "??", чтобы показать больше.

--match-variable

Имя условия соответствия: https://learn.microsoft.com/en-us/azure/frontdoor/rules-match-conditions.

--negate-condition

Если значение true, отрицает условие.

Свойство Значение
Допустимые значения: 0, 1, f, false, n, no, t, true, y, yes
--no-wait

Не ожидать завершения длительной операции.

Свойство Значение
Допустимые значения: 0, 1, f, false, n, no, t, true, y, yes
--operator

Оператор условия соответствия.

--order

Порядок применения правил для конечной точки. Возможные значения {0,1,2,3,Ã'â''Â'Ã'â'Â'Â'Ã'â'''Â'}. Правило с меньшим порядком будет применяться перед правилом с большим порядком. Правило с порядком 0 — это специальное правило. Он не требует каких-либо условий и действий, перечисленных в нем, всегда будет применяться.

Свойство Значение
Группа параметров: Properties Arguments
--origin-group

Имя или идентификатор группы OriginGroup, которая переопределит группу originGroup по умолчанию.

--preserve-unmatched-path

Если значение True, оставшийся путь после исходного шаблона будет добавлен в новый путь назначения.

Свойство Значение
Допустимые значения: 0, 1, f, false, n, no, t, true, y, yes
--query-parameters

Параметры запроса для включения или исключения. Поддержка сокращенного синтаксиса, json-file и yaml-file. Попробуйте "??", чтобы показать больше.

--query-string-caching-behavior

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

--redirect-protocol

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

--redirect-type

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

--selector

Селектор условия соответствия.

--source-pattern

Шаблон URI запроса, определяющий тип запросов, которые могут быть перезаписаны.

--transforms

Преобразование, применяемое перед сопоставлением. Поддержка сокращенного синтаксиса, json-file и yaml-file. Попробуйте "??", чтобы показать больше.

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

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

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

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

--only-show-errors

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

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

Формат вывода.

Свойство Значение
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 afd rule delete

Удалите существующее правило доставки в наборе правил.

az afd rule delete [--ids]
                   [--name --rule-name]
                   [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                   [--profile-name]
                   [--resource-group]
                   [--rule-set-name]
                   [--subscription]
                   [--yes]

Примеры

Удалите правило с правилом имени1.

az afd rule delete -g group --rule-set-name ruleSetName --profile-name profile --rule-name rule1

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

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

--ids

Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.

Свойство Значение
Группа параметров: Resource Id Arguments
--name --rule-name -n

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

Свойство Значение
Группа параметров: Resource Id Arguments
--no-wait

Не ожидать завершения длительной операции.

Свойство Значение
Допустимые значения: 0, 1, f, false, n, no, t, true, y, yes
--profile-name

Имя профиля Azure Front Door standard или Azure Front Door Premium, уникальное в группе ресурсов.

Свойство Значение
Группа параметров: Resource Id Arguments
--resource-group -g

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

Свойство Значение
Группа параметров: Resource Id Arguments
--rule-set-name

Имя набора правил в профиле.

Свойство Значение
Группа параметров: Resource Id Arguments
--subscription

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

Свойство Значение
Группа параметров: Resource Id Arguments
--yes -y

Не запрашивать подтверждение.

Свойство Значение
Default value: False
Глобальные параметры
--debug

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

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

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

--only-show-errors

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

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

Формат вывода.

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

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

--verbose

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

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

az afd rule list

Список всех существующих правил доставки в наборе правил.

az afd rule list --profile-name
                 --resource-group
                 --rule-set-name
                 [--max-items]
                 [--next-token]

Примеры

Вывод списка всех маршрутов в указанной конечной точке.

az afd route list -g group --profile-name profile --endpoint-name endpoint1

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

--profile-name

Имя профиля Azure Front Door standard или Azure Front Door Premium, уникальное в группе ресурсов.

--resource-group -g

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

--rule-set-name

Имя набора правил в профиле.

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

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

--max-items

Общее количество элементов, возвращаемых в выходных данных команды. Если общее количество доступных элементов превышает указанное значение, маркер предоставляется в выходных данных команды. Чтобы возобновить разбиение на страницы, укажите значение маркера в --next-token аргументе последующей команды.

Свойство Значение
Группа параметров: Pagination Arguments
--next-token

Маркер, чтобы указать, где начать разбиение на страницы. Это значение маркера из ранее усеченного ответа.

Свойство Значение
Группа параметров: Pagination Arguments
Глобальные параметры
--debug

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

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

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

--only-show-errors

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

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

Формат вывода.

Свойство Значение
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 afd rule show

Получение существующего правила доставки в наборе правил.

az afd rule show [--ids]
                 [--name --rule-name]
                 [--profile-name]
                 [--resource-group]
                 [--rule-set-name]
                 [--subscription]

Примеры

Отображение сведений о правиле доставки с правилом имени1.

az afd rule show -g group --rule-set-name ruleSetName --profile-name profile --rule-name rule1

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

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

--ids

Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.

Свойство Значение
Группа параметров: Resource Id Arguments
--name --rule-name -n

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

Свойство Значение
Группа параметров: Resource Id Arguments
--profile-name

Имя профиля Azure Front Door standard или Azure Front Door Premium, уникальное в группе ресурсов.

Свойство Значение
Группа параметров: Resource Id Arguments
--resource-group -g

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

Свойство Значение
Группа параметров: Resource Id Arguments
--rule-set-name

Имя набора правил в профиле.

Свойство Значение
Группа параметров: Resource Id Arguments
--subscription

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

Свойство Значение
Группа параметров: Resource Id Arguments
Глобальные параметры
--debug

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

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

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

--only-show-errors

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

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

Формат вывода.

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

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

--verbose

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

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

az afd rule update

Обновите новое правило доставки в указанном наборе правил.

az afd rule update [--actions]
                   [--add]
                   [--conditions]
                   [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                   [--ids]
                   [--match-processing-behavior {Continue, Stop}]
                   [--name --rule-name]
                   [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                   [--order]
                   [--profile-name]
                   [--remove]
                   [--resource-group]
                   [--rule-set-name]
                   [--set]
                   [--subscription]

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

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

--actions

Список действий, выполняемых при выполнении всех условий правила. Поддержка сокращенного синтаксиса, json-file и yaml-file. Попробуйте "??", чтобы показать больше.

Свойство Значение
Группа параметров: Properties Arguments
--add

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

Свойство Значение
Группа параметров: Generic Update Arguments
--conditions

Список условий, которые должны соответствовать выполнению действий, которые необходимо выполнить, поддерживают сокращенный синтаксис, json-file и yaml-file. Попробуйте "??", чтобы показать больше.

Свойство Значение
Группа параметров: Properties Arguments
--force-string

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

Свойство Значение
Группа параметров: Generic Update Arguments
Допустимые значения: 0, 1, f, false, n, no, t, true, y, yes
--ids

Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.

Свойство Значение
Группа параметров: Resource Id Arguments
--match-processing-behavior

Если это правило соответствует, если подсистема правил продолжит выполнять оставшиеся правила или остановить. Если он отсутствует, по умолчанию используется значение "Продолжить".

Свойство Значение
Группа параметров: Properties Arguments
Допустимые значения: Continue, Stop
--name --rule-name -n

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

Свойство Значение
Группа параметров: Resource Id Arguments
--no-wait

Не ожидать завершения длительной операции.

Свойство Значение
Допустимые значения: 0, 1, f, false, n, no, t, true, y, yes
--order

Порядок применения правил для конечной точки. Возможные значения {0,1,2,3,Ãã†â€Ãâ'šÃ'Â'Ã'Â'Ãâ'Ã'ã'â ™€šÂ'Ã... Â'Ãâ'ŠÃ'Â'Ãã'Ã'â''Å'Ãâ'ŠÃ'Â'Æâ€Ãâ'ŠÃ'Â'Ã'Â'Ã'Â'Ãâ'Ãâ'Ã'ã'šÂ'à ™... Â'Ãâ'ŠÃ'Â'Ãã'Ã'â''Å'Ãâ'ŠÃ'Â'Æâ€Ãâ'ŠÃ'Â'Ã'Â'Ã'Â'Ãâ'Ãâ'Ã'ã'šÂ'à ™... Â'Ãâ'šÃ'Â'Ãj'Ã'â'Å'Ãã‚Ã'Â'}. Правило с меньшим порядком будет применяться перед правилом с большим порядком. Правило с порядком 0 — это специальное правило. Он не требует каких-либо условий и действий, перечисленных в нем, всегда будет применяться.

Свойство Значение
Группа параметров: Properties Arguments
--profile-name

Имя профиля Azure Front Door standard или Azure Front Door Premium, уникальное в группе ресурсов.

Свойство Значение
Группа параметров: Resource Id Arguments
--remove

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

Свойство Значение
Группа параметров: Generic Update Arguments
--resource-group -g

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

Свойство Значение
Группа параметров: Resource Id Arguments
--rule-set-name

Имя набора правил в профиле.

Свойство Значение
Группа параметров: Resource Id Arguments
--set

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

Свойство Значение
Группа параметров: Generic Update Arguments
--subscription

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

Свойство Значение
Группа параметров: Resource Id Arguments
Глобальные параметры
--debug

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

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

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

--only-show-errors

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

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

Формат вывода.

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

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

--verbose

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

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

az afd rule wait

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

az afd rule wait [--created]
                 [--custom]
                 [--deleted]
                 [--exists]
                 [--ids]
                 [--interval]
                 [--name --rule-name]
                 [--profile-name]
                 [--resource-group]
                 [--rule-set-name]
                 [--subscription]
                 [--timeout]
                 [--updated]

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

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

--created

Подождите, пока не будет создано с помощью provisioningState по адресу "Успешно".

Свойство Значение
Группа параметров: Wait Condition Arguments
Default value: False
--custom

Подождите, пока условие не будет удовлетворено пользовательским запросом JMESPath. Например, provisioningState!='InProgress', instanceView.statuses[?code='PowerState/running'].

Свойство Значение
Группа параметров: Wait Condition Arguments
--deleted

Дождитесь удаления.

Свойство Значение
Группа параметров: Wait Condition Arguments
Default value: False
--exists

Подождите, пока ресурс не существует.

Свойство Значение
Группа параметров: Wait Condition Arguments
Default value: False
--ids

Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.

Свойство Значение
Группа параметров: Resource Id Arguments
--interval

Интервал опроса в секундах.

Свойство Значение
Группа параметров: Wait Condition Arguments
Default value: 30
--name --rule-name -n

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

Свойство Значение
Группа параметров: Resource Id Arguments
--profile-name

Имя профиля Azure Front Door standard или Azure Front Door Premium, уникальное в группе ресурсов.

Свойство Значение
Группа параметров: Resource Id Arguments
--resource-group -g

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

Свойство Значение
Группа параметров: Resource Id Arguments
--rule-set-name

Имя набора правил в профиле.

Свойство Значение
Группа параметров: Resource Id Arguments
--subscription

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

Свойство Значение
Группа параметров: Resource Id Arguments
--timeout

Максимальное ожидание в секундах.

Свойство Значение
Группа параметров: Wait Condition Arguments
Default value: 3600
--updated

Подождите, пока не будет обновлено с помощью provisioningState по адресу "Успешно".

Свойство Значение
Группа параметров: Wait Condition Arguments
Default value: False
Глобальные параметры
--debug

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

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

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

--only-show-errors

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

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

Формат вывода.

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

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

--verbose

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

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