Condividi tramite


az spring gateway

Nota

Questo riferimento fa parte dell'estensione spring per l'interfaccia della riga di comando di Azure (versione 2.56.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az spring gateway . Altre informazioni sulle estensioni.

Questo gruppo di comandi è deprecato in modo implicito perché il gruppo di comandi 'spring' è deprecato e verrà rimosso in una versione futura.

(Solo livello Enterprise) Comandi per gestire il gateway in Azure Spring Apps.

Comandi

Nome Descrizione Tipo Status
az spring gateway clear

Cancellare tutte le impostazioni del gateway.

Estensione Deprecated
az spring gateway create

Creare Spring Cloud Gateway.

Estensione Deprecated
az spring gateway custom-domain

Comandi per gestire domini personalizzati per il gateway.

Estensione Deprecated
az spring gateway custom-domain bind

Associare un dominio personalizzato al gateway.

Estensione Deprecated
az spring gateway custom-domain list

Elencare tutti i domini personalizzati del gateway.

Estensione Deprecated
az spring gateway custom-domain show

Mostra i dettagli di un dominio personalizzato.

Estensione Deprecated
az spring gateway custom-domain unbind

Annullare l'associazione di un dominio personalizzato del gateway.

Estensione Deprecated
az spring gateway custom-domain update

Aggiornare un dominio personalizzato del gateway.

Estensione Deprecated
az spring gateway delete

Eliminare Spring Cloud Gateway.

Estensione Deprecated
az spring gateway restart

Riavviare Spring Cloud Gateway.

Estensione Deprecated
az spring gateway route-config

Comandi per gestire le configurazioni di route del gateway in Azure Spring Apps.

Estensione Deprecated
az spring gateway route-config create

Creare una configurazione di route del gateway con regole di routing in formato matrice Json.

Estensione Deprecated
az spring gateway route-config list

Elencare tutte le configurazioni di route del gateway esistenti.

Estensione Deprecated
az spring gateway route-config remove

Eliminare una configurazione di route del gateway esistente.

Estensione Deprecated
az spring gateway route-config show

Ottenere una configurazione di route del gateway esistente.

Estensione Deprecated
az spring gateway route-config update

Aggiornare una configurazione di route del gateway esistente con le regole di routing del formato di matrice Json.

Estensione Deprecated
az spring gateway show

Visualizzare le impostazioni, lo stato del provisioning e lo stato di runtime del gateway.

Estensione Deprecated
az spring gateway sync-cert

Sincronizzare il certificato del gateway.

Estensione Deprecated
az spring gateway update

Aggiornare le proprietà di un gateway esistente.

Estensione Deprecated

az spring gateway clear

Deprecato

Questo comando è deprecato in modo implicito perché il gruppo di comandi 'spring' è deprecato e verrà rimosso in una versione futura.

Cancellare tutte le impostazioni del gateway.

az spring gateway clear --resource-group
                        --service
                        [--no-wait]

Parametri necessari

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

--service -s

Il nome dell'istanza di Azure Spring Apps consente di configurare il servizio predefinito usando az configure --defaults spring=<name>.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Proprietà Valore
Valore predefinito: False
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az spring gateway create

Deprecato

Questo comando è deprecato in modo implicito perché il gruppo di comandi 'spring' è deprecato e verrà rimosso in una versione futura.

Creare Spring Cloud Gateway.

az spring gateway create --resource-group
                         --service
                         [--instance-count]

Esempio

Creare Spring Cloud Gateway.

az spring gateway create -s MyService -g MyResourceGroup --instance-count 2

Parametri necessari

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

--service -s

Il nome dell'istanza di Azure Spring Apps consente di configurare il servizio predefinito usando az configure --defaults spring=<name>.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--instance-count

Numero di istanza.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az spring gateway delete

Deprecato

Questo comando è deprecato in modo implicito perché il gruppo di comandi 'spring' è deprecato e verrà rimosso in una versione futura.

Eliminare Spring Cloud Gateway.

az spring gateway delete --resource-group
                         --service
                         [--yes]

Parametri necessari

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

--service -s

Il nome dell'istanza di Azure Spring Apps consente di configurare il servizio predefinito usando az configure --defaults spring=<name>.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--yes -y

Non richiedere conferma.

Proprietà Valore
Valore predefinito: False
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az spring gateway restart

Deprecato

Questo comando è deprecato in modo implicito perché il gruppo di comandi 'spring' è deprecato e verrà rimosso in una versione futura.

Riavviare Spring Cloud Gateway.

az spring gateway restart --resource-group
                          --service
                          [--no-wait]
                          [--yes]

Esempio

Riavviare Spring Cloud Gateway.

az spring gateway restart -s MyService -g MyResourceGroup

Parametri necessari

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

--service -s

Il nome dell'istanza di Azure Spring Apps consente di configurare il servizio predefinito usando az configure --defaults spring=<name>.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Proprietà Valore
Valore predefinito: False
--yes -y

Non richiedere conferma.

Proprietà Valore
Valore predefinito: False
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az spring gateway show

Deprecato

Questo comando è deprecato in modo implicito perché il gruppo di comandi 'spring' è deprecato e verrà rimosso in una versione futura.

Visualizzare le impostazioni, lo stato del provisioning e lo stato di runtime del gateway.

az spring gateway show --resource-group
                       --service

Parametri necessari

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

--service -s

Il nome dell'istanza di Azure Spring Apps consente di configurare il servizio predefinito usando az configure --defaults spring=<name>.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az spring gateway sync-cert

Deprecato

Questo comando è deprecato in modo implicito perché il gruppo di comandi 'spring' è deprecato e verrà rimosso in una versione futura.

Sincronizzare il certificato del gateway.

az spring gateway sync-cert --resource-group
                            --service
                            [--no-wait]
                            [--yes]

Esempio

Sincronizzare il certificato del gateway.

az spring gateway sync-cert -s MyService -g MyResourceGroup

Parametri necessari

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

--service -s

Il nome dell'istanza di Azure Spring Apps consente di configurare il servizio predefinito usando az configure --defaults spring=<name>.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Proprietà Valore
Valore predefinito: False
--yes -y

Non richiedere conferma.

Proprietà Valore
Valore predefinito: False
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az spring gateway update

Deprecato

Questo comando è deprecato in modo implicito perché il gruppo di comandi 'spring' è deprecato e verrà rimosso in una versione futura.

Aggiornare le proprietà di un gateway esistente.

az spring gateway update --resource-group
                         --service
                         [--addon-configs-file]
                         [--addon-configs-json]
                         [--allow-credentials {false, true}]
                         [--allow-origin-patterns --allowed-origin-patterns]
                         [--allowed-headers]
                         [--allowed-methods]
                         [--allowed-origins]
                         [--api-description]
                         [--api-doc-location]
                         [--api-title]
                         [--api-version]
                         [--apm-types]
                         [--apms]
                         [--assign-endpoint {false, true}]
                         [--certificate-names]
                         [--client-id]
                         [--client-secret]
                         [--cpu]
                         [--enable-cert-verify --enable-certificate-verification {false, true}]
                         [--enable-response-cache {false, true}]
                         [--exposed-headers]
                         [--https-only {false, true}]
                         [--instance-count]
                         [--issuer-uri]
                         [--max-age]
                         [--memory]
                         [--no-wait]
                         [--properties]
                         [--response-cache-scope]
                         [--response-cache-size]
                         [--response-cache-ttl]
                         [--scope]
                         [--secrets]
                         [--server-url]

Esempio

Aggiornare la proprietà del gateway.

az spring gateway update -s MyService -g MyResourceGroup --assign-endpoint true --https-only true

Abilitare e configurare la cache delle risposte a livello di route e impostare ttl su 5 minuti.

az spring gateway update -s MyService -g MyResourceGroup --enable-response-cache --response-cache-scope Route --response-cache-ttl 5m

Quando la cache delle risposte è abilitata, aggiornare ttl a 3 minuti.

az spring gateway update -s MyService -g MyResourceGroup --response-cache-ttl 3m

Disabilitare la cache delle risposte.

az spring gateway update -s MyService -g MyResourceGroup --enable-response-cache false

Parametri necessari

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

--service -s

Il nome dell'istanza di Azure Spring Apps consente di configurare il servizio predefinito usando az configure --defaults spring=<name>.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--addon-configs-file

Percorso del file della stringa JSON delle configurazioni del componente aggiuntivo.

Proprietà Valore
Gruppo di parametri: Add-on Configurations Arguments
--addon-configs-json

Stringa JSON delle configurazioni del componente aggiuntivo.

Proprietà Valore
Gruppo di parametri: Add-on Configurations Arguments
--allow-credentials

Indica se le credenziali utente sono supportate nelle richieste tra siti.

Proprietà Valore
Gruppo di parametri: Cross-origin Resource Sharing (CORS) Arguments
Valori accettati: false, true
--allow-origin-patterns --allowed-origin-patterns

Elenco delimitato da virgole di modelli di origine consentiti per effettuare richieste tra siti.

Proprietà Valore
Gruppo di parametri: Cross-origin Resource Sharing (CORS) Arguments
--allowed-headers

Elenco delimitato da virgole di intestazioni consentite nelle richieste tra siti. Il valore speciale * consente alle richieste effettive di inviare qualsiasi intestazione.

Proprietà Valore
Gruppo di parametri: Cross-origin Resource Sharing (CORS) Arguments
--allowed-methods

Elenco delimitato da virgole dei metodi HTTP consentiti nelle richieste tra siti. Il valore speciale * consente tutti i metodi.

Proprietà Valore
Gruppo di parametri: Cross-origin Resource Sharing (CORS) Arguments
--allowed-origins

Elenco delimitato da virgole di origini consentite per effettuare richieste tra siti. Il valore speciale * consente tutti i domini.

Proprietà Valore
Gruppo di parametri: Cross-origin Resource Sharing (CORS) Arguments
--api-description

Descrizione dettagliata delle API disponibili nell'istanza del gateway.

Proprietà Valore
Gruppo di parametri: API metadata Arguments
--api-doc-location

Percorso di documentazione aggiuntiva per le API disponibili nell'istanza del gateway.

Proprietà Valore
Gruppo di parametri: API metadata Arguments
--api-title

Titolo che descrive il contesto delle API disponibili nell'istanza del gateway.

Proprietà Valore
Gruppo di parametri: API metadata Arguments
--api-version

Versione delle API disponibili in questa istanza del gateway.

Proprietà Valore
Gruppo di parametri: API metadata Arguments
--apm-types

Elenco separato da spazi di APM integrato con gateway. I valori consentiti sono: ApplicationInsights, AppDynamics, Dynatrace, NewRelic, ElasticAPM.

Proprietà Valore
Gruppo di parametri: APM Arguments
--apms

Elenco delimitato da spazi dei nomi di riferimento APM in Azure Spring Apps da integrare con il gateway.

Proprietà Valore
Gruppo di parametri: APM Arguments
--assign-endpoint

Se true, assegnare l'URL dell'endpoint per l'accesso diretto.

Proprietà Valore
Valori accettati: false, true
--certificate-names

Elenco delimitato da virgole dei nomi dei certificati in Azure Spring Apps.

Proprietà Valore
Gruppo di parametri: Client Certificate Authentication Arguments
--client-id

Identificatore pubblico per l'applicazione.

Proprietà Valore
Gruppo di parametri: Single Sign On (SSO) Arguments
--client-secret

Segreto noto solo all'applicazione e al server di autorizzazione.

Proprietà Valore
Gruppo di parametri: Single Sign On (SSO) Arguments
--cpu

Quantità di risorse CPU. Deve essere 500m o il numero di core CPU.

--enable-cert-verify --enable-certificate-verification

Se true, verificherà il certificato nella connessione TLS dal gateway all'app.

Proprietà Valore
Gruppo di parametri: Client Certificate Authentication Arguments
Valori accettati: false, true
--enable-response-cache

Abilitare le impostazioni della cache delle risposte in Spring Cloud Gateway.

Proprietà Valore
Gruppo di parametri: Response Cache Arguments
Valori accettati: false, true
--exposed-headers

Elenco delimitato da virgole di intestazioni di risposta HTTP da esporre per le richieste tra siti.

Proprietà Valore
Gruppo di parametri: Cross-origin Resource Sharing (CORS) Arguments
--https-only

Se true, accedere all'endpoint tramite https.

Proprietà Valore
Valori accettati: false, true
--instance-count

Numero di istanza.

--issuer-uri

URI dell'identificatore dell'autorità di certificazione.

Proprietà Valore
Gruppo di parametri: Single Sign On (SSO) Arguments
--max-age

Per quanto tempo, in secondi, la risposta di una richiesta di pre-anteprima può essere memorizzata nella cache dai client.

Proprietà Valore
Gruppo di parametri: Cross-origin Resource Sharing (CORS) Arguments
--memory

Quantità di risorse di memoria. Deve essere 512Mi o #Gi, ad esempio 1Gi, 3Gi.

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Proprietà Valore
Valore predefinito: False
--properties

Proprietà non sensibili per le variabili di ambiente. Formattare "key[=value]" e separati da spazio.

--response-cache-scope

L'ambito della cache delle risposte, i valori disponibili sono [Route, Istanza].

Proprietà Valore
Gruppo di parametri: Response Cache Arguments
--response-cache-size

Dimensione massima della cache che determina se la cache deve rimuovere alcune voci. Gli esempi sono [1 GB, 10 MB, 100 KB]. Usare "default" per reimpostare e gateway gestirà questa proprietà.

Proprietà Valore
Gruppo di parametri: Response Cache Arguments
--response-cache-ttl

Tempo prima della scadenza di una voce memorizzata nella cache. Gli esempi sono [1h, 30m, 50s]. Usare "default" per reimpostare e gateway gestirà questa proprietà.

Proprietà Valore
Gruppo di parametri: Response Cache Arguments
--scope

L'elenco delimitato da virgole delle applicazioni di azioni specifiche può essere consentito per conto di un utente.

Proprietà Valore
Gruppo di parametri: Single Sign On (SSO) Arguments
--secrets

Proprietà sensibili per le variabili di ambiente. Una volta inserito, verrà crittografato e non restituito. Formattare "key[=value]" e separati da spazio.

--server-url

URL di base che i consumer di API useranno per accedere alle API nell'istanza del gateway.

Proprietà Valore
Gruppo di parametri: API metadata Arguments
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False