zosConnectService - Конечная точка z/OS Connect (zosConnectService)

Определяет параметры конфигурации для конечной точки службы.

NameTypeDefaultDescription
idstringУникальный ИД конфигурации.
serviceNamestringИмя, связанное с конечной точкой службы. Это имя идентифицирует конечную точку службы для клиента.
serviceRefСсылка на элемент localAdaptersConnectService верхнего уровня (строка).Имя ссылки, идентифицирующее конечную точку службы, которая зарегистрирована в z/OS Connect.
serviceDescriptionstringОписание, связанное с конечной точкой службы.
serviceGroupingNamestringИмя, которое можно использовать для группировки набора конечных точек службы.
runGlobalInterceptorsbooleantrueУказывает, следует ли запускать глобальные перехватчики для запросов, связанных с конечной точкой службы. По умолчанию z/OS Connect обрабатывает все глобальные перехватчики и перехватчики, относящиеся к конечной точке службы.
invokeURIstringURI или список разделенных запятыми URI для связи с конечной точкой службы. Атрибуты InvokeURI могут заканчиваться символом подстановки в форме /a/b/* или x/y*; это позволяет задать шаблон вызова конечной точки службы. Указание нескольких символов подстановки (т. е. /a/b/**) или символов подстановки в середине requestURI (то есть /a/*/c) не поддерживается. Если конечные точки службы с атрибутами invokeURI, настроенными с символом подстановки, связываются с перекрывающимися invokeURI, то шаблону будет соответствовать конечная точка службы, связанная наиболее точным invokeURI. Например, если запрос конечной точки службы выполняется с помощью следующего: https://host:port/a/b/c с переходом на сервер со следующей конфигурацией: service1 -> invokeURI="/a/b/c/*" и service2 -> invokeURI="/a/b/*", то z/OS Connect будет сопоставлять запрос с service1. Настроенная запись invokeURI должна начинаться с символа /. Использование параметра invokeURI эквивалентно запросу на обслуживание, в котором указан параметр action=invoke.
adminGroupstringИмя административной группы, связанное с конечной точкой службы. Это имя группы защиты, в которую должен входить пользователь, чтобы ему было разрешено выполнять административные функции. Если вместе с этим атрибутом настроен соответствующий глобальный атрибут (т. е. globalAdminGroup в элементе zosConnectManager), то используется значение, определенное в атрибуте adminGroup.
operationsGroupstringИмя группы операций, связанное с конечной точкой службы. Это имя группы защиты, в которую должен входить пользователь, чтобы ему было разрешено выполнять такие операции как start, stop или status. Если вместе с этим атрибутом настроен соответствующий глобальный атрибут (т. е. globalOperationsGroupdefined в элементе zosConnectManager), то используется значение, определенное в атрибуте operationsGroup.
invokeGroupstringИмя группы вызова, связанное с конечной точкой службы. Это имя группы защиты, в которую должен входить пользователь, чтобы ему было разрешено выполнять вызовы invoke. Если вместе с этим атрибутом настроен соответствующий глобальный атрибут (т. е. globalInvokeGroup в элементе zosConnectManager), то используется значение, определенное в атрибуте invokeGroup.
dataXformRefСсылка на элемент zosConnectDataXform верхнего уровня (строка).Имя ссылки, идентифицирующее обработчик преобразования данных, связанный с конечной точкой службы. Если одновременно с этим обработчиком настроен глобальный обработчик преобразования данных (атрибут globalDataXformRef в элементе zosConnectManager), то используется преобразователь данных, определенный для конечной точки службы.
serviceAsyncRequestTimeoutПериод (с точностью до миллисекунды)Значение тайм-аута, связанное с конечной точкой службы при обработке в асинхронном режиме. Задает время (в миллисекундах), в течение которого должен обрабатываться запрос. Это значение тайм-аута переопределяет значение атрибута asyncTimeoutDefault веб-контейнера. Если не настроен ни атрибут asyncRequestTimeout, ни атрибут asyncTimeoutDefault, то для тайм-аута используется значение по умолчанию атрибута asyncTimeoutDefault (которое равно 30 секундам). Если атрибут asyncRequestTimeout не настроен, но настроен атрибут asyncTimeoutDefault, то используется значение атрибута asyncTimeoutDefault. Если одновременно с этим атрибутом настроен соответствующий глобальный атрибут (атрибут asyncRequestTimeout в элементе zosConnectManager), то используется значение, указанное в атрибуте serviceAsyncRequestTimeout. Тайм-аут может произойти в любой момент, пока z/OS Connect обрабатывает запрос. После тайм-аута запрос может продолжать оставаться активным, и клиенту отправляется ответ. Укажите положительное целое число, за которым следует единица времени: часы (h), минуты (m), секунды (s) или миллисекунды (ms). Например, укажите 500 миллисекунд как 500ms. Одна запись может включать несколько значений. Так, 1s500ms равно 1,5 сек.
requireSecurebooleanУказывает, должны ли выполняться с помощью защищенного канала HTTPS запросы, связанные с конечной точкой службы. Если вместе с этим атрибутом настроен соответствующий глобальный атрибут requireSecure, определенный в элементе zosConnectManager, то будет использоваться значение, определенное в конечной точке службы.
requireAuthbooleanУказывает, должны ли пользователи предоставлять в z/OS Connect идентификационные данные для обработки запросов, связанных с конечной точкой службы. Если вместе с этим атрибутом настроен соответствующий глобальный атрибут requireAuth, определенный в элементе zosConnectManager, то будет использоваться значение, определенное в конечной точке службы.

interceptorsRef

Имя ссылки, идентифицирующее набор настроенных перехватчиков, связанных с конечной точкой службы. Если одновременно с этими перехватчиками настроены глобальные перехватчики (атрибут globalInterceptorsRef в элементе zosConnectManager), то z/OS Connect обрабатывает оба набора перехватчиков. Если в атрибуте runGlobalInterceptors для конечной точки службы указано значение false, то z/OS Connect будет обрабатывать только набор перехватчиков, настроенных для этой конечной точки.