Los servicios web mencionados en este documento solo están disponibles en la versión de software LTFS-LE 1.0.4.01.
Los programadores pueden obtener la firma admitida del servicio web disponible de la versión instalada del software de LTFS-LE del archivo WSDL 1.1. Se puede acceder a este archivo desde la siguiente ubicación:
https://server.mydomain.com:7002/LTFS/LTFSLEWS?WSDL
En el ejemplo anterior, server.mydomain.com
es el nombre de host y el nombre de dominio.
Para algunas instancias de programación, posiblemente necesite el siguiente nombre de puerto:
port name="LTFSLEWSSoap12HttpPort"
Los tiempos de ejecución de backend de los servicios web de LTFS-LE son diferentes. Los servicios web que pertenecen al estado del volumen o la operación pueden devolverse rápidamente. No obstante, el tiempo de ejecución de algunos servicios web depende de varios factores que están fuera del control del software. El software no puede predecir los factores mecánicos, como las acciones del usuario. Por ejemplo, determinados servicios web, como el servicio de asignación de volumen, pueden demorar más tiempo si el volumen incluye muchos archivos. Utilizando un ejemplo diferente, la finalización de la operación de expulsión depende de que el operador se dirija a la biblioteca y extraiga el volumen del CAP.
Para abordar estas discrepancias sin dejar de proporcionar una interfaz programática coherente en todas las llamadas de servicios web, la llamada al servicio de la API se devuelve de inmediato. Los resultados devueltos dependen del tipo de servicio. LTFS-LE posee dos categorías de servicios web:
Servicios de estado
Los servicios de estado son los servicios que permiten a los usuarios obtener el estado del volumen y de la unidad. Para obtener más información, consulte "Servicios de estado".
Servicios de gestión
Los servicios de gestión son los servicios que permiten gestionar los recursos de hardware. Por ejemplo, puede usar un servicio de gestión para introducir un volumen, expulsar un volumen y conectar o desconectar un volumen. Para obtener más información, consulte "Servicios de gestión".
Los servicios de gestión usan un proceso de dos pasos para invocar una función de la API y devolver resultados:
Invoque la función. Un ID de trabajo de solicitud único se devuelve de inmediato.
Invoque la función getJobStatus
y especifique el ID de trabajo devuelto en el paso 1.
Esta acción devuelve uno de los siguientes estados de trabajo:
0 (la llamada de servicio web asociada al ID de trabajo ha finalizado).
1 (la llamada de servicio web asociada al ID de trabajo todavía está en curso).
-1 (no se encontró una llamada de servicio web con el ID del trabajo en el sistema).
Las firmas de los servicios web de LTFS-LE incluyen cada formato de mensaje de solicitud de SOAP, formato de mensaje de respuesta de SOAP y formato de mensaje de error de SOAP. Todos los servicios web de LTFS-LE solamente admiten mensajes de SOAP. El formato del mensaje de SOAP implementa la especificación SOAP 1.2. Consulte "Servicios de estado" y "Servicios de gestión" para conocer la firma de SOAP válida de cada función.
Los servicios web descritos en este documento solo están disponibles en la versión de software de LTFS-LE 1.0.4.01.
Todas las API de servicios web están accesibles únicamente mediante HTTPS.
Mediante el uso de WS-Security, todos los mensajes de solicitud de SOAP de la API de servicios web incluyen un token de nombre de usuario en el encabezado SOAP en el que el nombre de usuario y la contraseña están en texto sin formato.
Los valores username
y password
se usan en el token de nombre de usuario como ejemplo solamente. Deben reemplazarse por un nombre de usuario y una contraseña válidos.
Todos los datos que se incluyen en el mensaje de solicitud y respuesta de SOAP son datos de ejemplo solamente que permiten mostrar la estructura de datos del mensaje de solicitud y respuesta de SOAP.