az spring-cloud gateway

Note

This reference is part of the spring-cloud extension for the Azure CLI (version 2.30.0 or higher). The extension will automatically install the first time you run an az spring-cloud gateway command. Learn more about extensions.

(Enterprise Tier Only) Commands to manage gateway in Azure Spring Cloud.

Commands

az spring-cloud gateway clear	Clear all settings of gateway.
az spring-cloud gateway custom-domain	Commands to manage custom domains for gateway.
az spring-cloud gateway custom-domain bind	Bind a custom domain with the gateway.
az spring-cloud gateway custom-domain list	List all custom domains of the gateway.
az spring-cloud gateway custom-domain show	Show details of a custom domain.
az spring-cloud gateway custom-domain unbind	Unbind a custom-domain of the gateway.
az spring-cloud gateway custom-domain update	Update a custom domain of the gateway.
az spring-cloud gateway route-config	Commands to manage gateway route configs in Azure Spring Cloud.
az spring-cloud gateway route-config create	Create a gateway route config with routing rules of Json array format.
az spring-cloud gateway route-config list	List all existing gateway route configs.
az spring-cloud gateway route-config remove	Delete an existing gateway route config.
az spring-cloud gateway route-config show	Get an existing gateway route config.
az spring-cloud gateway route-config update	Update an existing gateway route config with routing rules of Json array format.
az spring-cloud gateway show	Show the settings, provisioning status and runtime status of gateway.
az spring-cloud gateway update	Update an existing gateway properties.

az spring-cloud gateway clear

Clear all settings of gateway.

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

Required Parameters

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--service -s

Name of Azure Spring Cloud, you can configure the default service using az configure --defaults spring-cloud=.

Optional Parameters

--no-wait

Do not wait for the long-running operation to finish.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az spring-cloud gateway show

Show the settings, provisioning status and runtime status of gateway.

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

Required Parameters

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--service -s

Name of Azure Spring Cloud, you can configure the default service using az configure --defaults spring-cloud=.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az spring-cloud gateway update

Update an existing gateway properties.

az spring-cloud gateway update --resource-group
                               --service
                               [--allow-credentials {false, true}]
                               [--allowed-headers]
                               [--allowed-methods]
                               [--allowed-origins]
                               [--api-description]
                               [--api-doc-location]
                               [--api-title]
                               [--api-version]
                               [--assign-endpoint {false, true}]
                               [--client-id]
                               [--client-secret]
                               [--cpu]
                               [--exposed-headers]
                               [--https-only {false, true}]
                               [--instance-count]
                               [--issuer-uri]
                               [--max-age]
                               [--memory]
                               [--no-wait]
                               [--scope]
                               [--server-url]

Examples

Update gateway property.

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

Required Parameters

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--service -s

Name of Azure Spring Cloud, you can configure the default service using az configure --defaults spring-cloud=.

Optional Parameters

--allow-credentials

Whether user credentials are supported on cross-site requests.

accepted values: false, true

--allowed-headers

Comma-separated list of allowed headers in cross-site requests. The special value \* allows actual requests to send any header.

--allowed-methods

Comma-separated list of allowed HTTP methods on cross-site requests. The special value \* allows all methods.

--allowed-origins

Comma-separated list of allowed origins to make cross-site requests. The special value \* allows all domains.

--api-description

Detailed description of the APIs available on the Gateway instance.

--api-doc-location

Location of additional documentation for the APIs available on the Gateway instance.

--api-title

Title describing the context of the APIs available on the Gateway instance.

--api-version

Version of APIs available on this Gateway instance.

--assign-endpoint

If true, assign endpoint URL for direct access.

accepted values: false, true

--client-id

The public identifier for the application.

--client-secret

The secret known only to the application and the authorization server.

--cpu

CPU resource quantity. Should be 500m or number of CPU cores.

--exposed-headers

Comma-separated list of HTTP response headers to expose for cross-site requests.

--https-only

If true, access endpoint via https.

accepted values: false, true

--instance-count

Number of instance.

--issuer-uri

The URI of Issuer Identifier.

--max-age

How long, in seconds, the response from a pre-flight request can be cached by clients.

--memory

Memory resource quantity. Should be 512Mi or #Gi, e.g., 1Gi, 3Gi.

--no-wait

Do not wait for the long-running operation to finish.

--scope

Comma-separated list of the specific actions applications can be allowed to do on a user's behalf.

--server-url

Base URL that API consumers will use to access APIs on the Gateway instance.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.