Punto final HTTP (httpEndpoint)
Propiedades de configuración para un punto final HTTP.
| Nombre de atributo | Tipo de datos | Valor predeterminado | Descripción |
|---|---|---|---|
| accessLoggingRef | Referencia al elemento httpAccessLogging de nivel superior (string). | Configuración de registro de acceso HTTP para el punto final. | |
| enabled | boolean | true | Conmuta la disponibilidad de un punto final. Si tiene el valor true, el asignador activará este punto final para manejar las solicitudes HTTP. |
| host | string | localhost | Dirección IP, servidor de nombres de dominio (DNS), nombre de host con sufijo de nombre de dominio o sólo el nombre de host DNS utilizados por un cliente para solicitar un recurso. Utilice '*' para todas las interfaces de red disponibles. |
| httpOptionsRef | Referencia al elemento httpOptions de nivel superior (string). | defaultHttpOptions | Opciones del protocolo HTTP para el punto final. |
| httpPort | int
Mínimo:-1 Máximo:65535 |
El puerto utilizado para las solicitudes HTTP de cliente. Utilice -1 para inhabilitar este puerto. | |
| httpsPort | int
Mínimo:-1 Máximo:65535 |
El puerto utilizado para las solicitudes HTTP de cliente protegidas con SSL (https). Utilice -1 para inhabilitar este puerto. | |
| id | string | Un ID de configuración exclusivo. | |
| onError |
|
WARN | Acción a realizar después de una anomalía para iniciar un punto final.
|
| sslOptionsRef | Referencia al elemento sslOptions de nivel superior (string). | Opciones del protocolo SSL para el punto final. | |
| tcpOptionsRef | Referencia al elemento tcpOptions de nivel superior (string). | defaultTCPOptions | Opciones del protocolo TCP para el punto final. |
- accessLogging
Descripción: Configuración de registro de acceso HTTP para el punto final.Obligatorio: falseTipo de datos: Nombre de atributo Tipo de datos Valor predeterminado Descripción enabled boolean true Habilitar el registro cronológico de acceso. filePath Vía de acceso a un archivo ${server.output.dir}/logs/http_access.log Vía de acceso y nombre de directorio del archivo de registro de acceso. Las sustituciones de variables estándar, como ${server.output.dir}, se pueden utilizar al especificar la vía de acceso del directorio. logFormat string %h %u %{t}W "%r" %s %b Especifica el formato de registro que se utiliza al registrar la información de acceso del cliente. maxFileSize int Mínimo:0
20 Tamaño máximo de un archivo de registro, en megabytes, antes de que se renueve; un valor de 0 significa que no hay límite. maxFiles int Mínimo:0
2 Número máximo de archivos de registro que se conservarán, antes de que se elimine el archivo más antiguo; un valor de 0 significa que no hay límite.
- httpOptions
Descripción: Opciones del protocolo HTTP para el punto final.Obligatorio: falseTipo de datos: Nombre de atributo Tipo de datos Valor predeterminado Descripción keepAliveEnabled boolean true Habilita las conexiones persistentes (HTTP de estado activo). Si es true, las conexiones se mantienen activas para su reutilización en múltiples solicitudes y respuestas secuenciales. Si tienen el valor false, las conexiones se cierran después de enviarse la respuesta. maxKeepAliveRequests int Mínimo:-1
100 Número máximo de solicitudes persistentes que se permiten en una única conexión HTTP si están habilitadas las conexiones persistentes. El valor -1 indica ilimitado. persistTimeout Un periodo de tiempo con precisión de segundos 30s Cantidad de tiempo que un socket puede permanecer desocupado entre solicitudes. Este valor sólo se aplica si están habilitadas las conexiones persistentes. Especifica un entero positivo seguido de una unidad de tiempo, que puede ser horas (h), minutos (m) o segundos (s). Por ejemplo, especifique 30 segundos como 30s. Puede incluir varios valores en una sola entrada. Por ejemplo, 1m30s es equivalente a 90 segundos. readTimeout Un periodo de tiempo con precisión de segundos 60s Cantidad de tiempo que se debe esperar en un socket hasta que se complete una solicitud de lectura después de la primera lectura. Especifica un entero positivo seguido de una unidad de tiempo, que puede ser horas (h), minutos (m) o segundos (s). Por ejemplo, especifique 30 segundos como 30s. Puede incluir varios valores en una sola entrada. Por ejemplo, 1m30s es equivalente a 90 segundos. removeServerHeader boolean false Elimina la información de implementación del servidor de las cabeceras HTTP y también inhabilita la página de bienvenida predeterminada del perfil Liberty. writeTimeout Un periodo de tiempo con precisión de segundos 60s Cantidad de tiempo que se debe esperar en un socket hasta que se transmita cada parte de los datos de respuesta. Especifica un entero positivo seguido de una unidad de tiempo, que puede ser horas (h), minutos (m) o segundos (s). Por ejemplo, especifique 30 segundos como 30s. Puede incluir varios valores en una sola entrada. Por ejemplo, 1m30s es equivalente a 90 segundos.
- sslOptions
Descripción: Opciones del protocolo SSL para el punto final.Obligatorio: falseTipo de datos: Nombre de atributo Tipo de datos Valor predeterminado Descripción sessionTimeout Un periodo de tiempo con precisión de segundos 1d Cantidad de tiempo que se debe esperar a que una solicitud de lectura o escritura se complete en un socket. Este valor se sustituye por tiempos de espera específicos de protocolo. Especifica un entero positivo seguido de una unidad de tiempo, que puede ser horas (h), minutos (m) o segundos (s). Por ejemplo, especifique 30 segundos como 30s. Puede incluir varios valores en una sola entrada. Por ejemplo, 1m30s es equivalente a 90 segundos. sslRef Una referencia al elemento ssl de nivel superior (serie). El repertorio de configuración SSL predeterminado. El valor predeterminado es defaultSSLSettings. suppressHandshakeErrors boolean false Inhabilita el registro de errores de reconocimiento de comunicación SSL. Los errores de reconocimiento de comunicación SSL se pueden producir durante el funcionamiento normal, pero estos mensajes pueden resultar muy útiles si SSL no se comporta de la forma esperada.
- tcpOptions
Descripción: Opciones del protocolo TCP para el punto final.Obligatorio: falseTipo de datos: Nombre de atributo Tipo de datos Valor predeterminado Descripción inactivityTimeout Un periodo de tiempo con precisión de milisegundos. 60s Cantidad de tiempo que se debe esperar a que una solicitud de lectura o escritura se complete en un socket. Este valor se sustituye por tiempos de espera específicos de protocolo. Especifica un entero positivo seguido de una unidad de tiempo, que puede ser horas (h), minutos (m), segundos (s) o milisegundos (ms). Por ejemplo, especifique 500 milisegundos como 500ms. Puede incluir varios valores en una sola entrada. Por ejemplo, 1s500ms es equivalente a 1,5 segundos. soReuseAddr boolean true Permite reenlazar de inmediato con un puerto sin un escucha activo.
Tema de referencia