配置扩展设置

在线编辑

您可以在扩展设置部分配置高级参数设置。这些参数会影响服务器的运行。除非 IBM® 全球支持中心要求，否则不要更改这些设置。除扩展设置外，您还可以配置瓦特参数设置。

准备工作

您必须拥有 "管理用户管理 "功能权限才能配置扩展设置。

过程

打开菜单选项，选择管理。
选择常规 > 扩展设置。
单击显示和隐藏按键。这将显示所有可配置的参数。
您可以通过提供必要的值在扩展密钥部分配置以下任何参数。配置值列在页面开头的扩展设置下。
allowEGInvokeOnly
指定当外部端口设置为 HTTPS ，注册和内部端口设置为 HTTP 时，是否可以使用反向调用方法启动传输策略设置为 HTTP, 的 SOAP API。请确保在创建 SOAP API 的系统中启用此设置。
注意：此设置只影响 SOAP API 的行为。您可以使用反向 invoke 方法调用 REST API，而无需考虑条件为真的设置。可能的值是

True - 如果外部端口设置为 HTTPS ，并且注册和内部端口设置为 HTTP ，则可以使用反向调用方法调用 SOAP API。

False — 您不能使用反向调用方法调用 SOAP API。
allowExceedMaxWindowSize
指定 Elasticsearch 在单次请求中检索的记录数是否超过配置值。可能的值如下
- 正确。单次请求检索的记录数可能会超过 Elasticsearch 中配置的最大值。这是缺省值。
- 错误。当单次请求检索的记录数超过配置值时，显示错误信息。
allowedTracerCount

指定是否存储特定时间点的跟踪器调用总数。

默认值为 100，最大值为 1000。

apiDocumentsRestrictedExtension
指定受限文件扩展名列表，以防止用户上传带有这些扩展名的文件作为 API 的输入文件。例如，带有.exe 文件扩展名的文件可能包含可执行代码，下载后可按需运行。如果带有.exe 文件扩展名的文件受到限制，用户就不能在.exe 文件中上传带有.exe 扩展名的文件。 webMethods API Gateway. 默认情况下，会阻止几个标准文件扩展名，包括 Windows 资源管理器视为可执行文件的任何文件扩展名。默认阻止的文件扩展名有
- .bat - 批量文件
- .bin - 二进制文件
- .dll - Windows 动态链接库
- .exe - 可执行程序
您可以删除任何或所有默认文件扩展名。
apiDocumentsUploadSizeLimitInMB

指定可作为 API 输入文档上传的最大文档大小（以 MB 为单位）。缺省值是 5。该属性可防止用户上传可能会减慢系统运行速度的巨大文件。

apig_MENConfiguration_tickInterval

指定处理器每次迭代的时间间隔（秒）。您提供的值必须是最小策略间隔（一分钟）的可整除分数。缺省值为 15。

注意：由于该设置属于系统级设置，因此在修改该设置时务必谨慎。

apig_rest_服务重定向
提供 true 值可将传入的服务请求重定向到下列指令之一，这些指令除 webMethods API Gateway 除 /gateway 指令外，还支持以下指令之一。
- /ws
- /mediator
缺省值为 false。
apig_schemaValidationPoolSize

提供指定模式验证池大小的值。缺省值是 10。

apiGroupingPossibleValues
指定 API 组的名称。您可以将应用程序接口关联到相关的应用程序接口组来组织它们。默认提供的组如下。
- 金融银行与保险
- 销售和订购
- 搜索
- 运输和仓储
您可以根据需要添加、编辑或删除 API 组。
apiKeyExpirationPeriod
指定 API 密钥的有效时间。您可以以秒、分、天、月或年为单位提供价值。例如，8 秒、 8s、10 个月、10 米、15 分钟、15 分钟。过期日期的计算方法如下。
- 创建新应用程序时：有效期 = 创建应用程序的时间 + apiKeyExpirationPeriod 参数中指定的值。
- API 访问密钥再生时：有效期 = API 密钥再生的时间 + apiKeyExpirationPeriod 参数中指定的值。
如果不指定值，则 API 密钥永不过期。
apiKeyHeader

指定 HTTP 标头名称，以便 webMethods API Gateway 从接收到的客户端请求中获取 API 密钥。默认值为 x-Gateway-APIKey。

apiMaturityStatePossibleValues

指定可为 API 设置的 API 成熟度状态值。您可以根据应用程序接口的成熟度搜索它们。提供的默认值包括测试版、废弃版、实验版、生产版和测试版。

appMesh.microgateway.logLevel

