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

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 меньше 8 МБ или больше 1 КБ.

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

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

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

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

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

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

Допустимые значения: Disabled, Enabled
Default value: Disabled
--link-to-default-domain

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

Допустимые значения: Disabled, Enabled
Default value: 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. Попробуйте "??", чтобы показать больше.

Default value: ['Http', 'Https']
Глобальные параметры
--debug

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

--help -h

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

--only-show-errors

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

--output -o

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

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: 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

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

Default value: False
Глобальные параметры
--debug

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

--help -h

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

--only-show-errors

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

--output -o

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

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: 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
Default value: 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
Default value: 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 or 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 меньше 8 МБ или больше 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 <indexToRemove> ИЛИ --remove propertyToRemove.

--resource-group -g

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

--rule-sets

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

--set

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

--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
Default value: 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 по адресу "Успешно".

Default value: False
--custom

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

--deleted

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

Default value: False
--endpoint-name

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

--exists

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

Default value: False
--ids

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

--interval

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

Default value: 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

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

Default value: 3600
--updated

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

Default value: False
Глобальные параметры
--debug

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

--help -h

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

--only-show-errors

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

--output -o

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

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

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

--subscription

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

--verbose

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