Modificar los parámetros del motor de la puerta de enlace - API Gateway

Para adaptarse a los cambios en distintos escenarios, puede ajustar los parámetros de una puerta de enlace nativa de la nube para API. Un ajuste adecuado mejora el rendimiento, la confiabilidad y la seguridad de la red, lo que ayuda a garantizar un funcionamiento estable y una mejor experiencia de usuario. Sin embargo, modificar estos parámetros puede afectar la conectividad de red y las aplicaciones que usan la puerta de enlace. Antes de modificarlos, asegúrese de comprender el rango válido y el efecto de cada parámetro modificable. Este tema describe cómo modificar los parámetros de la puerta de enlace y proporciona sus detalles.

Requisitos previos

Se creó una puerta de enlace. Para obtener más información, consulte Create a cloud-native API gateway.

Pasos

Nota

Solo se pueden modificar los parámetros que se muestran en la consola. Los parámetros que no aparecen en la consola no admiten modificaciones. Esta restricción garantiza el funcionamiento estable de la instancia.
Antes de modificar el valor de un parámetro, compruebe la columna Value Range en la página Gateway Engine Parameters de la consola.

Inicie sesión en la consola de API Gateway.
En el panel de navegación izquierdo, haga clic en Cloud-native API Gateway > Instance. En la barra de navegación superior, seleccione una región.
En la página Instance, haga clic en el ID de la instancia de destino.
En el panel de navegación izquierdo, elija Parameters. En la sección Gateway Engine Parameters, busque el parámetro de destino, haga clic en Edit en la columna Actions, establezca el valor del parámetro según se describe en la siguiente tabla y, a continuación, haga clic en OK.

Parámetros del motor de la puerta de enlace

