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

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

Dieser Artikel gilt für Dieser Artikel gilt nicht für Dieser Artikel ist nicht an ein bestimmtes Produkt gebunden. In diesem Artikel werden nicht alle Produktversionen aufgeführt.
Andere Ressourcen ansehen

Symptome

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

Ursache

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

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

Lösung

避免使用资源密集型请求从 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 内存使用量。

Weitere Informationen

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

Produkte

NetWorker
Artikeleigenschaften
Artikelnummer: 000172472
Artikeltyp: Solution
Zuletzt geändert: 07 Nov. 2025
Version:  8
Antworten auf Ihre Fragen erhalten Sie von anderen Dell NutzerInnen
Support Services
Prüfen Sie, ob Ihr Gerät durch Support Services abgedeckt ist.