指定微网关的日志级别。 webMethods API Gateway. 默认值为 ERROR。可能的值有 TRACE、DEBUG、INFO、WARN、ERROR、FATAL。

clusterNotifierCacheStaleInterval

指定 ClusterNotifierCache 中的数据被视为过时数据并从缓存中删除的时间间隔。缺省值为 900 秒。如果您提供的是非数字值， API Gateway 会将该值解释为默认值 900 秒。如果您提供的值小于 60 秒、 webMethods API Gateway 将该值解释为 60 秒的较小限制。 ClusterNotifierCache 维护一个数据结构，该结构为集群中的每个活动成员设置了一个条目。该数据结构用于在群集成员之间交流 API 定义、应用程序、策略等方面的变更。当集群成员从容关闭时，它会从数据结构中删除其条目。但是，当群集成员进程停止时，条目仍然存在，其他群集成员会继续向该条目发布通知。为避免无休止的增长导致性能下降，会对集群数据结构进行监控，以防集群成员缺席。如果群集成员在配置的 clusterNotifierCacheStaleInterval 的时间内做出反应，则被视为过时，其数据将从 ClusterNotifierCache.

decodeAllDelimitersInURI
指定是否必须对传入客户端请求中 URL 的编码字符进行解码。 URL 按照 URI 规范或用户要求进行编码。可能的值 -
- 正确。 URL 中的编码字符将被解码。
- 错误。 URL 中的编码字符不会被解码。这是缺省值。
defaultSearchResultSize

指定搜索请求中事件和指标数据的默认大小。默认值是 1000.If ，如果您提供一个值 -1 ，它会显示所有搜索结果。

designTimeOutboundClientHostnameVerifierEnabled
指定对设计时向外 HTTPS 连接启用或禁用主机名验证器。这些连接在创建应用程序接口时是必要的。可能的值 -
- True - 启用主机名校验器。
- False - 禁用主机名校验器。这是缺省值。
disableRemoteEntityReference
指定在创建 SOAP API 时是否解析远程实体引用。可能的值为：
- 确实如此。在创建 SOAP API 时禁用远程实体引用解析。
- 假的在创建 SOAP API 时，启用远程实体引用解析。
enableHotdeploy
指定是否启用热部署功能。启用此功能后，您可以修改活动 API。默认值为 "true"。可能的值 -
- True - 启用热部署功能。这是缺省值。
- False - 禁用热部署功能。
注意：修改此设置时，请确保刷新浏览器，以反映正在进行的用户会话的更改。
enableImportBackup
提供了一个在覆盖 API 之前确保其安全的选项。可用值为
- True - 如果将值设为 true，则在导入过程中出现错误时会恢复现有 API。这是缺省值。
- False - 如果设置为 false，则会禁用在覆盖前保护现有 API 的功能。如果由于导入过程中的错误导致覆盖失败，则必须删除现有的 API。
enableTeamWork
指定是否启用 webMethods API Gateway 中的团队支持功能是否启用。可能的值是
- True - 启用团队支持功能。
- 假 - 禁用团队支持功能。这是缺省值。
esScrollTimeout

以毫秒为单位，指定每个请求的搜索结果必须在 Elasticsearch 中保持活动的时间。当 allowExceedMaxWindowSize 设置启用后， Elasticsearch 的滚动功能将被启用，从而允许 Elasticsearch 接受多个搜索请求并返回多个结果。也就是说，您可以使用相同的查询执行多个搜索请求，直到从 Elasticsearch 获取所需的记录数。发送搜索请求时， Elasticsearch 会返回搜索结果，并在设置中指定的时间内保持搜索结果处于活动状态。 esScrollTimeout 设置中指定的时间内保持结果有效。如果一个请求超过了在 esScrollTimeout 设置中指定的时间，则随后的搜索请求也会失败，并显示 "无效滚动标识 "错误信息。有关滚动功能的更多信息，请参阅 https://www.elastic.co/guide/en/elasticsearch/reference/current/search-request-body.html#request-body-search-scroll。

eventsRefreshInterval

以秒为单位指定事件索引的默认刷新间隔。缺省值是 10 秒。

