Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Centro de ayuda/ API Gateway/ Referencia de la API/ Anexo/ Características admitidas
Actualización más reciente 2025-12-22 GMT+08:00

Características admitidas

En la siguiente tabla se enumeran las características compatibles con los gateways dedicados.

Si el gateway que utiliza no tiene las características específicas, envíe un ticket de servicio para actualizar su gateway.

Nombre de la característica

Descripción de característica

Configurable

Ejemplo de configuración de característica

Parámetro de configuración

Descripción del parámetro

Valor predeterminado

Rango de valores

lts

Informes de registros de acceso de Shubao

{"name":"lts","enable":true,"config": "{\"group_id\": ",\"topic_id\":\"\",\"log_group\":\"\",\"log_stream\":\"\"}"}

group_id

ID de grupo de registro.

-

-

topic_id

ID de flujo de registro.

log_group

Nombre de un grupo de registro.

log_stream

Nombre de un flujo de registro.

gateway_responses

Respuestas de gateway personalizadas

No

-

-

-

-

-

ratelimit

Solicitar configuración de límite de regulación

{"name":"ratelimit","enable":true,"config": "{\"api_limits\": 500}"}

api_limits

Valor predeterminado de limitación de solicitud aplicado a todas las API. Establezca este parámetro correctamente para cumplir con los requisitos de servicio. Un pequeño valor puede acelerar constantemente sus servicios.

200 invocaciones por segundo

1–1,000,000 invocaciones por segundo

request_body_size

Configuración del tamaño máximo del cuerpo de la solicitud

{"name":"request_body_size","enable":true,"config": "104857600"}

request_body_size

Tamaño máximo del cuerpo permitido en una solicitud de API.

12 MB

1–9536 MB

backend_timeout

Configuración de tiempo de espera de backend máximo

{"name":"backend_timeout","enable":true,"config": "{"max_timeout": 500}"}

max_timeout

Tiempo de espera máximo para que APIG solicite un servicio de backend.

60,000 ms

1-600,000 ms

app_token

Autenticación de app_token

{"name":"app_token","enable":true,"config": "{\"enable\": \"on\", \"app_token_expire_time\": 3600, \"app_token_uri\": \"/v1/apigw/oauth2/token\", \"refresh_token_expire_time\": 7200}"}

enable

Si se debe habilitar esta característica.

Off

On/Off

app_token_expire_time

Período de validez del token de acceso.

3600s

1–72,000s

refresh_token_expire_time

Período de validez del token de actualización.

7200s

1–72,000s

app_token_uri

URI utilizado para obtener el token.

/v1/apigw/oauth2/token

-

app_token_key

Clave de encriptación de token.

-

-

app_api_key

Autenticación de app_api_key

{"name":"app_api_key","enable":true,"config": "on"}

-

-

Off

On/Off

app_basic

Autenticación de app_basic

{"name":"app_basic","enable":true,"config": "on"}

-

-

Off

On/Off

app_secret

Autenticación de app_secret

{"name":"app_secret","enable":true,"config": "on"}

-

-

Off

On/Off

app_jwt

Autenticación de app_jwt

{"name":"app_jwt","enable":true,"config": "{\"enable\": \"on\", \"auth_header\": \"Authorization\"}"}

enable

Si se debe habilitar la autenticación app_jwt.

Off

On/Off

auth_header

Encabezado de autenticación de app_jwt.

Authorization

-

public_key

Firmas de backend de public_key

{"name":"public_key","enable":true,"config": "{\"enable\": \"on\", \"public_key_uri_prefix\": \"/apigw/authadv/v2/public-key/\"}"}

enable

Si se debe habilitar la autenticación de public_key.

Off

On/Off

public_key_uri_prefix

Prefijo de URI utilizado para obtener la clave pública.

/apigw/authadv/v2/public-key/

-

backend_token_allow

Permitir que los tenants transmitan tokens de forma transparente al backend

{"name":"backend_token_allow","enable":true,"config": "{\"backend_token_allow_users\": [\"user_name\"]}"}

backend_token_allow_users

Expresión regular para transmitir de forma transparente el token a la lista blanca de tenant común del tenant para que coincida con el nombre de dominio del tenant común.

-

-

sign_basic

Claves de firma básicas

No

-

-

-

-

-

multi_auth

