Modify cloud-native API gateway engine parameters - API Gateway: Central de Documentação do Alibaba Cloud

Para adaptar o gateway a diferentes cenários, ajuste os parâmetros do gateway de API nativo em cloud. Ajustar os parâmetros corretamente melhora o desempenho, a confiabilidade e a segurança da rede, garantindo uma operação estável e uma experiência de usuário superior. Contudo, alterar os parâmetros do gateway pode impactar a conectividade de rede e os aplicativos que o consomem. Antes de fazer alterações, verifique o intervalo válido e o impacto de cada parâmetro. Este tópico descreve o processo de modificação e detalha cada parâmetro.

Pré-requisitos

crie um gateway. Para mais informações, consulte Create a cloud-native API gateway.

Etapas

Nota

Você só pode modificar os parâmetros exibidos no console. A alteração de parâmetros ocultos não é permitida. Essa restrição garante a estabilidade da instância.
Antes de alterar o valor de um parâmetro, verifique a coluna Value Range na página de parâmetros do mecanismo do gateway no console.

Acesse o API Gateway console.
No painel de navegação à esquerda, clique em Cloud-native API Gateway > Instance. Na barra de navegação superior, selecione uma região.
Na página Instance, clique em id da instância desejada.
No painel de navegação à esquerda, escolha Parameters. Na seção Gateway Engine Parameters, localize o parâmetro desejado e clique em Edit na coluna Actions e defina o valor do parâmetro conforme descrito na tabela a seguir e clique em OK.

Parâmetros do mecanismo do gateway

Parameter Name	Parameter Type	Value Range	Default Value	Parameter Description
EnableHttp2	bool	[true, false]	false	Fase de requisição. Especifica se o HTTP/2 deve ser usado durante a negociação de protocolo. true: Usa HTTP/2. false: Não usa HTTP/2.
EnableGenerateRequestId	bool	[true, false]	true	Fase de requisição. Quando ativado, o gateway gera um cabeçalho X-Request-Id para identificar exclusivamente cada requisição. true: Gera um cabeçalho X-Request-Id. false: Não gera um cabeçalho X-Request-Id.
EnableGzip	bool	[true, false]	false	Fases de requisição e resposta. true: Comprime as respostas com Gzip, o que reduz o tráfego do gateway, mas aumenta o uso de CPU do gateway. false: Retorna a resposta original.
EnableGzipHardwareAccelerate	bool	[true, false]	false	Compressão Gzip com aceleração de hardware. Reduz significativamente o tráfego do gateway com maior desempenho e menor uso de CPU em comparação com o Gzip baseado em software. true: Ativa a aceleração de hardware para Gzip. false: Desativa a aceleração de hardware para Gzip. Importante Indisponível em regiões não suportadas ou se a aceleração de hardware Gzip não foi ativada na compra. Quando ativado, os parâmetros EnableGzip e ZipAlgorithm deixam de ter efeito.
EnableSlashMerge	bool	[true, false]	false	Fase de requisição. Especifica se as barras consecutivas (`/`) no caminho da requisição devem ser mescladas. true: Mescla caracteres `/` redundantes. Por exemplo, `www.example.com//b` é tratado da mesma forma que `www.example.com/b`. false: Caracteres `/` redundantes não são mesclados.
DownstreamIdleTime	integer	[0, 600]	180	Conexões do gateway. Encerra conexões ociosas entre o cliente e o gateway após a duração especificada. Unidade: segundos.
PreserveHeaderFormat	bool	[true, false]	false	Fases de requisição e resposta. Por padrão, os nomes dos cabeçalhos são convertidos para minúsculas para compatibilidade com HTTP/2. true: Preserva a formatação de maiúsculas e minúsculas dos cabeçalhos de requisição e resposta. false: Converte os cabeçalhos de requisição e resposta para minúsculas.
DownstreamConnectionBufferLimits	integer	[0, 2147483647]	32768	Conexões do gateway. Controla o tamanho do buffer por conexão, afetando o throughput e o uso de memória. Unidade: bytes.
EnableHardwareAccelerate	bool	[true, false]	true	Criptografia e descriptografia TLS. Ativa o processamento TLS com aceleração de hardware. Não tem efeito se a aceleração de hardware não for suportada na sua região ou não tiver sido ativada na compra. true: Ativa a aceleração de hardware. false: Desativa a aceleração de hardware. Nota Devido a limitações de hardware subjacentes, a aceleração de hardware é atualmente suportada apenas nas regiões China (Beijing), China (Hangzhou), China (Shanghai), China (Shenzhen) e Singapore.
XffTrustedNum	integer	[0, 10]	0	Fase de requisição. Número de proxies confiáveis antes do gateway, afetando a forma como os cabeçalhos gerados pelo cliente, como x-forwarded-for e x-request-id, são tratados. Se definido como 0, o gateway usa o IP do socket par como IP de origem e o passa para o backend no cabeçalho x-envoy-external-address. Se for diferente de zero, o gateway determina o IP de origem a partir do cabeçalho x-forwarded-for, ignorando o número especificado de saltos da direita para a esquerda. Esse IP é passado para o backend no cabeçalho x-envoy-external-address. O gateway também preserva os cabeçalhos x-request-id e x-forwarded-proto enviados pelo cliente.
DownstreamHttp2MaxConcurrentStream	integer	[0, 2147483647]	100	Fase de requisição. Número máximo de fluxos HTTP/2 simultâneos por conexão de cliente.
InitialStreamWindowSize	integer	[65535, 2147483647]	65535	Fase de requisição. Tamanho inicial da janela de controle de fluxo no nível de fluxo HTTP/2. Unidade: bytes.
InitialConnectionWindowSize	integer	[0, 2147483647]	1048576	Fase de requisição. Tamanho inicial da janela de controle de fluxo no nível de conexão HTTP/2. Unidade: bytes.
EnableHttp3	bool	[true, false]	false	Fase de requisição. Especifica se o HTTP/3 deve ser usado na comunicação entre o cliente e o gateway. true: Usa HTTP/3. false: Não usa HTTP/3.
UpstreamIdleTimeout	int	[0, 600]	30	Conexões do gateway. Encerra conexões ociosas entre o gateway e o upstream após a duração especificada. Unidade: segundos.
PathWithEscapedSlashes	string	KEEP_UNCHANGED REJECT_REQUEST UNESCAPE_AND_REDIRECT UNESCAPE_AND_FORWARD	KEEP_UNCHANGED	Regra de encaminhamento para requisições cujo caminho URI contém barras codificadas (%2F, %2f, %5C ou %5c). KEEP_UNCHANGED: Mantém o caminho inalterado. REJECT_REQUEST: O gateway retorna um erro 400 e rejeita a requisição. UNESCAPE_AND_REDIRECT: Decodifica os caracteres e realiza um redirecionamento. UNESCAPE_AND_FORWARD: Decodifica os caracteres e encaminha a requisição.
ZipAlgorithm	List<string>	[brotli, gzip]	gzip	Algoritmo de compressão. Valores suportados: brotli, gzip. Quando ambos são especificados com q-values iguais no Accept-Encoding, o primeiro algoritmo da lista tem precedência.
EnableProxyProtocol	bool	[true, false]	false	Ativa o protocolo PROXY. Necessário quando o tráfego de entrada passa por um Network Load Balancer (NLB) para obter o endereço IP de origem do cliente. Não afeta requisições que não usam o protocolo PROXY.
EnableCustomAuthConfigPush	bool	[true, false]	false	Cenários de autenticação autogerenciada. Quando ativado, as alterações nas regras de autenticação não interrompem as conexões existentes. Adequado para WebSocket e cenários de negócios online.