exportImportUserPassword
控制导出或导入用户资产的用户密码。为了安全起见，默认值设置为 false。可能的值为：
- false.确保导出的用户存档不包含散列密码，导入操作在导入过程中忽略密码。导入现有用户时，密码不会被覆盖。导入新用户时，会创建一个随机密码。此外，新导入用户的登录会被停用。如有需要，可由管理员用户激活登录。
- true.导出的用户存档包含散列密码，可使用导入操作将其导入。
forwardInternalAPIsRequest
如果通过在 DMZ 使用高级版许可证来实现配对网关部署方案，则必须使用此参数。指定传入的请求是否转发给部署在绿色区域的内部 API。可能的值如下
- 为真 webMethods API Gateway 将接收到的请求转发给部署在绿色区域的内部 API
- 假 webMethods API Gateway 不转发接收到的请求。这是缺省值。
以下是必须使用此参数且其值必须设为 true 的内部 API 及其 URI：
- getOAuthToken - /pub/apigateway/oauth2/getAccessToken
- OAuth 授权 /pub/apigateway/oauth2/authorize
- getOpenIdToken - /pub/apigateway/openid/getOpenIDToken
- openIDCallbackService - /pub/apigateway/openid/openIDCallback
- getJWTToken - /pub/apigateway/jwt/getJsonWebToken
forwardQueryParams
指定 webMethods API Gateway 如果路由选择策略 URL 中没有 $ {sys:resource_path} 变量，则必须将客户端发送的查询参数和在请求处理阶段配置的查询参数转发给本地服务。
- 确实如此。 webMethods API Gateway 将客户端发送的查询参数和在请求处理阶段配置的查询参数转发给本地服务，即使路由策略 URL 中没有 $ {sys:resource_path}。
- 假的 webMethods API Gateway 如果路由策略中没有 $ {sys:resource_path} ，则不会将查询参数转发给本地服务。这是缺省值。
gatewayClientInvokingToken

中调用后端应用程序接口的客户端令牌值。 webMethods API Gateway. 默认值为 apigateway。

healthCheckClientHostnameVerifierEnabled
指定在健康检查调用中是否启用或禁用主机名校验器。 API Gateway 监控连接组件（如 Kibana 或配置的目的地）的健康状况。可能的值是
- True - 启用主机名校验器。
- False - 禁用主机名校验器。这是缺省值。
maxAllowedZipFileSize

指定可上传的压缩文件的最大大小，以便从 " 创建 API "屏幕创建 API。默认值为 100000000。

maxRegexLengthInSearchQuery

指定 Regex 表达式查询中可使用的 Regex 参数的最大长度。默认值为 37000。该值可根据需要增加。

maxWindowSize

指定 Elasticsearch 对单个搜索请求可返回的最大搜索结果数量。使用 index.max_result_windowElasticsearch 属性，可以配置在单个 Elasticsearch 请求中检索记录的最大数量。如需了解有关该物业的更多信息，请参阅 https://www.elastic.co/guide/en/elasticsearch/reference/current/index-modules.html。默认值为 10000。如果在 index.max_result_windowElasticsearch 设置中配置的值与默认值不同，则建议在此字段中提供相同的值。如果值大于配置值， Elasticsearch 会显示错误信息。此外，如果要检索的结果总数超过此处指定的值，则必须启用 allowExceedMaxWindowSize 设置，如果要检索的结果总数超过此处指定的值。例如，如果在此设置中指定了 1000，而要检索的记录总数为 20000，则 webMethods API Gateway 就会发送 20 个请求来检索所有记录，前提是 allowExceedMaxWindowSize 设置已启用。在上例中，如果 allowExceedMaxWindowSize 设置未启用，则会显示错误信息，因为该值小于默认值。

numberOfTokensToCacheLocally
指定在访问群集获取更多令牌以满足下一组请求之前本地缓存的令牌数量。当节点收到请求时，本地缓存的令牌会为请求提供服务。本地缓存令牌可避免每次调用都访问集群。指定一个大于 0 的值，以便本地缓存。如果不指定此值，节点每次调用都必须访问群集以获取令牌。 webMethods API Gateway 会从集群中获取一组新的标记，如果
- 使用所有缓存的令牌。
- 代币的有效期已过。
缺省值为 0。
openAPIImporterValidation
指定是否 webMethods API Gateway 是否在创建新 API 时验证 OpenAPI 文件是否有语法错误。可能的值 -
- 确实如此。 webMethods API Gateway 在创建 API 时验证 OpenAPI 文件。如果检测到语法错误，则不会创建 API，并在 webMethods API Gateway 用户界面中显示错误信息。
- 假的 webMethods API Gateway 不会验证 OpenAPI 文件的语法错误。如果出现语法错误，仍会创建 API。这是缺省值。
paginationPossibleValues

