Veritas NetBackup™ WebSocket 服务 (NBWSS) 参考指南

Last Published:
Product(s): NetBackup & Alta Data Protection (8.1.1)

通过 NBWSS 执行 API 调用

NetBackup WebSocket Service (NBWSS) 允许基于云的应用程序通过安全连接执行对 NetBackup 的 REST API 调用。云应用程序使用 JavaScript 对象表示法 (JSON) 向 NBWSS 发送消息。JSON 消息包含云应用程序要执行的 REST API 调用。然后,NBWSS 代表云应用程序执行 API 调用,并将响应发送回应用程序。

下面是执行 NetBackup REST API 调用的请求示例:

{ 
      "version": "1.0",
      "id": "9CD2B69F-0BBF-3F60-974D-C1F2EF37B872",
      "type": "COMMAND",
      "subType": "REQUEST",
      "timeStamp": 1444806222,
      "payload": {
            "uri": "/netbackup/config/servers/vmservers/vCenter1.domain
                    .com",
            "method": "GET",
            "headers": {
                  "Content-Type": "application/vnd.netbackup+json;version=1.0"
            }
      }
}

请注意以下几点:

  • 要执行 API 调用,"type" 字段必须为 "COMMAND""subType" 字段必须为 "REQUEST"

  • "payload" 字段取决于要调用的 API 的类型。

    • 在此示例中,"uri" 字段包含 REST API 调用的 URI。NBWSS 可确保完整 REST 请求中正确包括主机名和端口。

    • "method" 字段指示要执行的 API 调用的类型。在此示例中为 "GET"(获取 vCenter1 相关信息的请求)。

    • "headers" 字段包含 API 调用附带的任何 HTTP 标头。在此示例中,"Content-Type" 设置为 "application/vnd.netbackup+json;version=1.0",以指示请求以 JSON 格式发送。

    • "Content-Type" 的格式如下:

      “Content-Type”: “application/vnd.netbackup+media;version=<major>.<minor>”

      注意:

      "Content-Type" 中的版本号 (version=<major>. <minor>) 可能会在未来版本中更改,具体取决于是主要更改还是次要更改。