Definiert die Konfigurationseinstellungen für einen Serviceendpunkt.
Name | Type | Default | Description |
---|---|---|---|
id | string | Eine eindeutige Konfigurations-ID. | |
serviceName | string | Name, der einem Serviceendpunkt zugeordnet wird. Dieser Name identifiziert einen Serviceendpunkt für einen Client. | |
serviceRef | Referenz auf das localAdaptersConnectService-Element (string) der höchsten Ebene. | Referenzname, der den bei z/OS Connect registrierten Serviceendpunkt identifiziert. | |
serviceDescription | string | Beschreibung, die einem Serviceendpunkt zugeordnet wird. | |
serviceGroupingName | string | Der Name, der verwendet werden kann, um mehrere Serviceendpunkte zu gruppieren oder einander zuzuordnen. | |
runGlobalInterceptors | boolean | true | Gibt 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. |
invokeURI | string | URI 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. | |
adminGroup | string | Name 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. | |
operationsGroup | string | Name 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. | |
invokeGroup | string | Name 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. | |
dataXformRef | Referenz 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. | |
serviceAsyncRequestTimeout | Zeitraum mit Genauigkeit in Millisekunden | Zeitlimitwert, 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. | |
requireSecure | boolean | Gibt 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. | |
requireAuth | boolean | Gibt 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. |
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.