指定分页大小（即每页列出的条目数）的可能值列表。分页选项显示的默认值为 10、20、30、40、50。例如，如果选择 20，则每页显示 20 个项目。例如，如果将数值改为 5、10、15、20、25，则显示的分页选项为 5、10、15、20 和 25。因此，现在当您选择 15 时，每页显示的项目将是 15 个。修改值时，您必须注销并重新登录，更改才会反映出来。

pg_Dataspace_GossipInterval

指定每个节点必须相互闲聊的频率。默认情况下，该值设置为 3 秒。

pg_Dataspace_TimeToFail

指定两个连续流言之间的最大允许间隔时间。默认情况下，该值设置为 30 秒。

pg_Dataspace_WarmupTime

指定服务器启动或关闭后允许的最大重洗间隔。默认情况下，该值设置为 300 秒。

pg_JWT_isHTTPS
指定 JSON Web 标记 (JWT) 是否通过传输协议授权。可能的值是
- True - 设置传输协议 HTTPS。该值为默认设置。
- False - 设置传输协议 HTTP。
pg_oauth2_createDefaultScopes
指定是否创建默认作用域。可能的值是
- True - 如果将此属性设置为 true，并且本地授权服务器被配置为默认授权服务器，则 webMethods API Gateway 在创建 API 时自动在集成服务器中创建作用域 webMethods API Gateway 在本地授权服务器中的 OAuth 作用域和 API 之间创建作用域映射。该设置适用于从 Centrasite 发布服务的情况。
- False - 将此属性设置为 false 时、 webMethods API Gateway 不会自动创建作用域。用户必须为 Centrasite 发布的服务手动创建和映射作用域。这是缺省值。
pg_oauth2_isHTTPS
指定 OAuth 2.0 访问令牌授权所使用的传输协议。可能的值是
- 确实如此。设置传输协议 HTTPS。这是默认设置。
- 假的设置传输协议 HTTP。
pg_OpenID_isHTTPS
指定 OpenID (ID) 令牌的授权传输协议。可能的值是
- 确实如此。设置传输协议 HTTPS。这是默认设置。
- 假的设置传输协议 HTTP。
pg_xslt_disableDoctypeDeclarations

禁用 xslt doc 类型声明。缺省值为 true。

pg_xslt_enableDOM

提供 true 值可启用 DOM 解析。值 false 会禁用 DOM 解析，并启用其他解析器

pg_xslt_enableSecureProcessing

提供 false 值表示默认情况下禁用扩展名。缺省值为 true。

pg.cs.snmpTarget.connTimeout

指定关闭与 SNMP 目标服务器的非活动连接前的毫秒数。如果设置为 0，套接字将无限期地保持打开状态。

pg.cs.snmpTarget.maxRequestSize

指定 SNMP 陷阱的最大大小（字节）。默认值为 10485760。

pg.cs.snmpTarget.重试

指定失败后重新发送 SNMP 陷阱的次数。缺省值为 1。该参数与 pg.cs.snmpTarget.sendTimeOut 来确定向发生故障的 SNMP 服务器重新发送 SNMP 陷阱的延迟（即重试 sendTimeOut ). 这意味着，如果重试参数设置为 3，而 sendTimeOut 参数设置为 500 毫秒，则发送警报的线程会延迟 1.5-second 才能发送另一个事件。故障的事件目的地可能会延迟报告事件所需的时间。 webMethods API Gateway 报告事件的时间，或者在队列达到最大值时导致事件被丢弃。

pg.cs.snmpTarget.sendTimeOut

指定 SNMP 陷阱因服务器目标未响应而超时前的等待时间（毫秒）。该值用于调度一个计时器，在过期时重新发送尚未完成的 SNMP 事件。设置超时值，确保在规定时间内向 SNMP 服务器发送陷阱。该参数不会终止正在进行的事件。发送大有效载荷的陷阱时，将此参数设置得比默认值高。默认值为 500。该参数与 pg.cs.snmpTarget.retries 配合使用，可确定向出现故障的 SNMP 服务器重新发送 SNMP 陷阱的延迟（即重试 sendTimeOut ). 这意味着，如果重试参数设置为 3，而 sendTimeOut 参数设置为 500 毫秒，则发送警报的线程会延迟 1.5-second 才能发送另一个事件。故障的事件目的地可能会延迟报告事件所需的时间。 webMethods API Gateway 报告事件的时间，或者在队列达到最大值时导致事件被丢弃。

