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

az afd route

  • Ссылка

Управление маршрутами в конечной точке AFD.

Команды

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

Создайте новый маршрут с указанным именем маршрута под указанной подпиской, группой ресурсов, профилем и конечной точкой AzureFrontDoor.

 Основные сведения Общедоступная версия
az afd route delete

Удалите существующий маршрут с указанным именем маршрута под указанной подпиской, группой ресурсов, профилем и конечной точкой AzureFrontDoor.

 Основные сведения Общедоступная версия
az afd route list

Список всех существующих источников в профиле.

 Основные сведения Общедоступная версия
az afd route show

Получите существующий маршрут с указанным именем маршрута под указанной подпиской, группой ресурсов, профилем и конечной точкой AzureFrontDoor.

 Основные сведения Общедоступная версия
az afd route update

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

 Основные сведения Общедоступная версия
az afd route wait

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

 Основные сведения Общедоступная версия

az afd route create

Создайте новый маршрут с указанным именем маршрута под указанной подпиской, группой ресурсов, профилем и конечной точкой AzureFrontDoor.

az afd route create --endpoint-name
                    --name
                    --profile-name
                    --resource-group
                    [--content-types-to-compress]
                    [--custom-domains]
                    [--enable-caching {0, 1, f, false, n, no, t, true, y, yes}]
                    [--enable-compression {0, 1, f, false, n, no, t, true, y, yes}]
                    [--enabled-state {Disabled, Enabled}]
                    [--forwarding-protocol {HttpOnly, HttpsOnly, MatchRequest}]
                    [--https-redirect {Disabled, Enabled}]
                    [--link-to-default-domain {Disabled, Enabled}]
                    [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                    [--origin-group]
                    [--origin-path]
                    [--patterns-to-match]
                    [--query-parameters]
                    [--query-string-caching-behavior]
                    [--rule-sets]
                    [--supported-protocols]

Примеры

Создает маршрут для связывания домена конечной точки по умолчанию с группой источников для всех HTTPS-запросов.

az afd route create -g group --endpoint-name endpoint1 --profile-name profile --route-name route1 --https-redirect Disabled --origin-group og001 --supported-protocols Https --link-to-default-domain Enabled --forwarding-protocol MatchRequest

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

az afd route create -g group --endpoint-name endpoint1 --profile-name profile --route-name route1 --rule-sets ruleset1 rulseset2 --origin-group og001 --supported-protocols Http Https --link-to-default-domain Enabled --forwarding-protocol MatchRequest --https-redirect Disabled

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

az afd route create -g group --endpoint-name endpoint1 --profile-name profile --route-name route1 --patterns-to-match /test1/* /tes2/* --origin-group og001 --supported-protocols Http Https --custom-domains cd001 --forwarding-protocol MatchRequest --https-redirect Enabled --link-to-default-domain Enabled

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

--endpoint-name

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

--name --route-name -n

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

--profile-name

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

--resource-group -g

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

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

--content-types-to-compress

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

--custom-domains

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

--enable-caching

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

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

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

допустимые значения: 0, 1, f, false, n, no, t, true, y, yes
--enabled-state

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

допустимые значения: Disabled, Enabled
--forwarding-protocol

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

допустимые значения: HttpOnly, HttpsOnly, MatchRequest
значение по умолчанию: MatchRequest
--https-redirect

Следует ли автоматически перенаправлять HTTP-трафик в трафик HTTPS. Обратите внимание, что это простой способ настройки этого правила, и это будет первое правило, которое выполняется.

допустимые значения: Disabled, Enabled
значение по умолчанию: Disabled
--link-to-default-domain

Будет ли этот маршрут связан с доменом конечной точки по умолчанию.

допустимые значения: Disabled, Enabled
значение по умолчанию: Disabled
--no-wait

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

допустимые значения: 0, 1, f, false, n, no, t, true, y, yes
--origin-group

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

--origin-path

Путь к каталогу в источнике, который AzureFrontDoor может использовать для получения содержимого, например contoso.cloudapp.net/originpath.

--patterns-to-match

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

--query-parameters

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

--query-string-caching-behavior

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

--rule-sets

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

--supported-protocols

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

значение по умолчанию: ['Http', 'Https']
Глобальные параметры
--debug

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

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

--subscription

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

--verbose

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

az afd route delete

Удалите существующий маршрут с указанным именем маршрута под указанной подпиской, группой ресурсов, профилем и конечной точкой AzureFrontDoor.

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

Примеры

Удаление маршрута с именем route1.

az afd route delete -g group --profile-name profile --endpoint-name endpoint1 --route-name route1

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

--endpoint-name

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

--ids

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

--name --route-name -n

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

--no-wait

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

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

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

--resource-group -g

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

--subscription

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

--yes -y

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

значение по умолчанию: False
Глобальные параметры
--debug

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

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

--subscription

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

--verbose

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

az afd route list

Список всех существующих источников в профиле.

az afd route list --endpoint-name
                  --profile-name
                  --resource-group
                  [--max-items]
                  [--next-token]

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

--endpoint-name

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

--profile-name

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

--resource-group -g

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

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

--max-items

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

--next-token

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

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

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

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

--subscription

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

--verbose

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

az afd route show

Получите существующий маршрут с указанным именем маршрута под указанной подпиской, группой ресурсов, профилем и конечной точкой AzureFrontDoor.

az afd route show [--endpoint-name]
                  [--ids]
                  [--name]
                  [--profile-name]
                  [--resource-group]
                  [--subscription]

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

--endpoint-name

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

--ids

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

--name --route-name -n

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

--profile-name

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

--resource-group -g

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

--subscription

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

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

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

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

--subscription

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

--verbose

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

az afd route update

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

az afd route update [--add]
                    [--content-types-to-compress]
                    [--custom-domains]
                    [--enable-caching {0, 1, f, false, n, no, t, true, y, yes}]
                    [--enable-compression {0, 1, f, false, n, no, t, true, y, yes}]
                    [--enabled-state {Disabled, Enabled}]
                    [--endpoint-name]
                    [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                    [--forwarding-protocol {HttpOnly, HttpsOnly, MatchRequest}]
                    [--https-redirect {Disabled, Enabled}]
                    [--ids]
                    [--link-to-default-domain {Disabled, Enabled}]
                    [--name]
                    [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                    [--origin-group]
                    [--origin-path]
                    [--patterns-to-match]
                    [--profile-name]
                    [--query-parameters]
                    [--query-string-caching-behavior]
                    [--remove]
                    [--resource-group]
                    [--rule-sets]
                    [--set]
                    [--subscription]
                    [--supported-protocols]

Примеры

Обновите маршрут, чтобы принять запросы Http и Https и перенаправить все маршруты для использования Https.

az afd route update -g group --endpoint-name endpoint1 --profile-name profile --route-name route1 --supported-protocols Http Https --https-redirect Enabled

Обновите параметры правил маршрута, чтобы настроить поведение маршрута.

az afd route update -g group --endpoint-name endpoint1 --profile-name profile --route-name route1 --rule-sets ruleset1 rulseset2

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

az afd route update -g group --endpoint-name endpoint1 --profile-name profile --route-name route1 --query-string-caching-behavior IgnoreQueryString --enable-compression true --content-types-to-compress text/javascript text/plain

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

--add

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

--content-types-to-compress

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

--custom-domains

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

--enable-caching

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

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

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

допустимые значения: 0, 1, f, false, n, no, t, true, y, yes
--enabled-state

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

допустимые значения: Disabled, Enabled
--endpoint-name

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

--force-string

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

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

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

допустимые значения: HttpOnly, HttpsOnly, MatchRequest
--https-redirect

Следует ли автоматически перенаправлять HTTP-трафик в трафик HTTPS. Обратите внимание, что это простой способ настройки этого правила, и это будет первое правило, которое выполняется.

допустимые значения: Disabled, Enabled
--ids

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

--link-to-default-domain

Будет ли этот маршрут связан с доменом конечной точки по умолчанию.

допустимые значения: Disabled, Enabled
--name --route-name -n

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

--no-wait

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

допустимые значения: 0, 1, f, false, n, no, t, true, y, yes
--origin-group

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

--origin-path

Путь к каталогу в источнике, который AzureFrontDoor может использовать для получения содержимого, например contoso.cloudapp.net/originpath.

--patterns-to-match

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

--profile-name

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

--query-parameters

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

--query-string-caching-behavior

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

--remove

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

--resource-group -g

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

--rule-sets

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

--set

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

--subscription

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

--supported-protocols

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

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

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

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

--subscription

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

--verbose

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

az afd route wait

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

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

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

--created

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

значение по умолчанию: False
--custom

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

--deleted

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

значение по умолчанию: False
--endpoint-name

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

--exists

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

значение по умолчанию: False
--ids

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

--interval

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

значение по умолчанию: 30
--name --route-name -n

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

--profile-name

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

--resource-group -g

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

--subscription

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

--timeout

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

значение по умолчанию: 3600
--updated

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

значение по умолчанию: False
Глобальные параметры
--debug

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

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

--subscription

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

--verbose

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