Transferencia de archivos a y desde un miembro de colectivo o host registrado con llamadas REST

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.

Antes de empezar

Para realizar operaciones de transferencia de archivos de un controlador de colectivo a un servidor de miembros, el servidor debe estar unido como miembro al de colectivo. Consulte Configuración de un colectivo de Liberty.

Para realizar operaciones de transferencia de archivos a un equipo host, el host debe haberse registrado con el controlador de colectivo. Consulte Registro de sistemas principales con un colectivo de Liberty.

Procedimiento

  1. 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.

  2. 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
  3. 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.
  4. 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:
  1. 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
  2. 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:
  1. Establezca el contexto de direccionamiento del host registrado como cabecera HTTP.
    com.ibm.websphere.jmx.connector.rest.routing.hostName=myTarget.com
  2. 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:
  1. 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
  2. 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.


Icono que indica el tipo de tema Tema de tarea



Icono de indicación de fecha y hora Última actualización: Tuesday, 6 December 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-libcore-mp&topic=twlp_collective_file_transfer_member_host
Nombre de archivo:twlp_collective_file_transfer_member_host.html