pg.default.enable.oldVersion
在未指定 API 的版本时，指定是否必须启用 API 的最旧版本。例如，当您有一个版本化的 API 时，客户端可以在 URL 中指定版本号，以调用该特定版本的 API，即 API-NAME/版本号。如果客户端未指定版本号、 webMethods API Gateway 默认启动最新版本的 API。您可以使用此参数来更改此行为，即 webMethods API Gateway 默认使用最老版本的 API 并启动它。可用值为
- True - 将此参数设置为 "true "时，如果调用 API 而未指定版本号，则 webMethods API Gateway 默认使用指定 API 的最旧版本并启动它。
- False - 这是默认值。如果将此参数设置为 false，并在未指定版本号的情况下启动 API，则 webMethods API Gateway 默认启动指定 API 的最新版本。
pg.endpoint.connectionTimeout
指定 HTTP 连接尝试超时的时间间隔（秒）。缺省值为 30 秒。这是一个全局属性，适用于所有 API 的端点。如果您希望单独指定 API 端点的连接超时，可在 API 的路由协议处理步骤中设置 HTTP 连接超时参数，该参数可能优先于 pg.endpoint.connectionTimeout. 连接超时配置的优先级如下 - - - 连接超时配置的优先级如下
1. 如果在路由端点别名中为 " 连接超时值 "字段指定了一个值，那么在端点别名部分指定的 " 连接超时值 "优先于在 API 级别和全局级别定义的超时值。
2. 如果您在路由端点别名中为 “连接超时” 字段指定值 0，则 webMethods API Gateway 将使用 API 的路由协议处理步骤中 “连接超时” 字段中指定的值。在 API 级别指定的读取超时值优先于全局配置。
3. 如果在 API 层为路由协议处理步骤中的 " 连接超时 "字段指定值 0 或未指定值，或在别名层指定值 0，则 API Gateway 会使用此属性中指定的值。 pg.endpoint.connectionTimeout 属性中指定的值。
4. 如果没有为 pg.endpoint.connectionTimeout 指定任何值，则会使用默认值 30 秒。 webMethods API Gateway 则使用默认值 30 秒。
pg.endpoint.readTimeout
指定套接字读取尝试超时的时间间隔（秒）。默认值 - 30 秒。这是一个全局属性，适用于所有 API。如果您希望单独指定 API 的读取超时，可在 API 的路由协议处理步骤中设置读取超时字段，该字段可能优先于 pg.endpoint.readTimeout. 读取超时配置的优先级如下：
1. 如果在路由端点别名中为 " 读取超时值 "字段指定了一个值，那么在端点别名部分指定的 " 读取超时值 "优先于在 API 级别和全局级别定义的超时值。
2. 如果您在路由端点别名中为读取超时字段指定值 0，则 webMethods API Gateway 将使用 API 的路由协议处理步骤中读取超时字段中指定的值。在 API 级别指定的读取超时值优先于全局配置。
3. 如果在 API 层面的路由协议处理步骤中为 " 读取超时 "字段指定了 0 值或未指定值，或者在别名层面指定了 0 值，则会使用此值中指定的值。 webMethods API Gateway 就会使用在此 pg.endpoint.readTimeout 属性中指定的值。
4. 如果没有为 pg.endpoint.readTimeout 指定任何值，则会使用默认值 30 秒。 webMethods API Gateway 则使用默认值 30 秒。
pg.lb.failoverOnDowntimeErrorOnly
指定 webMethods API Gateway 在负载平衡路由场景中的端点行为。可能的值是
- True - 当响应中遇到的服务故障是停机错误时，负载平衡不会发生。这是缺省值。
  例如，以下是一些宕机异常情况和发生故障的原因： ConnectException, MalformedURLException, NoRouteToHostException, ProtocolException, SocketTimeoutException, UnknownHostException, UnknownServiceException, 网络服务不可用，找不到服务。
- 假 - 只要端点 1 的响应出现服务故障，负载平衡就会发生，并立即尝试下一个配置的端点。 webMethods API Gateway 就会立即尝试下一个已配置的端点。端点响应中的故障类型没有区别。
pg.MTOMStreaming.cachedFiles.delete.interval

指定删除缓存 MTOM 文件的时间间隔（秒）。默认值为 3600 秒。只有当 pg.suppress.IS.lcm 设置为 true 时才生效。

