Changes between Version 15 and Version 16 of ApiRest

Timestamp:

Apr 24, 2017, 12:27:42 PM (7 years ago)

Author:

ramon

Comment:

Actualización documentación API REST.

ApiRest

@@ -355 +355 @@
 Las siguientes rutas REST serán utilizadas por un servidor UDS para controlar procesos de iniciación y parada de clientes que tengan instalada una imagen en particular. El servidor OpenGnsys actuará como intermediario entre el servidor de UDS y los agentes OGAgent instalados en los sistemas operativos que podrán usarse en remoto.
 
- - {{{/ous/:id1/images/:id2/reserve}}} o {{{/ous/:id1/images/:id2/reserve?lab=:id3}}}
-   - Elegir al azar un cliente que tenga instalada una imagen (y, opcionalmente, que esté situado en una determinada aula), reservar su uso para acceso remoto, enviarle una operación de arranque WOL (o de reinicio, si el cliente está encendido) y registrar en su cola de acciones la operación de iniciar sesión en la partición de dicha imagen.
-   - Método: POST.
-   - Parámetros:
-     - {{{lab}}} (entero): identificador del aula del cliente (opcional).
+ - {{{/ous/:id1/images/:id2/reserve}}}
+   - Elegir al azar un cliente que tenga instalada una imagen (y, opcionalmente, que esté situado en una determinada aula), reservar su uso para acceso remoto durante un número de horas (24 h. por defecto), enviarle una operación de arranque Wake-On-Lan (o de reinicio, si el cliente está encendido) y registrar en su cola de acciones la operación de iniciar sesión en la partición de dicha imagen.
+   - Método: POST.
+   - Parámetros (objeto):
+     - {{{labid}}} (entero): identificador del aula del cliente (opcional).
+     - {{{maxtime}}} (entero): tiempo máximo de reserva, en horas (opcional, 24 h. por defecto).
    - Devuelve: objeto
      - {{{id}}} (entero): identificador del cliente seleccionado.
+     - {{{name}}} (cadena): nombre del cliente.
      - {{{mac}}} (cadena): dirección MAC de la interfaz de red (sin caracteres ":").
      - {{{ip}}} (cadena): dirección IP del cliente.
@@ -373 +375 @@
    - Método: POST.
    - Parámetros:
-     - {{{urllogin}}} (cadena): URL para redirigir una notificación de inicio de sesión de usuario.
-     - {{{urllogout}}} (cadena): URL para redirigir una notificación de fin de sesión de usuario.
+     - {{{urlLogin}}} (cadena): URL para redirigir una notificación de inicio de sesión de usuario.
+     - {{{urlLogout}}} (cadena): URL para redirigir una notificación de fin de sesión de usuario.
 
  - {{{/ous/:id1/labs/:labid/clients/:clntid/session}}}
@@ -387 +389 @@
 
 '''Notas de implementación:'''
- - Se tendrán que hacer modificaciones en la BD para almacenar datos de reserva de equipos y de sesión de usuarios.
  - Sería recomendable modificar el proceso de restauración para incluir en el SO datos de la imagen desplegada.
  - Puede ser necesario crear un proceso de revisión cronológica de ejecución de acciones.
- - Será necesario crear un script personalizado de inicio para arrancar un cliente en una partición determinada, el cual tendrá que ser eliminado tras su ejecución o trascurrido en tiempo determinado.
  - Estudiar la manera de reintentar el envío de peticiones fallidas.