z/OS Connect 端點 (zosConnectService)
定義服務端點的配置設定。
| 屬性名稱 | 資料類型 | 預設值 | 說明 |
|---|---|---|---|
| adminGroup | 字串 | 服務端點相關聯的管理群組名稱。這是安全群組名稱,使用者必須位於這個群組中,才允許執行管理功能。如果還配置其廣域對應項目(定義在 zosConnectManager 元素之下的 globalAdminGroup),則會使用 adminGroup 之下所定義的值。 | |
| dataXformRef | 最上層 zosConnectDataXform 元素的參照(字串)。 | 用來識別服務端點相關聯資料轉換處理程式的參照名稱。如果還配置其廣域資料轉換處理程式對應項目(定義在 zosConnectManager 元素之下的 globalDataXformRef),則會使用定義給該服務端點的資料轉換器。 | |
| id | 字串 | 唯一的配置 ID。 | |
| invokeGroup | 字串 | 呼叫服務端點相關聯的群組名稱。它含有安全群組名稱,使用者必須位於這個群組中,才允許執行呼叫。如果還配置其廣域對應項目(定義在 zosConnectManager 元素之下的 globalInvokeGroup),則會使用 invokeGroup 之下所定義的值。 | |
| invokeURI | 字串 | 服務端點相關聯的 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 查詢參數的服務要求。 | |
| operationsGroup | 字串 | 服務端點相關聯的作業群組名稱。這是安全群組名稱,使用者必須位於這個群組中,才允許執行啟動、停止或狀態等之類的作業。如果它是連同其廣域對應項目(zosConnectManager 元素之下所定義的 globalOperationsGroup)一起配置,就會使用 operationsGroup 之下所定義的值。 | |
| requireAuth | 布林 | 指出使用者是否必須提供安全認證,z/OS Connect 才能處理服務端點相關聯的要求。如果還配置其廣域對應項目(定義在 zosConnectManager 元素之下的 requireAuth),則會使用定義給服務端點的值。 | |
| requireSecure | 布林 | 指出是否必須使用安全 HTTPS 通道,來發出服務端點相關聯的要求。如果還配置其廣域對應項目(定義在 zosConnectManager 元素之下的 requireSecure),則會使用定義給服務端點的值。 | |
| runGlobalInterceptors | 布林 | True | 指出是否應針對服務端點相關聯的要求,執行廣域攔截程式。依預設,z/OS Connect 會處理廣域和服務端點特定的所有攔截程式。 |
| serviceAsyncRequestTimeout | 具有毫秒精準度的時間量 | 在處理非同步工作時,服務端點相關聯的逾時值。這是指定要求必須在多少毫秒內完成。此逾時值會置換 Web 儲存器的 asyncTimeoutDefault 屬性值。如果 asyncRequestTimeout 和 asyncTimeoutDefault 都沒有配置,所用的逾時值是 asyncTimeoutDefault 屬性預設值(亦即,30 秒)。如果沒有配置 asyncRequestTimeout,但有配置 asyncTimeoutDefault 屬性,則會使用 asyncTimeoutDefault 所配置的值。如果它是連同其廣域對應項目(zosConnectManager 元素之下所定義 asyncRequestTimeout)一起配置,則會使用 serviceAsyncRequestTimeout 之下所定義的值。在 z/OS Connect 處理要求期間,隨時可能發生逾時。在偵測到逾時,並傳送回應給用戶端之後,要求仍可維持作用中。請指定一個正整數,後面接著一個時間單位,可以是時 (h)、分 (m)、秒 (s) 或毫秒 (ms)。 例如,500 毫秒指定為 500ms。 單一項目可以包含多個值。比方說,1s500ms 相當於 1.5 秒。 | |
| serviceDescription | 字串 | 服務端點相關聯的說明。 | |
| serviceGroupingName | 字串 | 可用來將一組服務端點分組或關聯在一起的名稱。 | |
| serviceName | 字串 | 服務端點相關聯的名稱。這是向用戶端識別服務端點的名稱。 | |
| serviceRef | 最上層 localAdaptersConnectService 元素的參照(字串)。 | 用來識別向 z/OS Connect 登錄之服務端點的參照名稱。 |
參照主題