定義服務端點的配置設定。
Name | Type | Default | Description |
---|---|---|---|
id | string | 唯一的配置 ID。 | |
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 | 某個服務端點相關聯的管理群組名稱。這是使用者必須隸屬的安全群組名稱,才允許其執行管理功能。如果還配置其廣域對應項目(定義在 zosConnectManager 元素之下的 globalAdminGroup),則會使用 adminGroup 之下所定義的值。 | |
operationsGroup | string | 某個服務端點相關聯的作業群組名稱。這是使用者必須隸屬的安全群組名稱,才允許其執行啟動、停止或狀態等之類作業。如果還配置其廣域對應項目 globalOperationsGroupdefined(定義在 zosConnectManager 元素之下),則會使用 operationsGroup 之下所定義的值。 | |
invokeGroup | string | 某個服務端點相關聯的呼叫群組名稱。它含有安全群組的名稱,使用者必須隸屬該安全群組,才允許其執行呼叫。如果還配置其廣域對應項目 globalInvokeGroup(定義在 zosConnectManager 元素之下),則會使用 invokeGroup 之下所定義的值。 | |
dataXformRef | 最上層 zosConnectDataXform 元素的參照(字串)。 | 此參照名稱識別某個服務端點相關聯的資料轉換處理程式。如果還配置其廣域資料轉換處理程式對應項目 globalDataXformRef(定義在 zosConnectManager 元素之下),則會使用定義給該服務端點的資料轉換器。 | |
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 秒。 | |
requireSecure | boolean | 指出是否必須使用安全 HTTPS 通道,來發出服務端點相關聯的要求。如果還配置其廣域對應項目 requireSecure(定義在 zosConnectManager 元素之下),則會使用定義給服務端點的值。 | |
requireAuth | boolean | 指出使用者是否必須提供安全認證,z/OS Connect 才能處理服務端點相關聯的要求。如果還配置其廣域對應項目 requireAuth(定義在 zosConnectManager 元素之下),則會使用定義給服務端點的值。 |
此參照名稱識別與某個服務端點相關聯的一組已配置的攔截程式。如果還配置其廣域攔截程式對應項目 globalInterceptorsRef(定義在 zosConnectManager 元素之下),則 z/OS Connect 會同時處理這兩組攔截程式。如果服務端點的 runGlobalInterceptors 屬性設為 false,z/OS Connect 只會處理配置給服務端點的一組攔截程式。