定义服务端点的配置设置。
Name | Type | Default | Description |
---|---|---|---|
id | 字符串 | 唯一配置标识。 | |
serviceName | string | 与服务端点相关联的名称。此名称对客户机标识服务端点。 | |
serviceRef | 对顶级 localAdaptersConnectService 元素的引用(字符串)。 | 引用名,它标识已向 z/OS Connect 注册的服务端点。 | |
serviceDescription | string | 与服务端点相关联的描述。 | |
serviceGroupingName | string | 可以用于将一系列服务端点组合在一起或者使这些服务端点相关联的名称。 | |
runGlobalInterceptors | 布尔型 | 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 | 与服务端点相关联的操作组名。它是安全组的名称,用户需要处于该组中,然后才能执行诸如启动、停止或查看状态之类的操作。如果同时配置了该操作组及其全局等效项(元素 zosConnectManager 下定义的 globalOperationsGroup),那么将使用 operationsGroup 下定义的值。 | |
invokeGroup | string | 与服务端点相关联的调用组名。它是安全组的名称,用户需要处于该组中,然后才能执行调用。如果同时配置了该管理组及其全局等效项(元素 zosConnectManager 下定义的 globalInvokeGroup),那么将使用 invokeGroup 下定义的值。 | |
dataXformRef | 对顶级 zosConnectDataXform 元素的引用(字符串)。 | 引用名,它标识与服务端点相关联的数据转换处理程序。如果同时配置了该数据转换处理程序及其全局数据变换处理程序等效项(元素 zosConnectManager 下定义的 globalDataXformRef),那么将使用为该服务端点定义的数据变换器。 | |
serviceAsyncRequestTimeout | 具有毫秒精度的时间段 | 处理异步工作时的超时值,它与服务端点相关联。它指定以毫秒计的时间,请求必须在该时间内完成。此超时值覆盖 Web 容器的 asyncTimeoutDefault 属性值。如果既未配置 asyncRequestTimeout,也未配置 asyncTimeoutDefault,那么使用的超时是 asyncTimeoutDefault 属性缺省值(即,30 秒)。如果未配置 asyncRequestTimeout,但配置了 asyncTimeoutDefault 属性,那么将使用 asyncTimeoutDefault 的已配置值。如果同时配置了该超时及其全局等效项(元素 zosConnectManager 下定义的 asyncRequestTimeout),那么将使用 serviceAsyncRequestTimeout 下定义的值。在 z/OS Connect 处理请求期间,任何时候都可能发生超时。在检测到该超时并将响应发送至客户机后,该请求可能仍处于活动状态。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。 | |
requireSecure | 布尔型 | 指示是否必须使用安全 HTTPS 通道执行与服务端点关联的请求。如果同时配置了该项及其全局等效项(zosConnectManager 元素下定义的 requireSecure),那么将使用为服务端点定义的值。 | |
requireAuth | 布尔型 | 指示用户是否必须提供安全凭证以便 z/OS Connect 可处理与服务端点关联的请求。如果同时配置了该项及其全局等效项(zosConnectManager 元素下定义的 requireAuth),那么将使用为服务端点定义的值。 |
引用名,它标识与服务端点相关联的一组已配置拦截器。如果同时配置了这组拦截器及其全局拦截器等效项(zosConnectManager 元素下定义的 globalInterceptorsRef),那么 z/OS Connect 将处理这两组拦截器。如果将服务端点的 runGlobalInterceptors 属性设置为 false,那么 z/OS Connect 将仅处理为该服务端点配置的这组拦截器。