Puede llevar a cabo operaciones de transferencia de archivos direccionadas desde un controlador de colectivo o a un miembro de colectivo o a un host registrado de un colectivo invocando API REST. Las operaciones incluyen la descarga de archivos desde una ubicación remota, cargando archivos en una ubicación remota y suprimiendo archivos en una ubicación remota. Utilice las API REST GET, POST o DELETE. Las operaciones de transferencia de archivos se producen en IBM JMX REST Connector.
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.
De forma alternativa, puede utilizar un host de colectivo, un puerto, un ID de usuario y una contraseña de inicio de sesió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.
Las característica collectiveController-1.0 y collectiveMember-1.0 habilitan la característica
restConnector-1.0, que proporciona la prestación de transferencia de archivos. Por lo tanto, los controladores de colectivos y los miembros 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.
- A menos que trabaje directamente con una instancia de Liberty, establezca el contexto de direccionamiento como cabeceras HTTP.
- Direccionamiento del servidor de miembros
com.ibm.websphere.jmx.connector.rest.routing.hostName=serie
com.ibm.websphere.jmx.connector.rest.routing.serverName=serie
com.ibm.websphere.jmx.connector.rest.routing.serverUserDir=serie
- Direccionamiento de host registrados
com.ibm.websphere.jmx.connector.rest.routing.hostName=serie
- Asegúrese de que el archivo de destino se halle en los directorio de lectura/escritura configurables del servidor para realizar operaciones de transferencia de archivos con un servidor de miembros, o en los directorios de lectura/escritura configurables del host para realizar operaciones de transferencia de archivos con un host registrado.
- Invoque las API REST que cargan, descargan o suprimen archivos.
{vía_acceso_archivo} debe tener codificación de URL. Para las operaciones de direccionamiento con hosts registrados, {vía_acceso_archivo} debe ser una vía de acceso absoluta y no puede contener variables de Liberty.
- Descargue un archivo de un servidor de miembros o de un host registrado utilizando la operación GET.
GET https://host_controlador:puerto_controlador/IBMJMXConnectorREST/file/{vía_acceso_archivo}
- Cargue un archivo a un servidor de miembros o a un host registrado utilizando la operación POST.
POST https://host_controlador:puerto_controlador/IBMJMXConnectorREST/file/{vía_acceso_archivo}
- Suprima un archivo de un servidor de miembros o de un host registrado utilizando la operación DELETE.
DELETE https://host_controlador:puerto_controlador/IBMJMXConnectorREST/file/{vía_acceso_archivo}
- Suprima varios archivos de un servidor de miembros o de un host registrado utilizando la operación POST.
POST https://host_controlador:puerto_controlador/IBMJMXConnectorREST/file/collection
Ejemplo
Para descargar el archivo
myFile.txt del servidor de miembros
myServerA al host
myTarget.com con un directorio de usuario de
C:/server/wlp:
- Establezca el contexto de direccionamiento del servidor de miembros como cabeceras 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
- Invoque una llamada GET para descargar el archivo.
GET https://myTarget.com:9443//IBMJMXConnectorREST/file/C%3A%2Ftemp%2FmyFile.txt
Para descargar el archivo
myFile.txt del host registrado
myTarget.com:
- Establezca el contexto de direccionamiento del host registrado como cabecera HTTP.
com.ibm.websphere.jmx.connector.rest.routing.hostName=myTarget.com
- Invoque una llamada GET para descargar el archivo.
GET https://myTarget.com:9443//IBMJMXConnectorREST/file/C%3A%2Ftemp%2FmyFile.txt
Para descargar el archivo
server.xml del servidor de miembros
myServerA al host
myTarget.com con un directorio de usuario de
C:/server/wlp:
- Establezca el contexto de direccionamiento del servidor de miembros como cabeceras 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
- Invoque una llamada GET para descargar el archivo ${server.config.dir}/server.xml.
GET https://myTarget.com:9443//IBMJMXConnectorREST/file/%24{server.config.dir}%2Fserver.xml
Qué hacer a continuación
Obtenga el estado o los detalles de la llamada REST. Consulte
Obtención del estado en una llamada REST para varios hosts registrados.