Parameter Name	Parameter Type	Value Range	Valor predeterminado	Parameter Description
EnableHttp2	bool	[true, false]	false	Fase de solicitud. Especifica si se usa HTTP/2 durante la negociación del protocolo. true: usa HTTP/2. false: no usa HTTP/2.
EnableGenerateRequestId	bool	[true, false]	true	Fase de solicitud. Cuando está habilitado, la puerta de enlace genera un encabezado X-Request-Id para identificar de forma única cada solicitud. true: genera un encabezado X-Request-Id. false: no genera un encabezado X-Request-Id.
EnableGzip	bool	[true, false]	false	Fases de solicitud y respuesta. true: comprime las respuestas con Gzip, lo que reduce el tráfico de la puerta de enlace pero aumenta su uso de CPU. false: devuelve la respuesta original.
EnableGzipHardwareAccelerate	bool	[true, false]	false	Compresión Gzip acelerada por hardware. Reduce significativamente el tráfico de la puerta de enlace con un mayor rendimiento y menor uso de CPU que la compresión Gzip basada en software. true: habilita la aceleración por hardware de Gzip. false: deshabilita la aceleración por hardware de Gzip. Importante No está available en regiones no compatibles o si la aceleración por hardware de Gzip no se habilitó al momento de la compra. Cuando está habilitado, los parámetros EnableGzip y ZipAlgorithm dejan de surtir efecto.
EnableSlashMerge	bool	[true, false]	false	Fase de solicitud. Especifica si se combinan las barras diagonales consecutivas (`/`) en la ruta de la solicitud. true: combina los caracteres `/` redundantes. Por ejemplo, `www.example.com//b` se trata igual que `www.example.com/b`. false: no se combinan los caracteres `/` redundantes.
DownstreamIdleTime	integer	[0, 600]	180	Conexiones de la puerta de enlace. Cierra las conexiones entre el cliente y la puerta de enlace que permanecen inactivas durante la duración especificada. Unidad: segundos.
PreserveHeaderFormat	bool	[true, false]	false	Fases de solicitud y respuesta. De forma predeterminada, los nombres de los encabezados se convierten a minúsculas para mantener la compatibilidad con HTTP/2. true: conserva el formato de mayúsculas y minúsculas de los encabezados de solicitud y respuesta. false: convierte los encabezados de solicitud y respuesta a minúsculas.
DownstreamConnectionBufferLimits	integer	[0, 2147483647]	32768	Conexiones de la puerta de enlace. Controla el tamaño del búfer por conexión, lo que afecta el rendimiento y el uso de memoria. Unidad: bytes.
EnableHardwareAccelerate	bool	[true, false]	true	Cifrado y descifrado TLS. Habilita el procesamiento de TLS acelerado por hardware. No surte efecto si la aceleración por hardware no es compatible con su región o no se habilitó al momento de la compra. true: habilita la aceleración por hardware. false: deshabilita la aceleración por hardware. Nota Debido a limitaciones del hardware subyacente, la aceleración por hardware solo es compatible actualmente con las regiones China (Beijing), China (Hangzhou), China (Shanghai), China (Shenzhen) y Singapore.
XffTrustedNum	integer	[0, 10]	0	Fase de solicitud. Número de proxies de confianza antes de la puerta de enlace, lo que afecta la forma en que se gestionan los encabezados generados por el cliente, como x-forwarded-for y x-request-id. Si se establece en 0, la puerta de enlace usa la dirección IP del socket del par como IP de origen y la pasa al backend en el encabezado x-envoy-external-address. Si es distinto de cero, la puerta de enlace determina la IP de origen a partir del encabezado x-forwarded-for, omitiendo el número especificado de saltos de derecha a izquierda. Esta IP se pasa al backend en el encabezado x-envoy-external-address. La puerta de enlace también conserva los encabezados x-request-id y x-forwarded-proto enviados por el cliente.
DownstreamHttp2MaxConcurrentStream	integer	[0, 2147483647]	100	Fase de solicitud. Máximo de flujos HTTP/2 simultáneos por conexión de cliente.
InitialStreamWindowSize	integer	[65535, 2147483647]	65535	Fase de solicitud. Tamaño inicial de la ventana de control de flujo de flujo HTTP/2. Unidad: bytes.
InitialConnectionWindowSize	integer	[0, 2147483647]	1048576	Fase de solicitud. Tamaño inicial de la ventana de control de flujo de conexión HTTP/2. Unidad: bytes.
EnableHttp3	bool	[true, false]	false	Fase de solicitud. Especifica si se usa HTTP/3 para la comunicación entre el cliente y la puerta de enlace. true: usa HTTP/3. false: no usa HTTP/3.
UpstreamIdleTimeout	int	[0, 600]	30	Conexiones de la puerta de enlace. Cierra las conexiones entre la puerta de enlace y el upstream que permanecen inactivas durante la duración especificada. Unidad: segundos.
PathWithEscapedSlashes	string	KEEP_UNCHANGED REJECT_REQUEST UNESCAPE_AND_REDIRECT UNESCAPE_AND_FORWARD	KEEP_UNCHANGED	Regla de reenvío para solicitudes cuya ruta URI contiene barras diagonales codificadas (%2F, %2f, %5C o %5c). KEEP_UNCHANGED: mantiene la ruta sin cambios. REJECT_REQUEST: la puerta de enlace devuelve un error 400 y rechaza la solicitud. UNESCAPE_AND_REDIRECT: decodifica los caracteres y redirige. UNESCAPE_AND_FORWARD: decodifica los caracteres y reenvía la solicitud.
ZipAlgorithm	List<string>	[brotli, gzip]	gzip	Algoritmo de compresión. Valores compatibles: brotli, gzip. Cuando ambos se especifican con valores q iguales en Accept-Encoding, el primer algoritmo de la lista tiene prioridad.
EnableProxyProtocol	bool	[true, false]	false	Habilita el protocolo PROXY. Es obligatorio cuando el tráfico de entrada pasa por un Network Load Balancer (NLB) para obtener la dirección IP de origen del cliente. No afecta a las solicitudes que no usan el protocolo PROXY.
EnableCustomAuthConfigPush	bool	[true, false]	false	Escenarios de autenticación autogestionada. Cuando está habilitado, los cambios en las reglas de autenticación no interrumpen las conexiones existentes. Más indicado para escenarios de WebSocket y negocios en línea.