Autenticación de dos factores

No

-

-

-

-

-

backend_client_certificate

Autenticación bidireccional de backend

{"name":"backend_client_certificate","enable":true,"config": "{\"enable\": \"on\",\"ca\": \"\",\"content\": \"\",\"key\": \"\"}"}

enable

Si se debe habilitar esta característica.

Off

On/Off

ca

Archivo de CA de autenticación bidireccional.

-

-

content

Archivo de autenticación bidireccional.

-

-

key

Clave privada de autenticación bidireccional.

-

-

ssl_ciphers

Conjuntos de cifrado de HTTPS

{"name":"ssl_ciphers","enable":true,"config": "config": "{\"ssl_ciphers\": [\"ECDHE-ECDSA-AES256-GCM-SHA384\"]}"}

ssl_ciphers

Compatible con conjuntos de cifrado y descifrado. El parámetro ssl_ciphers no se puede dejar en blanco y solo puede contener las opciones del valor predeterminado.

-

ECDHE-ECDSA-AES256-GCM-SHA384,ECDHE-RSA-AES256-GCM-SHA384,ECDHE-ECDSA-AES128-GCM-SHA256,ECDHE-RSA-AES128-GCM-SHA256,ECDHE-ECDSA-AES256-SHA384,ECDHE-RSA-AES256-SHA384,ECDHE-ECDSA-AES128-SHA256,ECDHE-RSA-AES128-SHA256

route

Rutas personalizadas

No

-

-

-

-

-

cors

Complementos

No

-

-

-

-

-

real_ip_from_xff

Encabezado de X-Forwarded-For para identificar direcciones IP durante el control de acceso y la limitación de solicitudes

{"name": "real_ip_from_xff","enable": true,"config": {"enable": "on","xff_index": -1}}

enable

Si se debe habilitar esta característica.

Off

On/Off

xff_index

Número de secuencia de una dirección IP en el encabezado de X-Forwarded-For. El valor de este parámetro puede ser 0 o un número positivo o negativo. Si el valor es de 0 o un número positivo, la dirección IP del índice correspondiente se obtiene a partir del encabezado de X-Forwarded-For. Si el valor es un número negativo, la dirección IP en orden de índice inverso se obtiene del encabezado de X-Forwarded-For. Por ejemplo, supóngase que el encabezado X-Forwarded-For de una solicitud recibida por el gateway de API contiene tres direcciones IP: IP1, IP2 e IP3. Si el valor de xff_index es 0, se obtiene IP1. Si el valor de xff_index es 1, se obtiene IP2. Si el valor de xff_index es –1, se obtiene IP3.

-1

Valor de Int32 válido

app_route

IP address access

{"name":"app_route","enable":true,"config": "on"}

-

-

Off

On/Off

vpc_name_modifiable

Modificación del nombre del canal de balanceo de carga

{"name":"vpc_name_modifiable","enable":true,"config": "on"}

-

-

on

On/Off

default_group_host_trustlist

Acceso al grupo DEFAULT desde direcciones IP que no son direcciones de acceso entrantes del gateway actual

{"name":"default_group_host_trustlist","enable": true,"config": "{\"enable\":\"on\",\"hosts\":[\"123.2.2.2\",\"202.2.2.2\"]}"}

enable

Si se debe habilitar esta característica.

-

On/Off

hosts

Direcciones IP que no son direcciones de acceso entrante del gateway actual.

-

-

throttle_strategy

Limitación de solicitudes

{"name":"throttle_strategy","enable":true,"config": "{\"enable\": \"on\",\"strategy\": \"local\"}"}

enable

Si se debe habilitar esta característica.

Off

On/Off

strategy

Modo de limitación de solicitudes.

-

cluster/local

custom_log

Impresión de encabezados de solicitud personalizados, cadenas de consulta y cookies en registros

{"name":"custom_log","enable":true,"config": "{\"custom_logs\":[{\"location\":\"header\",\"name\":\"a1234\"}]}"}

custom_logs

Registros personalizados.

-

Máximo 10 artículos.

location

Ubicación.

header/query/cookie

name

Nombre.

-

real_ip_header_getter

Uso de un encabezado personalizado para obtener direcciones IP de origen

{"name":"real_ip_header_getter","enable":true,"config": "{\"enable\": \"on\",\"header_getter\": \"header:testIP\"}"}

