REST 呼び出しによる集合メンバーまたは登録済みホストとの間のファイル転送

REST API を呼び出すことによって、集合コントローラーから集合メンバーへ、または集合の登録済みホストへ、 経路指定されたファイル転送操作を実行することができます。それらの操作には、 リモート・ロケーションからのファイルのダウンロード、リモート・ロケーションへのファイルのアップロード、 および、リモート・ロケーションにあるファイルの削除があります。GETPOST、 または DELETE REST API を使用します。これらのファイル転送操作は、IBM JMX REST Connector 内で起こります。

始める前に

集合コントローラーからメンバー・サーバーへのファイル転送操作を実行するには、そのサーバーが集合にメンバーとして参加している必要があります。 『Liberty 集合の構成』を参照してください。

ホスト・コンピューターへのファイル転送操作を実行するには、 そのホストが集合コントローラーに登録されている必要があります。『ホスト・コンピューターの Liberty 集合への登録』を参照してください。

手順

  1. オプション: REST API についての説明を読むため、ブラウザーで https://controller_host_name:controller_port_name/IBMJMXConnectorREST/api にアクセスし、 コントローラー管理ユーザー ID とパスワードを入力してログインします。 REST API 資料を表示するには、コントローラーが実行中である必要があります。あるいは、集合メンバーのホスト、ポート、ログイン・ユーザー ID とパスワードを使用して、REST API 資料を表示できます。

    「ファイル転送」セクションおよび「ルーティング」セクションに、 集合コントローラーとメンバー・サーバーまたは登録済みホストとの間のファイル転送に使用される API についての説明があります。

    collectiveController-1.0 フィーチャーおよび collectiveMember-1.0 フィーチャーは、 ファイル転送機能を提供する restConnector-1.0 フィーチャーを有効にします。したがって、集合コントローラーと集合メンバーのどちらも、 REST API を表示するため、またはファイル転送操作を実行するために、フィーチャー・マネージャーに restConnector-1.0 を指定する必要はありません。スタンドアロン・サーバー構成では、 REST API を表示するために restConnector-1.0 フィーチャーが必要な場合があります。

  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 操作を使用して、1 つのメンバー・サーバーまたは登録済みホストから 1 つのファイルをダウンロードします。
      GET https://controller_host:controller_port/IBMJMXConnectorREST/file/{filePath}
    • POST 操作を使用して、1 つのメンバー・サーバーまたは登録済みホストへ 1 つのファイルをアップロードします。
      POST https://controller_host:controller_port/IBMJMXConnectorREST/file/{filePath}
    • DELETE 操作を使用して、1 つのメンバー・サーバーまたは登録済みホストから 1 つのファイルを削除します。
      DELETE https://controller_host:controller_port/IBMJMXConnectorREST/file/{filePath}
    • POST 操作を使用して、1 つのメンバー・サーバーまたは登録済みホストから複数のファイルを削除します。
      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. ${server.config.dir}/server.xml ファイルをダウンロードするため GET 呼び出しを実行します。
    GET https://myTarget.com:9443//IBMJMXConnectorREST/file/%24{server.config.dir}%2Fserver.xml

次のタスク

REST 呼び出しの状況または詳細を取得します。『複数の登録済みホストに対する REST 呼び出しの状況の取得』を参照してください。


トピックのタイプを示すアイコン タスク・トピック

ファイル名: twlp_collective_file_transfer_member_host.html