Udostępnij przez

az network front-door routing-rule

Note

Ta dokumentacja jest częścią rozszerzenia front door dla interfejsu wiersza polecenia platformy Azure (wersja 2.70.0 lub nowsza). Rozszerzenie zostanie automatycznie zainstalowane po pierwszym uruchomieniu polecenia az network front-door routing-rule. Dowiedz się więcej o rozszerzeniach.

Zarządzanie regułami routingu usługi Front Door.

Polecenia

Nazwa Opis Typ Stan
az network front-door routing-rule create

Utwórz regułę routingu usługi Front Door.

 Extension ogólna dostępność
az network front-door routing-rule delete

Usuń regułę routingu usługi Front Door.

 Extension ogólna dostępność
az network front-door routing-rule list

Wyświetlanie listy reguł routingu usługi Front Door.

 Extension ogólna dostępność
az network front-door routing-rule show

Uzyskaj szczegółowe informacje o regule routingu usługi Front Door.

 Extension ogólna dostępność
az network front-door routing-rule update

Zaktualizuj regułę routingu usługi Front Door.

 Extension ogólna dostępność

az network front-door routing-rule create

Utwórz regułę routingu usługi Front Door.

Utwórz regułę routingu usługi Front Door, aby przekazać żądania do zaplecza lub przekierować użytkowników do innego adresu URL.

Przykład 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

Przykład 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 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]

Parametry wymagane

--front-door-name -f

Nazwa usługi Front Door.

--frontend-endpoints

Rozdzielona spacjami lista nazw punktów końcowych frontonu lub identyfikatorów.

--name -n

Nazwa reguły routingu.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

--route-type

Typ trasy w celu zdefiniowania sposobu obsługi żądań dla tej trasy przez usługę Front Door, tj. przekazywania ich do zaplecza lub przekierowywania użytkowników do innego adresu URL.

Właściwość Wartość
Grupa parametrów: Routing Rule Arguments
Dopuszczalne wartości: Forward, Redirect

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--accepted-protocols

Rozdzielona spacjami lista protokołów do zaakceptowania. Ustawienie domyślne: Http.

--backend-pool

Nazwa lub identyfikator puli zaplecza. Należy utworzyć regułę routingu do przodu.

Właściwość Wartość
Grupa parametrów: Forward Routing Rule Arguments
--cache-duration

Czas trwania, dla którego zawartość musi być buforowana. Dozwolony format to czas trwania ISO 8601.

Właściwość Wartość
Grupa parametrów: Forward Routing Rule Arguments
--caching

Czy włączyć buforowanie dla tej trasy.

Właściwość Wartość
Grupa parametrów: Forward Routing Rule Arguments
Dopuszczalne wartości: Disabled, Enabled
--custom-forwarding-path

Ścieżka niestandardowa używana do ponownego zapisywania ścieżek zasobów dopasowanych przez tę regułę. Pozostaw wartość pustą, aby użyć ścieżki przychodzącej.

Właściwość Wartość
Grupa parametrów: Forward Routing Rule Arguments
--custom-fragment

Fragment do dodania do adresu URL przekierowania. Fragment jest częścią adresu URL, który pojawia się po pliku #. Nie dołączaj pliku #.

Właściwość Wartość
Grupa parametrów: Redirect Routing Rule Arguments
--custom-host

Host do przekierowania. Pozostaw wartość pustą, aby użyć hosta przychodzącego jako hosta docelowego.

Właściwość Wartość
Grupa parametrów: Redirect Routing Rule Arguments
--custom-path

Pełna ścieżka do przekierowania. Ścieżka nie może być pusta i musi zaczynać się od /. Pozostaw wartość pustą, aby użyć ścieżki przychodzącej jako ścieżki docelowej.

Właściwość Wartość
Grupa parametrów: Redirect Routing Rule Arguments
--custom-query-string

Zestaw ciągów zapytania do umieszczenia w adresie URL przekierowania. Ustawienie tej wartości spowoduje zastąpienie dowolnego istniejącego ciągu zapytania; pozostaw wartość pustą, aby zachować przychodzący ciąg zapytania. Ciąg zapytania musi być w formacie <key>=<value>. Pierwszy ? i & zostaną dodane automatycznie, więc nie dołączaj ich do przodu, ale oddzielaj wiele ciągów zapytania za pomocą &.

