在集合体成员或已注册主机中使用 REST 调用传输文件

通过调用 REST API,可执行从集合体控制器至集合体成员或集合体的已注册主机的路由文件传输操作。这些操作包括从远程位置下载文件、将文件上载至远程位置及在远程位置删除文件。使用 GETPOSTDELETE REST API。文件传输操作在 IBM JMX REST 连接器中进行。

开始之前

要执行从集合体控制器至成员服务器的文件传输操作,该服务器必须作为成员加入集合体。请参阅配置 Liberty 集合体

要对主机执行文件传输操作,该主机必须已向集合体控制器注册。请参阅向 Liberty 集合体注册主机

过程

  1. 可选: 要阅读有关 REST API 的信息,请使用浏览器访问 https://controller_host_name:controller_port_name/IBMJMXConnectorREST/api 并输入控制器管理用户标识和密码以登录。控制器必须正在运行才能查看 REST API 文档。或者,您可使用集合体成员主机、端口、登录用户标识和密码来查看 REST API 文档。

    文件传输路由部分描述用于在集合体控制器与成员服务器或已注册主机间传输文件的 API。

    collectiveController-1.0collectiveMember-1.0 功能部件启用 restConnector-1.0 功能部件,后者提供文件传输功能。因此,集合体控制器和成员不必在功能部件管理器中指定 restConnector-1.0 来查看 REST API 或执行文件传输操作。独立服务器配置可能需要 restConnector-1.0 功能部件来查看 REST API。

  2. 除非您直接使用 Liberty 实例,否则应将路由上下文设置为 HTTP 头。
    • 成员服务器路由
      com.ibm.websphere.jmx.connector.rest.routing.hostName=string
      com.ibm.websphere.jmx.connector.rest.routing.serverName=string
      com.ibm.websphere.jmx.connector.rest.routing.serverUserDir=string
    • 已注册主机路由
      com.ibm.websphere.jmx.connector.rest.routing.hostName=string
  3. 确保目标文件在服务器的可配置读/写目录中(对于涉及成员服务器的文件传输操作)或主机的可配置读/写目录中(对于涉及已注册主机的文件传输操作)。
  4. 调用用于下载、上载或删除文件的 REST API。

    {filePath} 必须是 URL 编码的。对于涉及已注册主机的路由操作,{filePath} 必须为绝对路径,并且不能包含 Liberty 变量。

    • 使用 GET 操作从成员服务器或已注册主机下载一个文件。
      GET https://controller_host:controller_port/IBMJMXConnectorREST/file/{filePath}
    • 使用 POST 操作将一个文件上载至成员服务器或已注册主机。
      POST https://controller_host:controller_port/IBMJMXConnectorREST/file/{filePath}
    • 使用 DELETE 操作从成员服务器或已注册主机删除一个文件。
      DELETE https://controller_host:controller_port/IBMJMXConnectorREST/file/{filePath}
    • 使用 POST 操作从成员服务器或已注册主机删除多个文件。
      POST https://controller_host:controller_port/IBMJMXConnectorREST/file/collection

示例

要从主机 myTarget.com 上的成员服务器 myServerA 中下载 myFile.txt 文件(用户目录为 C:/server/wlp),请执行以下操作:
  1. 将成员服务器路由上下文设置为 HTTP 头。
    com.ibm.websphere.jmx.connector.rest.routing.hostName=myTarget.com
    com.ibm.websphere.jmx.connector.rest.routing.serverName=myServerA
    com.ibm.websphere.jmx.connector.rest.routing.serverUserDir=C:/server/wlp
  2. 执行 GET 调用以下载该文件。
    GET https://myTarget.com:9443//IBMJMXConnectorREST/file/C%3A%2Ftemp%2FmyFile.txt
要从已注册主机 myTarget.com 下载 myFile.txt 文件,请执行以下操作:
  1. 将已注册主机路由上下文设置为 HTTP 头。
    com.ibm.websphere.jmx.connector.rest.routing.hostName=myTarget.com
  2. 执行 GET 调用以下载该文件。
    GET https://myTarget.com:9443//IBMJMXConnectorREST/file/C%3A%2Ftemp%2FmyFile.txt
要从主机 myTarget.com 上的成员服务器 myServerA 中下载 server.xml 文件(用户目录为 C:/server/wlp),请执行以下操作:
  1. 将成员服务器路由上下文设置为 HTTP 头。
    com.ibm.websphere.jmx.connector.rest.routing.hostName=myTarget.com
    com.ibm.websphere.jmx.connector.rest.routing.serverName=myServerA
    com.ibm.websphere.jmx.connector.rest.routing.serverUserDir=C:/server/wlp
  2. 执行 GET 调用以下载 ${server.config.dir}/server.xml 文件。
    GET https://myTarget.com:9443//IBMJMXConnectorREST/file/%24{server.config.dir}%2Fserver.xml

下一步做什么

获取 REST 调用的状态或详细信息。请参阅获取针对多个已注册主机的 REST 调用的状态


用于指示主题类型的图标 任务主题



时间戳记图标 最近一次更新时间: Monday, 5 December 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-libcore-mp&topic=twlp_collective_file_transfer_member_host
文件名:twlp_collective_file_transfer_member_host.html