NetWorker REST API：HTTP GET 请求间歇性超时

Summary: NetWorker 表述性状态传输 （REST） 应用程序编程接口 （API） 用于从环境中的 NetWorker 服务器请求信息 （HTTP GET）。REST API 查询间歇性超时，并且由于套接字超时，restapi.log显示内部服务器错误消息。

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.
Check out other resources

Symptoms

NetWorker 表述性状态传输 （REST） 应用程序编程接口 （API） 用于从环境中的 NetWorker 服务器请求信息 （HTTP GET）。REST API 查询间歇性超时，并且由于套接字超时，restapi.log显示内部服务器错误消息。   
YYYY-MM-DD HH:MM:SS INFO [https-jsse-nio-9090-exec-26] c.e.n.w.WebApiResponse - Response status Method: 'GET', URI:'v3/global/backups', Status '200'
YYYY-MM-DD HH:MM:SS INFO [https-jsse-nio-9090-exec-26] c.e.n.w.WebApiResponse - Response status Method: 'GET', URI:'v3/global/backups', Status '500'
...
YYYY-MM-DD HH:MM:SS ERROR [https-jsse-nio-9090-exec-11] c.e.n.w.WebApiExceptionMapper - Status 'Internal Server Error', msg: java.io.IOException: Broken pipe
org.apache.catalina.connector.ClientAbortException: java.io.IOException: Broken pipe
	at org.apache.catalina.connector.OutputBuffer.realWriteBytes(OutputBuffer.java:333) ~[catalina.jar:9.0.10]

NetWorker 服务器 REST API 的 curl 命令显示：  

[root@NetworkerServer]# curl -X GET -H "Content-Type: application/json" "https://mynsr.mydomain.com:9090/nwrestapi/v3/global/backups" -u "administrator" -k -1
Enter host password for user 'administrator':
curl: (28) Operation timed out after 300406 milliseconds with 0 out of 0 bytes received

Cause

REST API 调用”v3/global/backups“和 "v3/global/jobs“本身是资源密集型查询，在较大环境中可能会导致请求超时。  

NetWorker REST API 服务托管在 Java 虚拟机 （JVM） 上运行的 Apache Tomcat Java servlet 容器上。REST API 使用 JVM 内存处理每个请求，并且已经表明，在资源密集型查询后，并非所有内存都会被释放。JVM 内存利用率的提高最终可能导致其他资源密集程度较低的 REST API 请求超时。  

Resolution

避免使用资源密集型请求从 NetWorker 服务器检索信息。例如，”v3/global/backups“或”v3/global/clients/CLIENT_NUMBER/backups可以使用具有定义时间范围的“，而不是使用全局”v3/global/backups“以检索所有备份。

例如，将 saveTime 的结果限制在任何指定时间范围之间。过去 24 小时内完成的作业查询示例：
 

../global/backups 示例：

https://NETWORKER_SERVER_ADDRESS:9090/nwrestapi/v3/global/backups?q=saveTime:["START" TO "END"]
https://nsr.amer.lan:9090/nwrestapi/v3/global/backups?q=saveTime:["2024-07-24T00:00:01" TO "2024-07-24T23:59:59"]

。
./global/clients/client_resourceId_number/backups

https://NETWORKER_SERVER_ADDRESS:9090/nwrestapi/v3/global/clients/client_resourceID_number/backups?q=saveTime:["START" TO "END"]

https://nsr.amer.lan:9090/nwrestapi/v3/global/clients/87.0.90.20.0.0.0.0.196.80.99.102.192.168.9.150/backups?q=saveTime:["2024-07-24T00:00:01" TO "2024-07-24T23:59:59"]


../global/jobs:

https://NETWORKER_SERVER_ADDRESS:9090/nwrestapi/v3/global/jobs?q=endTime:["START" TO "END"]

https://nsr.amer.lan:9090/nwrestapi/v3/global/jobs?q=endTime:["2024-07-29T00:00:01" TO "2024-07-29T23:59:59"]

 

提醒：相应地修改 START 和 END 时间中的 YYYY-MM-DDTHH：mm：SS。这些示例仅用于演示目的。可能需要额外的 REST API 查询规范或过滤器函数才能返回所需的数据。REST API 文档中提供了更多信息和示例：https://developer.dell.com/apis/2378/versions/v3/docs/GettingStarted.md

如果资源密集程度较低的 REST API 请求超时，可以重新启动 NetWorker 服务器服务以释放现有的 JVM 内存使用量。

Additional Information

代码修复进入 NetWorker 19.4，以改善 NetWorker/REST API 请求的 JVM 使用率;但是，自 2023 年 11 月 30 日起，NetWorker 终止支持。如果 NetWorker 服务器为 19.4 或更低版本，请将 NetWorker 服务器升级到受支持的版本。

Products

NetWorker
Article Properties
Article Number: 000172472
Article Type: Solution
Last Modified: 07 Nov 2025
Version:  8
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.