Определяет параметры конфигурации для конечной точки службы.
Name | Type | Default | Description |
---|---|---|---|
id | string | Уникальный ИД конфигурации. | |
serviceName | string | Имя, связанное с конечной точкой службы. Это имя идентифицирует конечную точку службы для клиента. | |
serviceRef | Ссылка на элемент localAdaptersConnectService верхнего уровня (строка). | Имя ссылки, идентифицирующее конечную точку службы, которая зарегистрирована в z/OS Connect. | |
serviceDescription | string | Описание, связанное с конечной точкой службы. | |
serviceGroupingName | string | Имя, которое можно использовать для группировки набора конечных точек службы. | |
runGlobalInterceptors | boolean | true | Указывает, следует ли запускать глобальные перехватчики для запросов, связанных с конечной точкой службы. По умолчанию z/OS Connect обрабатывает все глобальные перехватчики и перехватчики, относящиеся к конечной точке службы. |
invokeURI | string | URI или список разделенных запятыми 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. | |
adminGroup | string | Имя административной группы, связанное с конечной точкой службы. Это имя группы защиты, в которую должен входить пользователь, чтобы ему было разрешено выполнять административные функции. Если вместе с этим атрибутом настроен соответствующий глобальный атрибут (т. е. globalAdminGroup в элементе zosConnectManager), то используется значение, определенное в атрибуте adminGroup. | |
operationsGroup | string | Имя группы операций, связанное с конечной точкой службы. Это имя группы защиты, в которую должен входить пользователь, чтобы ему было разрешено выполнять такие операции как start, stop или status. Если вместе с этим атрибутом настроен соответствующий глобальный атрибут (т. е. globalOperationsGroupdefined в элементе zosConnectManager), то используется значение, определенное в атрибуте operationsGroup. | |
invokeGroup | string | Имя группы вызова, связанное с конечной точкой службы. Это имя группы защиты, в которую должен входить пользователь, чтобы ему было разрешено выполнять вызовы 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 сек. | |
requireSecure | boolean | Указывает, должны ли выполняться с помощью защищенного канала HTTPS запросы, связанные с конечной точкой службы. Если вместе с этим атрибутом настроен соответствующий глобальный атрибут requireSecure, определенный в элементе zosConnectManager, то будет использоваться значение, определенное в конечной точке службы. | |
requireAuth | boolean | Указывает, должны ли пользователи предоставлять в z/OS Connect идентификационные данные для обработки запросов, связанных с конечной точкой службы. Если вместе с этим атрибутом настроен соответствующий глобальный атрибут requireAuth, определенный в элементе zosConnectManager, то будет использоваться значение, определенное в конечной точке службы. |
Имя ссылки, идентифицирующее набор настроенных перехватчиков, связанных с конечной точкой службы. Если одновременно с этими перехватчиками настроены глобальные перехватчики (атрибут globalInterceptorsRef в элементе zosConnectManager), то z/OS Connect обрабатывает оба набора перехватчиков. Если в атрибуте runGlobalInterceptors для конечной точки службы указано значение false, то z/OS Connect будет обрабатывать только набор перехватчиков, настроенных для этой конечной точки.