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"]

 

注意：據此在開始和結束時間修改 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 使用率;但 NetWorker 自 2023 年 11 月 30 日結束支援。如果 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.