zosConnectService - z/OS Connect-Endpunkt (zosConnectService)

Definiert die Konfigurationseinstellungen für einen Serviceendpunkt.

NameTypeDefaultDescription
idstringEine eindeutige Konfigurations-ID.
serviceNamestringName, der einem Serviceendpunkt zugeordnet wird. Dieser Name identifiziert einen Serviceendpunkt für einen Client.
serviceRefReferenz auf das localAdaptersConnectService-Element (string) der höchsten Ebene.Referenzname, der den bei z/OS Connect registrierten Serviceendpunkt identifiziert.
serviceDescriptionstringBeschreibung, die einem Serviceendpunkt zugeordnet wird.
serviceGroupingNamestringDer Name, der verwendet werden kann, um mehrere Serviceendpunkte zu gruppieren oder einander zuzuordnen.
runGlobalInterceptorsbooleantrueGibt an, ob globale Interceptors für Anforderungen, die einem Serviceendpunkt zugeordnet sind, ausgeführt werden sollen. Standardmäßig verarbeitet z/OS Connect alle globalen und alle serviceendpunktspezifischen Interceptors.
invokeURIstringURI oder durch Kommas getrennte Liste der URIs für einen Serviceendpunkt. Aufruf-URIs können mit einem Platzhalterzeichen in der Form /a/b/* oder x/y* enden, um einen Serviceendpunktaufruf generisch abzugleichen. Die Angabe mehrerer Platzhalterzeichen (z. B. /a/b/**) und die Angabe von Platzhalterzeichen in der Mitte des Anforderungs-URI (z. B. /a/*/c) werden nicht unterstützt. Wenn Serviceendpunkten mit konfigurierten Aufruf-URIs mit Platzhalter überlappenden Aufruf-URIs zugeordnet werden, wird als Übereinstimmung der Serviceendpunkt gewertet, dem der spezifischste Aufruf-URI zugeordnet ist. Wenn beispielsweise eine Serviceendpunktanforderung mit dem https://Host:Port/a/b/c an einen Server mit der Konfiguration service1 -> invokeURI="/a/b/c/*" und service2 -> invokeURI="/a/b/*" abgesetzt wird, ordnet z/OS Connect die Anforderung service1 zu. Konfigurierte invokeURI-Einträge müssen mit dem Zeichen / beginnen. Die Verwendung eines invokeURI-Eintrags entspricht einer Serviceanforderung, bei der der Abfrageparameter action=invoke angegeben ist.
adminGroupstringName der Administrationsgruppe, die einem Serviceendpunkt zugeordnet wird. Dies ist der Name der Sicherheitsgruppe, der der Benutzer angehören muss, bevor Verwaltungsfunktionen zugelassen werden. Wenn dieser Name zusammen mit seiner globalen Entsprechung (globalAdminGroup im Element zosConnectManager) konfiguriert wird, wird der für adminGroup definierte Wert verwendet.
operationsGroupstringName der Operationsgruppe, die einem Serviceendpunkt zugeordnet wird. Dies ist der Name der Sicherheitsgruppe, der der Benutzer angehören muss, bevor Operationen wie Start-, Stopp- oder Statusoperationen zugelassen werden. Wenn dieser Name zusammen mit seiner globalen Entsprechung (globalOperationsGroup im Element zosConnectManager) konfiguriert wird, wird der für operationsGroup definierte Wert verwendet.
invokeGroupstringName der Aufrufgruppe, die einem Serviceendpunkt zugeordnet wird. Dies ist der Name der Sicherheitsgruppe, der der Benutzer angehören muss, bevor Aufrufe zugelassen werden. Wenn dieser Name zusammen mit seiner globalen Entsprechung (globalInvokeGroup im Element zosConnectManager) konfiguriert wird, wird der für invokeGroup definierte Wert verwendet.
dataXformRefReferenz auf das zosConnectDataXform-Element (string) der höchsten Ebene.Referenzname, der den Datentransformationshandler identifiziert, der einem Serviceendpunkt zugeordnet wird. Wenn dieser Name zusammen mit seiner globalen Entsprechung (globalDataXformRef im Element zosConnectManager) konfiguriert wird, wird der für den Serviceendpunkt definierte Datentransformator verwendet.
serviceAsyncRequestTimeoutZeitraum mit Genauigkeit in MillisekundenZeitlimitwert, der einem Serviceendpunkt bei der Verarbeitung asynchroner Arbeiten zugeordnet wird. Der Wert gibt die Zeit in Millisekunden an, innerhalb derer Anforderungen ausgeführt werden müssen. Dieser Zeitlimitwert überschreibt den Wert des Attributs asyncTimeoutDefault des Web-Containers. Wenn weder asyncRequestTimeout noch asyncTimeoutDefault konfiguriert ist, wird der Standardwert des Attributs asyncTimeoutDefault (d. h. 30 Sekunden) als Zeitlimit verwendet. Wenn asyncRequestTimeout nicht konfiguriert ist, aber das Attribut asyncTimeoutDefault, wird der für asyncTimeoutDefault konfigurierte Wert verwendet. Wenn dieser Name zusammen mit seiner globalen Entsprechung (asyncRequestTimeout im Element zosConnectManager) konfiguriert wird, wird der für serviceAsyncRequestTimeout definierte Wert verwendet. Eine Zeitlimitüberschreitung kann jederzeit während der Verarbeitung der Anforderung durch z/OS Connect auftreten. Die Anforderung kann auch nach der Erkennung der Zeitlimitüberschreitung weiterhin aktiv sein und es wird eine Antwort an den Client gesendet. Geben Sie eine positive ganze Zahl, gefolgt von einer Zeiteinheit, an. Die gültigen Zeiteinheiten sind Stunden (h), Minuten (m), Sekunden (s) und Millisekunden (ms). Geben Sie 500 Millisekunden beispielsweise als 500ms an. Sie können mehrere Werte in einen einzigen Eintrag einschließen. 1s500ms entspricht beispielsweise 1,5 Sekunden.
requireSecurebooleanGibt an, ob Anforderungen, die einem Serviceendpunkt zugeordnet sind, über den sicheren HTTPS-Kanal abgesetzt werden müssen. Wenn dieser Name zusammen mit seiner globalen Entsprechung (requireSecure im Element zosConnectManager) konfiguriert wird, wird der für den Serviceendpunkt definierte Wert verwendet.
requireAuthbooleanGibt an, ob Benutzer Sicherheitsberechtigungsnachweise bereitstellen müssen, damit z/OS Connect Anforderungen, die einem Serviceendpunkt zugeordnet sind, verarbeitet. Wenn dieser Name zusammen mit seiner globalen Entsprechung (requireAuth im Element zosConnectManager) konfiguriert wird, wird der für den Serviceendpunkt definierte Wert verwendet.

interceptorsRef

Referenzname, der die Gruppe konfigurierter Interceptors identifiziert, die einem Serviceendpunkt zugeordnet werden. Wenn dieser Name zusammen mit seiner globalen Entsprechung (globalInterceptorsRef im Element zosConnectManager) konfiguriert wird, verarbeitet z/OS Connect beide Gruppen von Interceptors. Wenn das Attribut runGlobalInterceptors für den Serviceendpunkt auf false gesetzt ist, verarbeitet z/OS Connect nur die Gruppe von Interceptors, die für den Serviceendpunkt konfiguriert sind.