Właściwość Wartość
Grupa parametrów: Redirect Routing Rule Arguments
--disabled

Utwórz w stanie wyłączonym.

Właściwość Wartość
Dopuszczalne wartości: false, true
--dynamic-compression

Użyj kompresji dynamicznej dla buforowanej zawartości.

Właściwość Wartość
Grupa parametrów: Forward Routing Rule Arguments
Dopuszczalne wartości: Disabled, Enabled
--forwarding-protocol

Protokół używany do przesyłania dalej ruchu.

Właściwość Wartość
Grupa parametrów: Forward Routing Rule Arguments
Dopuszczalne wartości: HttpOnly, HttpsOnly, MatchRequest
--patterns

Rozdzielona spacjami lista wzorców do dopasowania. Wartość domyślna: '/*'.

--query-parameter-strip-directive

Traktowanie terminów zapytania adresu URL podczas tworzenia klucza pamięci podręcznej.

Właściwość Wartość
Grupa parametrów: Forward Routing Rule Arguments
Dopuszczalne wartości: StripAll, StripAllExcept, StripNone, StripOnly
--query-parameters

Parametry zapytania do uwzględnienia lub wykluczenia (rozdzielone przecinkami) w przypadku używania odpowiednio typu dyrektywy StripAllExcept lub StripOnly parametr-parametr-zapytania.

Właściwość Wartość
Grupa parametrów: Forward Routing Rule Arguments
--redirect-protocol

Protokół miejsca docelowego, do którego jest przekierowywany ruch.

Właściwość Wartość
Grupa parametrów: Redirect Routing Rule Arguments
Domyślna wartość: MatchRequest
Dopuszczalne wartości: HttpOnly, HttpsOnly, MatchRequest
--redirect-type

Typ przekierowania, który będzie używany podczas przekierowywania ruchu.

Właściwość Wartość
Grupa parametrów: Redirect Routing Rule Arguments
Domyślna wartość: Moved
Dopuszczalne wartości: Found, Moved, PermanentRedirect, TemporaryRedirect
--rules-engine

Nazwa lub identyfikator konfiguracji aparatu reguł. Aby odłączyć właściwość , "--remove rulesEngine".

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az network front-door routing-rule delete

Usuń regułę routingu usługi Front Door.

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

Parametry wymagane

--front-door-name -f

Nazwa usługi Front Door.

--name -n

Nazwa reguły routingu.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az network front-door routing-rule list

Wyświetlanie listy reguł routingu usługi Front Door.

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

Parametry wymagane

--front-door-name -f

Nazwa usługi Front Door.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az network front-door routing-rule show

Uzyskaj szczegółowe informacje o regule routingu usługi Front Door.

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

Parametry wymagane

--front-door-name -f

Nazwa usługi Front Door.

--name -n

Nazwa reguły routingu.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az network front-door routing-rule update

Zaktualizuj regułę routingu usługi 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]

Parametry wymagane

--front-door-name -f

Nazwa usługi Front Door.

--name -n

Nazwa reguły routingu.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--accepted-protocols

Rozdzielona spacjami lista protokołów do zaakceptowania. Ustawienie domyślne: Http.

--add

Dodaj obiekt do listy obiektów, określając pary ścieżki i wartości klucza. Przykład: --add property.listProperty <key=value, string or JSON string>.

Właściwość Wartość
Grupa parametrów: Generic Update Arguments
Domyślna wartość: []
--backend-pool

Nazwa lub identyfikator puli zaplecza. Należy utworzyć regułę routingu do przodu.

Właściwość Wartość
Grupa parametrów: Forward Routing Rule Arguments
--cache-duration

Czas trwania, dla którego zawartość musi być buforowana. Dozwolony format to czas trwania ISO 8601.

Właściwość Wartość
Grupa parametrów: Forward Routing Rule Arguments
--caching

Czy włączyć buforowanie dla tej trasy.

Właściwość Wartość
Grupa parametrów: Forward Routing Rule Arguments
Dopuszczalne wartości: Disabled, Enabled
--custom-forwarding-path

Ścieżka niestandardowa używana do ponownego zapisywania ścieżek zasobów dopasowanych przez tę regułę. Pozostaw wartość pustą, aby użyć ścieżki przychodzącej.

