Defineşte setările de configurare pentru un punct final de serviciu.
Name | Type | Default | Description |
---|---|---|---|
id | şir | Un ID de configuraţie unic. | |
serviceName | string | Numele care este asociat cu un punct final de serviciu. Acest nume identifică un punct final de serviciu cu un client. | |
serviceRef | O referinţă la elementul de nivel înalt localAdaptersConnectService (şir). | Numele referinţei care identifică punctul final de serviciu care este înregistrat cu z/OS Connect. | |
serviceDescription | string | Descrierea care este asociată cu un punct final de serviciu. | |
serviceGroupingName | string | Numele care poate fi utilizat pentru a grupa sau asocia un set de puncte finale de servicii împreună. | |
runGlobalInterceptors | boolean | true | Indică dacă interceptorii globali ar trebui să ruleze pentru cereri asociate cu un punct final de serviciu. Implicit, z/OS Connect procesează toţi interceptorii globali şi pe cei specifici tuturor punctelor finale de servicii. |
invokeURI | string | URI-ul sau lista de URI-uri separate prin virgule pentru asocierea cu un punct final de serviciu. InvokeURI-urile se pot termina cu un metacaracter de forma /a/b/* sau x/y* pentru a se potrivi generic cu o invocare de punct final de serviciu. Specificarea metacaracterelor multiple (de ex. /a/b/**) sau metacaractere în mijlocul requestURI (de ex. /a/*/c) nu este suportat. Dacă punctele finale ale serviciilor cu invokeURI-uri configurate care utilizează metacaracterul sunt asociate cu invokeURI-uri suprapuse, punctul final al serviciului asociat cu cel mai specific invokeURI este potrivit. De exemplu, dacă este lansată o cerere de punct final serviciu cu următoarea cale: https://host:port/a/b/c care conduce la un server cu următoarea configuraţie: service1 -> invokeURI="/a/b/c/*" şi service2 -> invokeURI="/a/b/*", z/OS Connect va împerechea cererea cu service1. Intrările invokeURI configurate trebuie să înceapă cu caracterul /. Utilizarea unui invokeURI este echivalent cu o cerere de serviciu unde este specificat parametrul de interogare action=invoke. | |
adminGroup | string | Numele grupului administrativ care este asociat cu un punct final de serviciu. Este numele grupului de securitate în care trebuie să fie utilizatorul înainte să fie permise funcţiile administrative. Dacă este configurat odată cu contraponderea sa globală globalAdminGroup care este definită sub elementul zosConnectManager, este utilizată valoarea definită sub adminGroup. | |
operationsGroup | string | Numele grupului de operaţii care este asociat cu un punct final de serviciu. Este numele grupului de securitate în care trebuie să fie utilizatorul înainte să fie permise operaţiile de pornire, oprire sau stare. Dacă este configurat odată cu contraponderea sa globală, globalOperationsGroupdefined definit sub elementul zosConnectManager, este utilizată valoarea definită sub operationsGroup. | |
invokeGroup | string | Numele grupului de invocări care este asociat cu un punct final de serviciu. Conţine numele grupului de securitate în care trebuie să fie utilizatorul înainte să fie permise apelurile de invocare. Dacă este configurat odată cu contraponderea sa globală globalInvokeGroup care este definită sub elementul zosConnectManager, este utilizată valoarea definită sub invokeGroup. | |
dataXformRef | O referinţă la elementul de nivel înalt zosConnectDataXform (şir). | Numele referinţei care identifică handler-ul de transformare date care este asociat cu un punct final de serviciu. Dacă este configurat odată cu contraponderea sa globală handler de transformare date globalDataXformRef care este definită sub elementul zosConnectManager, este utilizat transformatorul de date definit pentru punctul final al serviciului. handler | |
serviceAsyncRequestTimeout | O perioadă de timp cu precizie de milisecunde | Valoarea de timeout care este asociată cu un punct final de serviciu la procesarea asincronă a activităţii. Specifică intervalul de timp, în milisecunde, în care trebuie să se finalizeze cererile. Această valoare de timeout înlocuieşte valoarea de atribut a containerului web asyncTimeoutDefault. Dacă nu sunt configurate nici asyncRequestTimeout nici asyncTimeoutDefault, timeout-ul utilizat este valoarea implicită a atributului asyncTimeoutDefault (i.e. 30 secunde). Dacă asyncRequestTimeout nu este configurat dar atributul asyncTimeoutDefault este, este folosită valoarea configurată pentru asyncTimeoutDefault. Dacă este configurat odată cu contraponderea sa globală: asyncRequestTimeout definit sub elementul zosConnectManager, este utilizată valoarea definită sub serviceAsyncRequestTimeout. Un timeout poate surveni în orice moment în timpul procesării de către z/OS Connect a cererii. Cererea ar putea fi încă activă după ce timeout-ul este detectat şi este trimis un răspuns la client. Specificaţi un întreg pozitiv urmat de o unitate de timp, care poate fi ore (o), minute (m), secunde (s) sau milisecunde (ms). De exemplu, specificaţi 500 milisecunde ca 500ms. Puteţi include valori multiple într-o singură intrare. De exemplu, 1s500ms este echivalent cu 1.5 secunde. | |
requireSecure | boolean | Indică dacă cererile asociate cu un punct final de serviciu trebuie făcute utilizând canalul securizat HTTPS. Dacă este configurat odată cu contraponderea sa globală requireSecure care este definită sub elementul zosConnectManager, este utilizată valoarea definită pentru punctul final al serviciului. | |
requireAuth | boolean | Indică dacă utilizatorii trebuie să furnizeze acreditări de securitate pentru ca z/OS Connect să proceseze cereri asociate cu un punct final de serviciu. Dacă este configurat odată cu contraponderea sa globală requireAuth care este definită sub elementul zosConnectManager, este utilizată valoarea definită pentru punctul final al serviciului. |
Numele referinţei care identifică setul de interceptori configuraţi care este asociat cu un punct final de serviciu. Dacă este configurat odată cu contraponderea sa globală de interceptori globalInterceptorsRef care este definită sub elementul zosConnectManager, z/OS Connect procesează ambele seturi de interceptori. Dacă atributul runGlobalInterceptors pentru punctul final de serviciu este setat la false, z/OS Connect va procesa numai setul de interceptori configuraţi pentru punctul final de serviciu.