pg.overwrite.users.withsameloginid
指定 webMethods API Gateway 在将用户或团队从一个阶段导入或推广到另一个阶段时，是否必须根据用户的登录 ID 或 UUID 验证和覆盖用户，前提是两个实例的登录凭证（登录 ID）相同。可能的值是
- 正确 webMethods API Gateway 在导入或推广用户或团队时，如果用户与 UUID 不匹配，则验证并用用户的登录 ID 覆盖用户。缺省值为 true。
- 假 webMethods API Gateway 验证并用 UUID 覆盖用户。
pg.removeSSNID
指定是否在响应头中包含 set-cookie 头信息。 set-cookie 头包含从本地服务发送的 ssnid 值。可能的值是
- True - 启动 webMethods API Gateway API 的客户端不会收到包含 ssnid 值的 set-cookie 头信息。
- 假 - 启动 webMethods API Gateway 如果本地服务在响应中发送了包含 ssnid 值的 set-cookie 头信息，则启动应用程序接口的客户端会收到该头信息。
pg.security.honourPortAccessModeSettings
指定是否必须在 HTTP 和 HTTPS 端口上执行在 " 管理工具">"安全"> "端口 "部分中配置的访问模式设置。除了默认端口外，您还可以在 webMethods API Gateway 中添加端口，以便使用 API。您可以配置端口的访问模式，以确定端口是否可用于访问 API。您可以允许或拒绝通过端口访问所有 API。默认情况下允许使用端口访问 API 时，可以指定必须拒绝通过端口访问的 API 列表。此外，如果拒绝使用端口访问 API，则可以指定允许使用端口访问的 API 列表。您可以使用 pg.security.honourPortAccessModeSettings 设置来配置从端口部分配置的访问模式是否必须在 HTTP 和 HTTPS 端口上执行。此配置仅适用于 REST 和 OData API。可能的值是
- True - 根据 " 管理工具">"安全"> "端口 "部分的设置，允许或拒绝访问 HTTP 和 HTTPS 端口。
- False - 不应用为端口指定的访问模式设置。这是缺省值。
pg.snmp.communityTarget.base64Encoded

指定是否使用第三方 SNMPv1 基于社区的连接。如果设置为 true，社区名称必须是 Base64 值。缺省值为 false。

pg.snmp.communityTarget.maxRequestSize

指定 SNMP 陷阱的最大大小（字节）。缺省值为 65535。

pg.snmp.communityTarget.重试

指定失败后重新发送 SNMP 陷阱的次数。缺省值为 1。该参数与 pg.snmp.communityTarget.sendTimeOut 来确定向发生故障的 SNMP 服务器重新发送 SNMP 陷阱的延迟（即重试 sendTimeOut ). 这意味着，如果重试参数设置为 3，而 sendTimeOut 参数设置为 500 毫秒，则在发送线程警报之前会有 1.5-second 的延迟，然后才能发送另一个事件。故障的事件目的地可能会延迟报告事件所需的时间。 webMethods API Gateway 报告事件的时间，或者在队列达到最大值时导致事件被丢弃。

pg.snmp.communityTarget.sendTimeOut

指定 SNMP 陷阱因服务器目标未响应而超时前的等待时间（毫秒）。该值用于调度一个计时器，在过期时重新发送尚未完成的 SNMP 事件。设置超时值，确保在规定时间内向 SNMP 服务器发送陷阱。该参数不会取消正在进行的事件。发送大有效载荷的陷阱时，将此参数设置为高于默认值。默认值为 500。该参数与 pg.snmp.communityTarget.retries 配合使用，可确定向无响应的 SNMP 服务器重新发送 SNMP 陷阱的延迟（即重试 sendTimeOut ). 这意味着，如果重试参数设置为 3，而 sendTimeOut 参数设置为 500 毫秒，则发送警报的线程会延迟 1.5-second 才能发送另一个事件。故障的事件目的地可能会延迟报告事件所需的时间。 webMethods API Gateway 报告事件的时间，或者在队列达到最大值时导致事件被丢弃。

pg.snmp.customTarget.connTimeout

指定关闭与第三方 SNMP 服务器的禁用连接前的毫秒数。如果设置为 0，套接字将无限期地保持打开状态。

pg.snmp.userTarget.maxRequestSize

指定 SNMP 陷阱的最大大小（字节）。缺省值为 65535。

pg.snmp.userTarget.重试

指定失败后重新发送 SNMP 陷阱的次数。缺省值为 1。该参数与 pg.snmp.userTarget.sendTimeOut 来确定向发生故障的 SNMP 服务器重新发送 SNMP 陷阱的延迟（即重试 sendTimeOut ). 这意味着，如果重试参数设置为 3，而 sendTimeOut 参数设置为 500 毫秒，则发送警报的线程会延迟 1.5-second 才能发送另一个事件。故障的事件目的地可能会延迟报告事件所需的时间。 webMethods API Gateway 报告事件的时间，或者在队列达到最大值时导致事件被丢弃。

pg.snmp.userTarget.sendTimeOut