Właściwość Wartość
Grupa parametrów: Forward Routing Rule Arguments
--custom-fragment

Fragment do dodania do adresu URL przekierowania. Fragment jest częścią adresu URL, który pojawia się po pliku #. Nie dołączaj pliku #.

Właściwość Wartość
Grupa parametrów: Redirect Routing Rule Arguments
--custom-host

Host do przekierowania. Pozostaw wartość pustą, aby użyć hosta przychodzącego jako hosta docelowego.

Właściwość Wartość
Grupa parametrów: Redirect Routing Rule Arguments
--custom-path

Pełna ścieżka do przekierowania. Ścieżka nie może być pusta i musi zaczynać się od /. Pozostaw wartość pustą, aby użyć ścieżki przychodzącej jako ścieżki docelowej.

Właściwość Wartość
Grupa parametrów: Redirect Routing Rule Arguments
--custom-query-string

Zestaw ciągów zapytania do umieszczenia w adresie URL przekierowania. Ustawienie tej wartości spowoduje zastąpienie dowolnego istniejącego ciągu zapytania; pozostaw wartość pustą, aby zachować przychodzący ciąg zapytania. Ciąg zapytania musi być w formacie <key>=<value>. Pierwszy ? i & zostaną dodane automatycznie, więc nie dołączaj ich do przodu, ale oddzielaj wiele ciągów zapytania za pomocą &.

Właściwość Wartość
Grupa parametrów: Redirect Routing Rule Arguments
--dynamic-compression

Użyj kompresji dynamicznej dla buforowanej zawartości.

Właściwość Wartość
Grupa parametrów: Forward Routing Rule Arguments
Dopuszczalne wartości: Disabled, Enabled
--enabled

Stan włączone.

Właściwość Wartość
Grupa parametrów: Probe Setting Arguments
Dopuszczalne wartości: Disabled, Enabled
--force-string

W przypadku używania polecenia "set" lub "add" zachowaj literały ciągu zamiast próbować konwertować na format JSON.

Właściwość Wartość
Grupa parametrów: Generic Update Arguments
Domyślna wartość: False
--forwarding-protocol

Protokół używany do przesyłania dalej ruchu.

Właściwość Wartość
Grupa parametrów: Forward Routing Rule Arguments
Dopuszczalne wartości: HttpOnly, HttpsOnly, MatchRequest
--frontend-endpoints

Rozdzielona spacjami lista nazw punktów końcowych frontonu lub identyfikatorów.

--patterns

Rozdzielona spacjami lista wzorców do dopasowania. Wartość domyślna: '/*'.

--query-parameter-strip-directive

Traktowanie terminów zapytania adresu URL podczas tworzenia klucza pamięci podręcznej.

Właściwość Wartość
Grupa parametrów: Forward Routing Rule Arguments
Dopuszczalne wartości: StripAll, StripAllExcept, StripNone, StripOnly
--query-parameters

Parametry zapytania do uwzględnienia lub wykluczenia (rozdzielone przecinkami) w przypadku używania odpowiednio typu dyrektywy StripAllExcept lub StripOnly parametr-parametr-zapytania.

Właściwość Wartość
Grupa parametrów: Forward Routing Rule Arguments
--redirect-protocol

Protokół miejsca docelowego, do którego jest przekierowywany ruch.

Właściwość Wartość
Grupa parametrów: Redirect Routing Rule Arguments
Dopuszczalne wartości: HttpOnly, HttpsOnly, MatchRequest
--redirect-type

Typ przekierowania, który będzie używany podczas przekierowywania ruchu.

Właściwość Wartość
Grupa parametrów: Redirect Routing Rule Arguments
Dopuszczalne wartości: Found, Moved, PermanentRedirect, TemporaryRedirect
--remove

Usuń właściwość lub element z listy. Przykład: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Właściwość Wartość
Grupa parametrów: Generic Update Arguments
Domyślna wartość: []
--rules-engine

Nazwa lub identyfikator konfiguracji aparatu reguł. Aby odłączyć właściwość , "--remove rulesEngine".

--set

Zaktualizuj obiekt, określając ścieżkę właściwości i wartość do ustawienia. Przykład: --set property1.property2=<value>.

Właściwość Wartość
Grupa parametrów: Generic Update Arguments
Domyślna wartość: []
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False