La API REST de Servicios CGES permite la consulta de todos los recursos de infraestructura (hardware) que pueden ser gestionados por el proveedor que realiza la llamada.
Los filtros disponibles y la información extraída en el listado son únicos para todos los usuarios de la API.
El parámetro uuid que devuelve el listado será el utilizado para realizar el resto de las operaciones con cada uno de los recursos contenidos en el mismo.
También será posible el empleo del parámetro codigo para la consulta segmentada de subconjuntos predefinidos para el total de recursos de infraestructura.
Los recursos de infraestructura pertenecen a un tipo concreto, y a su vez, estos tipos están agrupados en familias.
Estas son las familias que conforman el conjunto de recursos de infraestructura y que pueden gestionarse (dependiendo el perfil del proveedor) desde este apartado de la API:
Es posible consultar las familias y tipos disponibles en los siguientes métodos de tablas maestras de la API:
|
Para obtener más información acerca de un recurso de infraestructura se puede consultar el método destinado a tal fin en la API.
Este método devuelve información detallada del recurso de hardware como, por ejemplo, el número de serie, código SAS, la marca, el modelo, la ubicación, el estado y otros datos de interés.
La capacidad de consulta es análoga a la capacidad de gestión en los listados.
Además, en función de la familia y el tipo del recurso, podrá consultar algunos enlaces extendidos para extraer otra información adicional (ver apartados siguientes).
Es posible realizar la creación de un recurso mediante el siguiente método:
Requisitos funcionales
Debe enviarse siempre la estructura de datos completa del recurso. En caso de elementos opcionales, enviar null.
El código SAS es opcional y debe cumplir con un formato válido (6/7 cifras y una letra).
Los valores de IP y MAC son opcionales, deben tener un máximo de 64 caracteres y cumplir con formatos válidos.
Dependencias para el expediente de compra:
En caso de querer registrar información adicional de puestos de trabajo o redes durante la creación, deberá lanzar primero este método y luego actualizar estos valores con los métodos disponibles (ver apartados posteriores).
Para realizar correctamente la modificación se debe enviar el objeto completo cada vez que se consuma este recurso. |
Requisitos funcionales comunes
El recurso debe ser gestionable por el proveedor (visualizable en su listado)
Debe cumplir con los requerimientos de obligatoriedad y formato expresados en la creación.
Existen tres versiones diferentes para la modificación de recursos de infraestructura:
Requisitos funcionales
Debe enviarse siempre la información completa del recurso al editar.
Este método permite consultar la información adicional acerca de un recurso de la familia "Hardware.Puesto de trabajo"
Este método permite consultar la información adicional acerca de un recurso de las familias de "Redes"
Este método permite consultar la información adicional acerca de un recurso de la familia "Hardware.Maquina Virtual"
Este método permite consultar la información adicional acerca de un recurso de la familia "Hardware.Servidor"
También es posible modificar la información extendida de los recursos, empleado los siguientes métodos:
El siguiente método permite actualizar la información adicionar de un recurso de la familia "Hardware.Puesto de trabajo".
Para realizar correctamente la modificación se debe enviar el objeto completo cada vez que se consuma este recurso. |
Requisitos funcionales
El recurso debe ser gestionable por el proveedor (visualizable en su listado)
Todos los campos son opcionales.
El siguiente método permite actualizar la información adicional acerca de un recurso de las familias de "Redes".
Para realizar correctamente la modificación se debe enviar el objeto completo cada vez que se consuma este recurso. |
Requisitos funcionales
El recurso debe ser gestionable por el proveedor (visualizable en su listado)
Todos los campos son opcionales.
El siguiente método permite obtener los contratos vinculados a un recurso de infraestructura.