Supresión de archivos de varios hosts registrados con una sola llamada REST
Puede suprimir archivos de varios hosts registrados de un colectivo a partir de un controlador de colectivo invocando la API REST DELETE. Las supresiones de archivos se producen en IBM JMX REST Connector.
Antes de empezar
Cree un controlador de colectivo. Consulte Configuración de un colectivo de Liberty.
Registre cada equipo host remoto con el controlador de colectivo. Consulte Registro de sistemas principales con un colectivo de Liberty.
Procedimiento
- Opcional: Para obtener información sobre las API REST, consulte con navegador
https://nombre_host_controlador:nombre_puerto_controlador/IBMJMXConnectorREST/api y especifique el ID de usuario y la contraseña de inicio de sesión del administrador del controlador.
El controlador debe estar en ejecución para ver la documentación de la API REST.
En las secciones Transferencia de archivos y Direccionamiento se describen las API utilizadas para transferir archivos entre el controlador de colectivo y un servidor miembro o un host registrado.
La característica collectiveController-1.0 habilita la característica restConnector-1.0 que proporciona la prestación de transferencia de archivos. Por lo tanto, los controladores de colectivos no necesitan especificar restConnector-1.0 en un gestor de características para ver las API REST o realizar operaciones de transferencia de archivos. Una configuración de servidor autónomo puede necesitar la característica restConnector-1.0 para ver las API REST.
- Lista de los hosts de destino en una cabecera HTTP para el controlador de colectivo.
com.ibm.websphere.collective.hostNames=lista_separada_por_comas_de_hosts_de_destino
Opcionalmente, establezca otras cabeceras HTTP:
- Especifique si se va a llevar a cabo la supresión de archivos y la acción de forma asíncrona.
El valor predeterminado es false. Para cambiar el valor predeterminado, especifique true para booleano.
com.ibm.websphere.jmx.connector.rest.asyncExecution=booleano
- Especifique un conjunto de acciones que se llevarán a cabo antes de la supresión del archivo. Una acción incorporada existente es com.ibm.websphere.jmx.connector.rest.preTransferAction.remove,
que elimina los servidores de Liberty del directorio de Liberty que se han de suprimir de la colección.
Utilice la cabecera para listar otras acciones personalizadas. Si se lista más de una acción personalizada, delimite la acción con un carácter de coma codificado en URL.
com.ibm.websphere.jmx.connector.rest.preTransferAction=lista_de_acciones_separada_por_comas
Para habilitar las acciones personalizadas, añada la siguiente configuración al controlador de colectivo server.xml:<hostAccess enableCustomActions="true" />
- Especifique una lista de opciones para pasar a las acciones previas a la transferencia. Esta lista de opciones debe ser un valor nulo o contener la misma cantidad de elementos de lista que la lista de cabecera preTransferAction, en que el índice de elementos de cada opción debe coincidir con el índice de la acción correspondiente. Si se lista más de una opción, delimite la acción con un carácter de coma codificado en URL.
com.ibm.websphere.jmx.connector.rest.preTransferAction.options=lista_de_opciones_separada_por_comas
Si especifica la acción incorporada com.ibm.websphere.jmx.connector.rest.preTransferAction.remove, la opción correspondiente debe ser:
--user=adminUser --password=adminPw --keystorePassword=keystorePw [--rpcUser=rpcUser --rpcPassword=rpcPw]
- Especifique las credenciales que se van a utilizar para la acción de supresión. La carga útil de la cabecera es un objeto JSON, donde cada clave JSON es una variable de entorno y cada valor JSON es el valor correspondiente. Si especifica vías de acceso del sistema, utilice barras inclinadas (/).
com.ibm.websphere.jmx.connector.rest.transferCredentials=lista_de_variables_de_entorno
- Especifique las variables de entorno que se deben establecer antes de ejecutar las acciones. La carga útil de la cabecera es un objeto JSON, donde cada clave JSON es una variable de entorno y cada valor JSON es el valor correspondiente. Si especifica vías de acceso del sistema, utilice barras inclinadas (/).
com.ibm.websphere.jmx.connector.rest.transferEnvVars=lista_de_variables_de_entorno
- Especifique si se va a llevar a cabo la supresión de archivos y la acción de forma asíncrona.
El valor predeterminado es false. Para cambiar el valor predeterminado, especifique true para booleano.
- Suprima un archivo de varios hosts registrados utilizando la operación DELETE.
- Asegúrese de que la ubicación de destino se halle dentro de un directorio de escritura configurable de los hosts.
- Invoque la operación DELETE.
DELETE https://host_controlador:puerto_controlador/IBMJMXConnectorREST/file/{vía_acceso_archivo}[?recursiveDelete=booleano]
- {vía_acceso_archivo} es una vía de acceso absoluta codificada en URL de UTF-8 que especifica la ubicación de destino. Por ejemplo, si este archivo es C:/temp/myFile.txt, la vía de acceso es C%3A%2Ftemp%2FmyFile.txt.
- recursiveDelete es un parámetro de consulta opcional que suprime directorios no vacíos. El valor predeterminado es false.
Qué hacer a continuación
Obtención del estado o de los detalles en la llamada REST. Consulte Obtención del estado en una llamada REST para varios hosts registrados.


http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-libcore-mp&topic=twlp_collective_file_delete_multihost
Nombre de archivo:twlp_collective_file_delete_multihost.html