enable

Si se debe habilitar esta característica.

Off

On/Off

header_getter

Encabezado personalizado para obtener direcciones IP de origen.

-

-

policy_cookie_param

Uso de cookies en las condiciones de la política de backend

{"name":"policy_cookie_param","enable":true,"config": "on"}

-

-

Off

On/Off

app_quota

Cuotas de cliente

No

-

-

-

-

-

app_acl

Políticas de limitación de solicitudes

No

-

-

-

-

-

set_resp_headers

Complementos de gestión de encabezados de respuesta

No

-

-

-

-

-

vpc_backup

Canales de VPC primarios/en espera

No

-

-

-

-

-

sign_aes

Claves de firma AES

No

-

-

-

-

-

kafka_log

Adición, eliminación, modificación y consulta de complementos de inserción de registros de Kafka

No

-

-

-

-

-

backend_retry_count

Configuración de reintentos de backend

No

-

-

-

-

-

policy_sys_param

Uso de parámetros del sistema en condiciones de política de backend

No

-

-

-

-

-

breaker

Interruptores

No

-

-

-

-

-

content_type_configurable

Devolver el tipo de parámetro de solicitud (Content-Type) al consultar las API

No

-

-

-

-

-

rate_limit_plugin

Complementos de limitación de solicitudes

No

-

-

-

-

-

breakerv2

Interruptores para degradar servicios en caso de sobrecarga

No

-

-

-

-

-

sm_cipher_type

Cifrado de datos sensibles locales con algoritmos criptográficos comerciales

No

-

-

-

-

-

rate_limit_algorithm

Conmutación de algoritmo de limitación de solicitudes

No

-

-

-

-

-

gzip

Compresión de respuesta usando gzip

{

"name" : "gzip",

"config" : {\"comp_level\":6},

"enable" : true

}

comp_level

Nivel de compresión de gzip (1 a 9). Cuanto más alto es el nivel, más comprimido, pero tarda más tiempo.

6

1–9

sse_strategy

Transmisión de SSE

{

"name": "sse_strategy",

"enable": true,

"config": "on"

}

-

-

Off

On/Off

authorizer_context_support_num_bool

Si el valor del par clave-valor en el contexto devuelto para la autenticación personalizada puede ser un número o un valor de Boolean.

No

-

-

-

-

-

custom_auth_header

Encabezados de autenticación personalizados para políticas de autenticación de aplicaciones y clave de firma.

1: {

"name": "custom_auth_header",

"enable": true,

"config": "{\"app_auth_header\":\"app-header\", \"backend_sign_header\":\"back-header\"}"

}

app_auth_header

Se utiliza para especificar la información de firma para la autenticación de aplicaciones en el encabezado de solicitud.

-

Deje este parámetro en blanco o introduzca de 3 a 64 letras, dígitos, guiones (-) y guiones bajos (_), y comience con una letra. No comience con x-apig- o x-sdk-, y no use x-stage o authorization. El valor no distingue entre mayúsculas y minúsculas.

backend_sign_header

Se utiliza para especificar la información de firma de las políticas de clave de firma (Basic, Auth, HMAC) para pasar al backend.

-

request_custom_config

Configuración de parámetros de solicitud de cliente

{

"name": "request_custom_config",

"enable": true,

"config": "{\"http2\":\"on\",\"client_body_timeout\":10}"

}

http2

Si se debe habilitar HTTP/2.

on

on/off

client_body_timeout

Tiempo de espera del cuerpo de solicitud del cliente.

8s

1-60s

gateway_responses_support_header

La respuesta de grupo personalizada admite encabezados personalizados.

No

-

-

-

-

-

api_uri_no_escape

Parámetros de solicitud de anulación de escape de la ruta de solicitud en la API.

{"name":"api_uri_no_escape","enable":true,"config":""}

enable

Si se debe habilitar esta característica.

false

true/false

ip_control

Control de acceso

{"enable": true,"name":"ip_control","config":"{\"control_type\":\"white\",\"white_ip_list\":\"\",\"black_ip_list\":\"\"}"}

control_type

Tipo de control.

black

black/white

white_ip_list

Lista blanca de direcciones IP.

-

-

black_ip_list

Lista negra de direcciones IP.

-

-