使用單一 REST 呼叫,將檔案從多部已登錄主機刪除
您可以從群體控制器呼叫 DELETE REST API,來刪除群體中多部已登錄主機上的檔案。檔案刪除是在「IBM JMX REST 連接器」內進行。
程序
- 選擇性的: 若要閱讀 REST API,請將瀏覽器指向 https://controller_host_name:controller_port_name/IBMJMXConnectorREST/api,並輸入控制器管理使用者 ID 和密碼,以便登入。控制器必須正在執行,才能檢視 REST API 說明文件。
檔案傳送和遞送區段說明在群體控制器與成員伺服器(或已登錄主機)之間傳送檔案時,所使用的 API。
collectiveController-1.0 特性會啟用 restConnector-1.0 特性,藉以提供檔案傳送功能。因此,群體控制器不需要在特性管理程式中指定 restConnector-1.0,就能檢視 REST API 或執行檔案傳送作業。獨立式伺服器配置可能就需要 restConnector-1.0 特性,才能檢視 REST API。
- 列出群體控制器 HTTP 標頭中的目標主機。
com.ibm.websphere.collective.hostNames=comma-separated_list_of_target_hosts
選擇性地設定其他 HTTP 標頭:
- 指定是否非同步執行檔案刪除和動作。預設值為 false。若要變更預設值,請將 boolean 指定為 true。
com.ibm.websphere.jmx.connector.rest.asyncExecution=boolean
- 指定在刪除檔案之前要執行的一組動作。現有的內建動作是 com.ibm.websphere.jmx.connector.rest.preTransferAction.remove,這會移除 Liberty 目錄內的 Liberty 伺服器,以便從集合中刪除。請使用標頭來列出其他的自訂動作。如果您列出多個自訂動作,請用 URL 編碼逗點字元來區隔動作。
com.ibm.websphere.jmx.connector.rest.preTransferAction=comma-separated_list_of_actions
如果要啟用自訂動作,請在群體控制器的 server.xml 中新增下列配置:<hostAccess enableCustomActions="true" />
- 指定選項清單,以傳遞給傳送前要執行的動作。這份選項清單必須是空值,或者所包含的清單項目數必須與 preTransferAction 標頭清單相同,其中,每一個選項的項目索引必須符合其對應動作的索引。如果您列出多個選項,請用 URL 編碼逗點字元來區隔動作。
com.ibm.websphere.jmx.connector.rest.preTransferAction.options=comma-separated_list_of_options
如果您指定內建動作 com.ibm.websphere.jmx.connector.rest.preTransferAction.remove,對應選項必須是:
--user=adminUser --password=adminPw --keystorePassword=keystorePw [--rpcUser=rpcUser --rpcPassword=rpcPw]
- 指定用於刪除動作的認證。標頭的有效負載是一個 JSON 物件,其中,每一個 JSON 索引鍵都是環境變數,每一個 JSON 值都是其對應值。如果您指定系統路徑,請使用正斜線 (/)。
com.ibm.websphere.jmx.connector.rest.transferCredentials=list_of_environment_variables
- 指定在執行動作之前所要設定的環境變數。標頭的有效負載是一個 JSON 物件,其中,每一個 JSON 索引鍵都是環境變數,每一個 JSON 值都是其對應值。如果您指定系統路徑,請使用正斜線 (/)。
com.ibm.websphere.jmx.connector.rest.transferEnvVars=list_of_environment_variables
- 指定是否非同步執行檔案刪除和動作。預設值為 false。若要變更預設值,請將 boolean 指定為 true。
- 使用 DELETE 作業,將檔案從多部已登錄主機刪除。
- 請確定目標位置位於主機的可配置寫入目錄內。
- 呼叫 DELETE 作業。
DELETE https://controller_host:controller_port/IBMJMXConnectorREST/file/{filePath}[?recursiveDelete=boolean]
- {filePath} 是指定了目標位置的 UTF-8 URL 編碼絕對路徑。例如,如果檔案是 C:/temp/myFile.txt,則路徑是 C%3A%2Ftemp%2FmyFile.txt。
- recursiveDelete 是選用的查詢參數,用來刪除非空白的目錄。預設值為 false。
下一步
取得 REST 呼叫中的狀態或詳細資料。請參閱 取得針對多部已登錄主機所發出之 REST 呼叫的狀態。
上層主題: 在 Liberty 群體中傳送檔案
相關資訊:

檔名:twlp_collective_file_delete_multihost.html