利用 REST 呼叫,與群體成員或已登錄主機之間來回傳送檔案

您可以呼叫 REST API,來執行從群體控制器傳給群體中的群體成員或已登錄主機的遞送式檔案傳送作業。這些作業包括從遠端位置下載檔案、將檔案上傳至遠端位置,以及刪除遠端位置中的檔案。請使用 GETPOSTDELETE REST API。檔案傳送作業是在「IBM JMX REST 連接器」內進行。

開始之前

如果要執行從群體控制器傳給成員伺服器的檔案傳送作業,必須將伺服器加入為群體成員。請參閱配置 Liberty 群體

如果要執行檔案傳送作業,以傳給主機,該主機必須已向群體控制器登錄。請參閱 向 Liberty 群體登錄主機

程序

  1. 選擇性的: 若要閱讀 REST API,請將瀏覽器指向 https://controller_host_name:controller_port_name/IBMJMXConnectorREST/api,並輸入控制器管理使用者 ID 和密碼,以便登入。控制器必須正在執行,才能檢視 REST API 說明文件。或者,您可以使用群體成員的主機、埠、登入使用者 ID 和密碼,來檢視 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(含有使用者目錄 C:/server/wlp),下載 myFile.txt 檔:
  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(含有使用者目錄 C:/server/wlp),下載 server.xml 檔:
  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 呼叫的狀態


指示主題類型的圖示 作業主題

檔名:twlp_collective_file_transfer_member_host.html