NetWorker REST API 分流指南

观看 YouTube 视频

使用入门

连接到 NetWorker：

• Content-Type: application/json
• 接受：application/json
• Authorization: Basic with Base 64 编码用户名和密码

在有多个 NetWorker 数据区通过单个 NetWorker AUTHC 服务器进行身份验证的环境中，需要额外的标头：

• X-NW-AUTHC-BASE-URL：AUTHC_HOSTNAME_OR_IP：AUTHC_PORT

NetWorker REST API 在以下基本 URI 中公开：

https://[nw-server-hostname]:9090/nwrestapi/

https://[nw-server-hostname]:9090/nwrestapi/v1
https://[nw-server-hostname]:9090/nwrestapi/v2
https://[nw-server-hostname]:9090/nwrestapi/v3

完整的 json 架构可在以下位置找到：

https://[nw-server-hostname]:9090/nwrestapi/v3/schemas/swagger.json

REST API 函数

一些例子：

GET

列出所有客户端。                                            

https://[nw-server-hostname]:9090/nwrestapi/v3/global/clients

仅限一个客户端，仅显示三个字段（主机名、存储集和保护组）      

https://[nw-server-hostname]:9090/nwrestapi/v3/global/clients?fl=hostname,saveSets,protectionGroups&q=hostname:nwserver121

列出一个客户端所在的保护组。     

https://[nw-server-hostname]:9090/nwrestapi/v3/global/clients?fl=protectionGroups&q=hostname:nwserver121

显示当前警报。                                     

https://[nw-server-hostname]:9090/nwrestapi/v3/global/alerts

显示最近失败的作业。                               

https://[nw-server-hostname]:9090/nwrestapi/v3/global/jobs?q=completionStatus:"Failed"&fl=clientHostname,startTime,name,message

在一个策略中列出工作流（本示例中名为 WinFS ）。                   

https://[nw-server-hostname]:9090/nwrestapi/v3/global/protectionpolicies/WinFS/workflows

仅列出一个存储集实例的属性（由客户端主机名和存储集定义）。      

https://[nw-server-hostname]:9090/nwrestapi/v3/global/clients?q=hostname:vm-lego-231 and saveSets:"/etc"

发布：

启动工作流操作。                                 

https://[nw-server-hostname]:9090/nwrestapi/v3/global/protectionpolicies/Angela/workflows/WinFS/op/backup
                                                      JSON Body: 
                                                      {
                                                       }

创建新的客户端实例（除列出的四个属性外，所有属性都具有默认值）。           

https://[nw-server-hostname]:9090/nwrestapi/v3/global/clients  
                                                     JSON Body 
                                                     {    
            "hostname": "vm-lego-231",
            "backupType": "Filesystem",
            "saveSets": [ "/etc" ],
            "protectionGroups" : [ "LinuxFS" ]
                                                          

支持所需的信息

环境：

• NetWorker 服务器名称
• NetWorker 版本和内部版本号
• NetWorker 服务器主机操作系统类型和版本

Linux：

hostname
strings /usr/sbin/nsrd | grep -i "(#)"
cat /etc/*release
uname -a

Windows：

nsrwatch

• 说明正在执行的 REST API 操作（GET、POST、PUT、DELETE）、使用的 URI、任何 JSON 正文内容（如果适用）。 
• REST API 响应代码和提供的任何错误消息。
• REST API 客户端与 NetWorker 之间的初始连接和授权是否成功？

• 从 NetWorker 服务器呈现daemon.raw日志文件：
  • Linux：/nsr/logs/daemon.raw
  • Windows：C:\Program Files\EMC NetWorker\nsr\logs\daemon.raw
  • NetWorker：如何使用nsr_render_log
• 来自 NetWorker 服务器的 REST API 日志：  /nsr/logs/restapi （linux） 或 EMC NetWorker\nsr\logs\restapi （Windows）
• 有关身份验证问题，请参阅 /nsr/authc/logs （linux） 中的标准 NetWorker 身份验证日志记录或 .\EMC NetWorker\nsr\authc-server\tomcat\logs （Windows）

top -b | awk '/nsrtomc+/ {print strftime("%Y-%m-%d-%H:%M:%S", systime()), $0}'

此输出显示标准顶部输出，但具有人类可读的时间戳。这可用于查看进程的 CPU 和内存消耗，以及在进行 REST 调用时它保持特定状态的时间。这可以与 restapi.log 和 AUTHC 日志进行比较，以查看进行了哪些调用以及频率。
 

Windows：对于 Windows 服务器，您必须安装类似于“Performance Monitor：

1.以管理员身份打开 性能监视器 。
2.从左侧窗格中，展开监视工具，然后选择性能监视器。
3.在右窗格中右键单击，然后选择删除所有计数器。
4.在右窗格中右键单击，然后选择Add Counters。
5.在 Available Counters下，展开 Memory，选择 % Commit Bytes，然后单击 Add.6
。在内存下， 选择可用字节，然后单击添加。
7.在Available Counters下，展开Process并选择% Processor Time，在Instances of Selected object下选择第一个 Java 条目，然后单击Add。
8.在可用计数器下，展开处理器信息并选择 处理器实用程序百分比，然后单击 添加。
9.右窗格中的“已添加”计数器应显示：

10.单击 Okay。右键单击性能监视器，然后单击新建数据>收集器集。
11.提供名称，例如：RESTAPI_MON。
12.在位置屏幕上，单击下一步， 除非您选择指定备用输出位置。
13.选择 保存并关闭 ，然后单击 完成。
14.在数据 收集器集 —> 用户定义的左侧窗格中，打开RESTAPI_MON属性，并为日志格式选择逗号分隔，然后单击确定。

15.在左侧窗格中的数据 收集器集 —> 用户定义下，选择RESTAPI_MON数据收集器集，然后单击开始（播放按钮）。
16.如果使用了默认输出位置，则.csv文件将显示在 C：\PerfLogs\Admin\RESTAPI_MON 下。
17.观察到问题并将其记录在输出文件中后，您可以通过单击“Data Collector 集 - 用户定义”下的“停止”来停止监视单击。

更多资源

以下位置提供了所有受支持的 REST API 端点和用法示例：NetWorkerREST API 参考指南