指定 SNMP 陷阱因服务器目标未响应而超时前的等待时间（毫秒）。该值用于调度一个计时器，在过期时重新发送尚未完成的 SNMP 事件。设置超时值，确保在规定时间内向 SNMP 服务器发送陷阱。该参数不会取消正在进行的事件。发送大有效载荷的陷阱时，将此参数设置为高于默认值。默认值为 500。该参数与 pg.snmp.userTarget.retries 配合使用，可确定向出现故障的 SNMP 服务器重新发送 SNMP 陷阱的延迟（即重试 sendTimeOut ). 这意味着，如果重试参数设置为 3，而 sendTimeOut 参数设置为 500 毫秒，则发送警报的线程会延迟 1.5-second 才能发送另一个事件。故障的事件目的地可能会延迟报告事件所需的时间。 webMethods API Gateway 报告事件的时间，或者在队列达到最大值时导致事件被丢弃。

pg.soapToRest.typeConvertorEnabled
指定 SOAP API 转换为 REST API 时，是否必须将 SOAP 请求中的键值转换为其原始类型。例如，如果 XML 为 <number>10</number> ，则转换为 "数字"： 10. 可能的值是
- True - 将值转换为原始类型。这是缺省值。
- False - 数值不会转换为原始类型。
pg.suppress.IS.lcm
指定是否用 webMethods API Gateway 生命周期管理器。可能的值是
- True - 将此属性设置为 true，以使用 webMethods API Gateway 生命周期管理器。
- False - 将此属性设为 false，以使用 IS 生命周期管理器。
webMethods API Gateway 生命周期管理器提供了使用 pg.MTOMStreaming.cachedFiles. delete.interval 设置指定删除缓存 MTOM 文件的间隔的选项。
pgmen.quotaSurvival.addLostIntervals

指定是否必须添加已恢复配额中丢失的间隔。

pgmen.quotaSurvival.间隔

指定配额存活处理器任务运行前的秒数。

promotionListSortByTime
指定促销管理页面 "促销 "选项卡中的促销列表是否按促销时间排序。可能的值 -
- True - 促销信息列表按促销时间排序，最新的排在最前面。
- 假 - 升职列表按升职名称排序。这是缺省值。
retainResponseStatus

指定是否必须先修改本地服务状态才能将其发送给客户端。默认值为 false，表示如果出站身份验证-自定义凭据或委托传入凭据配置的凭据不正确，本机服务状态会在发送到客户端之前更改。如果该值设为 true，则指定发送从本地服务接收的状态时不对其进行修改。

return408ForConnectionTimeout
指定本机服务请求超时时响应中包含的状态代码。可能的值是
- True - 向本地服务发出的请求超时时，响应将统一包含 408 错误代码。这是缺省值。
- 假 - 响应不包含 408 错误代码。
saveAuditlogsWithPayload
指定审计日志是否必须与有效载荷一起保存。可能的值是
- True - 审计日志必须与有效负载一起保存。这是缺省值。
- 假 - 审计日志不会与有效负载一起保存。
sendClientRequestURI
指定是否必须先对请求中的 URI 进行解码，然后再将其发送给本地服务。可能的值
- True - URI 不被解码。对请求中的 Unicode 字符进行编码。
- False - URI 已解码，不会更改 URL 的路径。这是缺省值。
startDayOfTheWeek

指定一周的起始日，作为发送警报前监控性能所配置的警报间隔的度量单位。默认情况下，一周的起始日设置为星期一。
注意：如果修改了该值，必须重新启动 webMethods API Gateway 才能生效。请联系 IBM 支持团队，重新启动 API Gateway 服务器。

setDefaultContentType
如果请求中缺少内容类型，则指定 GET 和 DELETE 方法中应包含的默认内容类型。可能的值是
- True - 默认内容类型
  application/x-www-form-urlencoded
  如果请求中缺少内容类型，则会添加这是缺省值。
- False - 不添加默认内容类型。内容类型按原样发送。
strictResourceMatching
指定是否 webMethods API Gateway 是否必须将运行时调用的资源路径与 API 的资源路径定义进行严格匹配。可能的值是
- true - true webMethods API Gateway 使用严格的资源匹配标准，如果遇到指定字符以外的其他字符，则匹配失败。这是缺省值。
- 假 webMethods API Gateway 匹配最佳资源，而不是使用严格的资源匹配标准。
该扩展设置的功能如下--例如，考虑一个资源路径为 /mypath 的 REST API，请求 http://host:port/servicename/mypath/anytext ， strictResourceMatching=true ，会立即返回 HTTP 响应 404。 http://host:port/servicename/mypath/anytext 与 strictResourceMatching=false 的请求以普通方式运行。
tagsTypeAheadSearchResultSize

