Define los valores de configuración para un punto final de servicio.
Name | Type | Default | Description |
---|---|---|---|
id | string | Un ID de configuración exclusivo. | |
serviceName | string | El nombre asociado a un punto final de servicio. Este nombre identifica un punto final de servicio para un cliente. | |
serviceRef | Una referencia a un elemento localAdaptersConnectService de nivel superior (string). | El nombre de referencia que identifica el punto final de servicio que está registrado con z/OS Connect. | |
serviceDescription | string | La descripción asociada a un punto final de servicio. | |
serviceGroupingName | string | El nombre que se puede utilizar para agrupar o asociar un conjunto de puntos finales de servicio. | |
runGlobalInterceptors | boolean | true | Indica si deben ejecutar interceptores globales para las solicitudes asociadas a un punto final de servicio. De forma predeterminada, z/OS Connect procesa todos los interceptores específicos de punto final de servicio y globales. |
invokeURI | string | URI o lista de URI separados por comas para asociar a un punto final de servicio. InvokeURIs pueden finalizar con un carácter comodín en el formato /a/b/* o x/y* para coincidir genéricamente con una invocación de punto final de servicio. No se admite especificar varios caracteres comodín (por ejemplo, /a/b/**) o caracteres comodín en medio de requestURI (por ejemplo, /a/*/c). Si hay puntos finales de servicio con invokeURIs configurados utilizando el carácter comodín que están asociados a invokeURIs que se solapan, se hace coincidir con el punto final de servicio asociado al invokeURI más específico. Por ejemplo, si se emite una solicitud de punto final de servicio con el siguiente: https://host:port/a/b/c dirigido a un servidor con la siguiente configuración: service1 -> invokeURI="/a/b/c/*" y service2 -> invokeURI="/a/b/*", z/OS Connect hará coincidir la solicitud con service1. Las entradas invokeURI configuradas deben empezar con el carácter /. Utilizar un invokeURI es equivalente a una solicitud de servicio donde se especifica el parámetro de consulta action=invoke. | |
adminGroup | string | El nombre del grupo administrativo que está asociado a un punto final de servicio. Es el nombre del grupo de seguridad en el que debe estar el usuario para que se le permita realizar funciones administrativas. Si se ha configurado junto con su equivalente global globalAdminGroup definido bajo el elemento zosConnectManager, se utiliza el valor definido bajo adminGroup. | |
operationsGroup | string | El nombre del grupo de operaciones que está asociado a un punto final de servicio. Es el nombre del grupo de seguridad en el que debe estar el usuario para que se le permita realizar funciones como iniciar, detener o estado. Si se ha configurado junto con su equivalente global, globalOperationsGroupdefined bajo el elemento zosConnectManager, se utiliza el valor definido bajo operationsGroup. | |
invokeGroup | string | El nombre del grupo de invocación que está asociado a un punto final de servicio. Contiene el nombre del grupo de seguridad en el que debe estar el usuario para que se le permita realizar llamadas de invocación. Si se ha configurado junto con su equivalente global globalInvokeGroup definido bajo el elemento zosConnectManager, se utiliza el valor definido bajo invokeGroup. | |
dataXformRef | Una referencia a un elemento zosConnectDataXform de nivel superior (string). | El nombre de referencia que identifica el manejador de transformación de datos que está asociado a un punto final de servicio. Si se ha configurado junto con su equivalente del manejador de transformaciones de datos global globalDataXformRef definido bajo el elemento zosConnectManager, se utiliza el transformador de datos definido para el punto final de servicio. | |
serviceAsyncRequestTimeout | Un período de tiempo con precisión de milisegundos | El valor de tiempo de espera que está asociado a un punto final de servicio cuando se procesa trabajo asíncrono. Especifica el tiempo en milisegundos en el que se deben completar las solicitudes. Este valor de tiempo de espera sustituye el valor de atributo asyncTimeoutDefault del contenedor web. Si no se configuran asyncRequestTimeout ni asyncTimeoutDefault, el tiempo de espera utilizado es el valor predeterminado del atributo asyncTimeoutDefault (es decir, 30 segundos). Si asyncRequestTimeout no está configurado, pero sí lo está el atributo asyncTimeoutDefault, se utiliza el valor configurado de asyncTimeoutDefault. Si se configura junto con su equivalente global, asyncRequestTimeout definido bajo el elemento zosConnectManager, se utiliza el valor definido bajo serviceAsyncRequestTimeout. Se puede exceder el tiempo de espera en cualquier momento durante el proceso de la solicitud por parte de z/OS Connect. Es posible que la solicitud siga activa tras detectarse un tiempo de espera excedido y se envía una respuesta al cliente. 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. | |
requireSecure | boolean | Indica si las solicitudes asociadas a un punto final de servicio se deben realizar mediante el canal HTTPS seguro. Si se ha configurado junto con su equivalente global requireSecure definido bajo el elemento zosConnectManager, se utiliza el valor definido para el punto final de servicio. | |
requireAuth | boolean | Indica si los usuarios deben proporcionar credenciales de seguridad para que z/OS Connect procese las solicitudes asociadas a un punto final de servicio. Si se ha configurado junto con su equivalente global requireAuth definido bajo el elemento zosConnectManager, se utiliza el valor definido para el punto final de servicio. |
El nombre de referencia que identifica el conjunto de interceptores configurados asociados a un punto final de servicio. Si se ha configurado junto con su equivalente de interceptores globales globalInterceptorsRef definido bajo el elemento zosConnectManager, z/OS Connect procesará los dos conjuntos de interceptores. Si el atributo runGlobalInterceptors para el punto final de servicio se establece en false, z/OS Connect solamente procesará el conjunto de interceptores configurado para el punto final de servicio.