Share via

az spring gateway

  • Referência

Observação

Essa referência faz parte da extensão de mola para a CLI do Azure (versão 2.56.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az spring gateway . Saiba mais sobre extensões.

(Somente camada Enterprise) Comandos para gerenciar o gateway nos Aplicativos Spring do Azure.

Comandos

Nome Description Tipo Status
az spring gateway clear

Limpe todas as configurações do gateway.

 Extensão GA
az spring gateway create

Crie o Spring Cloud Gateway.

 Extensão GA
az spring gateway custom-domain

Comandos para gerenciar domínios personalizados para gateway.

 Extensão GA
az spring gateway custom-domain bind

Vincular um domínio personalizado ao gateway.

 Extensão GA
az spring gateway custom-domain list

Liste todos os domínios personalizados do gateway.

 Extensão GA
az spring gateway custom-domain show

Mostrar detalhes de um domínio personalizado.

 Extensão GA
az spring gateway custom-domain unbind

Desvincule um domínio personalizado do gateway.

 Extensão GA
az spring gateway custom-domain update

Atualize um domínio personalizado do gateway.

 Extensão GA
az spring gateway delete

Exclua o Spring Cloud Gateway.

 Extensão GA
az spring gateway restart

Reinicie o Spring Cloud Gateway.

 Extensão GA
az spring gateway route-config

Comandos para gerenciar configurações de rota de gateway nos Aplicativos Spring do Azure.

 Extensão GA
az spring gateway route-config create

Crie uma configuração de rota de gateway com regras de roteamento do formato de matriz Json.

 Extensão GA
az spring gateway route-config list

Liste todas as configurações de rota de gateway existentes.

 Extensão GA
az spring gateway route-config remove

Exclua uma configuração de rota de gateway existente.

 Extensão GA
az spring gateway route-config show

Obtenha uma configuração de rota de gateway existente.

 Extensão GA
az spring gateway route-config update

Atualize uma configuração de rota de gateway existente com regras de roteamento do formato de matriz Json.

 Extensão GA
az spring gateway show

Mostrar as configurações, o status de provisionamento e o status de tempo de execução do gateway.

 Extensão GA
az spring gateway sync-cert

Certificado de sincronização do gateway.

 Extensão GA
az spring gateway update

Atualize as propriedades de um gateway existente.

 Extensão GA

az spring gateway clear

Limpe todas as configurações do gateway.

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

Parâmetros Exigidos

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--service -s

O nome da instância do Azure Spring Apps, você pode configurar o serviço padrão usando az configure --defaults spring=.

Parâmetros Opcionais

--no-wait

Não aguarde a conclusão da operação de execução longa.

valor padrão: False
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az spring gateway create

Crie o Spring Cloud Gateway.

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

Exemplos

Crie o Spring Cloud Gateway.

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

Parâmetros Exigidos

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--service -s

O nome da instância do Azure Spring Apps, você pode configurar o serviço padrão usando az configure --defaults spring=.

Parâmetros Opcionais

--instance-count

Número de instâncias.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az spring gateway delete

Exclua o Spring Cloud Gateway.

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

Parâmetros Exigidos

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--service -s

O nome da instância do Azure Spring Apps, você pode configurar o serviço padrão usando az configure --defaults spring=.

Parâmetros Opcionais

--yes -y

Não solicite confirmação.

valor padrão: False
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az spring gateway restart

Reinicie o Spring Cloud Gateway.

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

Exemplos

Reinicie o Spring Cloud Gateway.

az spring gateway restart -s MyService -g MyResourceGroup

Parâmetros Exigidos

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--service -s

O nome da instância do Azure Spring Apps, você pode configurar o serviço padrão usando az configure --defaults spring=.

Parâmetros Opcionais

--no-wait

Não aguarde a conclusão da operação de execução longa.

valor padrão: False
--yes -y

Não solicite confirmação.

valor padrão: False
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az spring gateway show

Mostrar as configurações, o status de provisionamento e o status de tempo de execução do gateway.

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

Parâmetros Exigidos

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--service -s

O nome da instância do Azure Spring Apps, você pode configurar o serviço padrão usando az configure --defaults spring=.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az spring gateway sync-cert

Certificado de sincronização do gateway.

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

Exemplos

Certificado de sincronização do gateway.

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

Parâmetros Exigidos

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--service -s

O nome da instância do Azure Spring Apps, você pode configurar o serviço padrão usando az configure --defaults spring=.

Parâmetros Opcionais

--no-wait

Não aguarde a conclusão da operação de execução longa.

valor padrão: False
--yes -y

Não solicite confirmação.

valor padrão: False
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az spring gateway update

Atualize as propriedades de um gateway existente.

az spring gateway update --resource-group
                         --service
                         [--addon-configs-file]
                         [--addon-configs-json]
                         [--allow-credentials {false, true}]
                         [--allow-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 {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]

Exemplos

Atualizar propriedade de gateway.

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

Habilite e configure o cache de resposta no nível de Rota e defina ttl como 5 minutos.

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

Quando o cache de resposta estiver habilitado, atualize o ttl para 3 minutos.

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

Desative o cache de resposta.

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

Parâmetros Exigidos

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--service -s

O nome da instância do Azure Spring Apps, você pode configurar o serviço padrão usando az configure --defaults spring=.

Parâmetros Opcionais

--addon-configs-file

O caminho do arquivo da cadeia de caracteres JSON das configurações do complemento.

--addon-configs-json

Cadeia de caracteres JSON de configurações de complemento.

--allow-credentials

Se as credenciais do usuário têm suporte em solicitações entre sites.

valores aceitos: false, true
--allow-origin-patterns --allowed-origin-patterns

Lista separada por vírgulas de padrões de origem permitidos para fazer solicitações entre sites.

--allowed-headers

Lista separada por vírgulas de cabeçalhos permitidos em solicitações entre sites. O valor * especial permite que solicitações reais enviem qualquer cabeçalho.

--allowed-methods

Lista separada por vírgulas de métodos HTTP permitidos em solicitações entre sites. O valor * especial permite todos os métodos.

--allowed-origins

Lista separada por vírgulas de origens permitidas para fazer solicitações entre sites. O valor * especial permite todos os domínios.

--api-description

Descrição detalhada das APIs disponíveis na instância do Gateway.

--api-doc-location

Local da documentação adicional para as APIs disponíveis na instância do Gateway.

--api-title

Título que descreve o contexto das APIs disponíveis na instância do Gateway.

--api-version

Versão das APIs disponíveis nesta instância do Gateway.

--apm-types

Lista separada por espaço do APM integrado ao Gateway. Os valores permitidos são: ApplicationInsights, AppDynamics, Dynatrace, NewRelic, ElasticAPM.

--apms

Lista separada por espaço de nomes de referência de APM nos Aplicativos Spring do Azure para integração com o Gateway.

--assign-endpoint

Se verdadeiro, atribua a URL do ponto de extremidade para acesso direto.

valores aceitos: false, true
--certificate-names

Lista separada por vírgulas de nomes de certificados nos Aplicativos de Primavera do Azure.

--client-id

O identificador público do aplicativo.

--client-secret

O segredo conhecido apenas pelo aplicativo e pelo servidor de autorização.

--cpu

Quantidade de recursos da CPU. Deve ser 500m ou número de núcleos de CPU.

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

Se true, verificará o certificado na conexão TLS do gateway para o aplicativo.

valores aceitos: false, true
--enable-response-cache

Habilite as configurações de cache de resposta no Spring Cloud Gateway.

valores aceitos: false, true
--exposed-headers

Lista separada por vírgulas de cabeçalhos de resposta HTTP a serem expostos para solicitações entre sites.

--https-only

Se verdadeiro, acesse o endpoint via https.

valores aceitos: false, true
--instance-count

Número de instâncias.

--issuer-uri

O URI do identificador do emissor.

--max-age

Por quanto tempo, em segundos, a resposta de uma solicitação pré-lançamento pode ser armazenada em cache pelos clientes.

--memory

Quantidade de recursos de memória. Deve ser 512Mi ou #Gi, por exemplo, 1Gi, 3Gi.

--no-wait

Não aguarde a conclusão da operação de execução longa.

valor padrão: False
--properties

Propriedades não sensíveis para variáveis de ambiente. Formate "key[=value]" e separado por espaço.

--response-cache-scope

Escopo para cache de resposta, os valores disponíveis são [Route, Instance].

--response-cache-size

Tamanho máximo do cache que determina se o cache precisa remover algumas entradas. Exemplos são [1GB, 10MB, 100KB]. Use "default" para redefinir e o Gateway gerenciará essa propriedade.

--response-cache-ttl

Tempo antes de uma entrada armazenada em cache expirar. Exemplos são [1h, 30m, 50s]. Use "default" para redefinir e o Gateway gerenciará essa propriedade.

--scope

Lista separada por vírgulas das ações específicas que os aplicativos podem ter permissão para fazer em nome de um usuário.

--secrets

Propriedades confidenciais para variáveis de ambiente. Uma vez colocado, ele será criptografado e não retornado. Formate "key[=value]" e separado por espaço.

--server-url

URL base que os consumidores de API usarão para acessar APIs na instância do Gateway.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.