指定超前类型搜索时要显示的现有标记数量。该属性在您向 API 添加标签时可用，您可以在其中键入搜索词。现有 API 标记列表似乎取决于搜索词。该列表中显示的 API 标记数量受限于在 tagsTypeAheadSearchResultSize 属性中提供的值进行限制。缺省值是 10。您可以提供的最小值是 1。如果您提供的值为零或无效，该属性的值将设为默认值 10。

transferEncodingChunked_handleAsStream
指定当请求包含 Transfer-Encoding: chunked 标头时，是否必须将请求有效载荷作为流处理。缺省值为 false。根据为该设置提供的值，行为如下
- 如果在请求中发送了传输-编码-分块头，且扩展设置 transferEncodingChunked_handleAsStream 设置为 "true"，则请求有效载荷将作为流处理。
- 如果请求中发送了 Transfer-Encoding - chunked 标头，且扩展设置 transferEncodingChunked_handleAsStream 设为 false，则必须按原样处理请求有效载荷（不进行流处理）。
- 如果请求中未发送传输-编码-分块标头。请求有效载荷按原样处理（不分流）。
- 如果请求中未发送 Transfer-Encoding-chunked 标头，且扩展设置 transferEncodingChunked_handleAsStream 设为 true，则请求有效载荷将按原样处理（不进行流处理）。
transformerPoolSize

指定包含 XSLT 转换器的转换池的最大大小。为减少对性能的影响，可以重复使用池中的转换器，而不是为每个请求创建转换器。

useTypeInIndexNameForESDestination

指定将数据从 webMethods API Gateway 向已配置的 Elasticsearch 目的地发送数据时使用的索引格式。缺省值为 true。 Elasticsearch verison 7.2 支持为每种事件类型提供专用索引的数据。所以 webMethods API Gateway 如果该属性的值设置为 true，就会针对不同的事件类型在不同的索引中发送数据。事件类型与 Elasticsearch 目的地索引名称相连。也就是说，索引名称的格式如下：{IndexName}_ {EventType}。例如，database_transactionalevents；其中 default 是索引名称，transactional events 是事件类型。如果值设置为 false，则类型名称不会与索引名称连接。在这种情况下，当数据发送到配置的 Elasticsearch 目的地时，为每个事件创建的索引会在主索引下建立子索引。如果目标 Elasticsearch 的版本是 5.x 或更早，则此设置的值必须设为 false。

xmlToJSONConversion_keepString
指定将 XML 转换为 JSON 后，响应有效负载中字段的数据类型必须是字符串还是相应的数据类型。缺省值为 true。可能的值是
- True - 字段的数据类型保留为字符串。
- False - 字段的数据类型更改为相应的数据类型。
例如，XML 有效载荷示例：<?xml version="1.0" encoding="UTF-8"?><EmployeeDetail><ID>12345</ID><Name>John</Name><Address>999 ABC Street</Address></EmployeeDetail>

如果将扩展设置设为 true ，响应示例：{"EmployeeDetail": {"ID": "12345","Name": "John","Address": "999 ABC Street"}}. 响应有效载荷中的所有字段均保留为字符串。

如果将扩展设置设为 false ，响应示例：{"EmployeeDetail": {"ID": 12345,"Name": "John","Address": "999 ABC Street"}}。字段 ID 的数据类型为整数。
您可以在瓦特键部分提供必要的值来配置瓦特参数。配置的瓦特键列在页面顶部扩展键下方的瓦特设置下。在群集设置中，只有下列瓦特参数会在各节点间同步：
- watt.security.ssl.client.ignoreEmptyAuthoritiesList.
- watt.security.ssl.ignoreExpiredChains.
- watt.server.url.alias.partialMatching.
- watt.server.oauth.authServer.别名
- watt.server.oauth.requireHTTPS
- watt.net.http401.throwException
- watt.net.http501-599.throwException
- watt.server.SOAP.MTOMStreaming.enable
- watt.server.http.Strict-Transport-Security
- watt.server.rest.removeInputVariablesFromResponse
- watt.server.coder.responseAsXML
- watt.security.ssl.cacheClientSessions
- watt.server.enterprisegateway.ignoreXForwardedForHeader
如果在一个实例中修改其他瓦特参数 webMethods API Gateway 参数，它们不会在群集设置中的其他节点上同步。在其他实例中手动修改它们。
单击保存。