Consulta
Es posible obtener el listado de instancias de BBDD consultando el método:
Hay disponibles dos versiones del mismo:
- v1.0 - La información que ofrece la respuesta es: el identificador (uuid), nombre, ventana y fechas. Este listado se puede filtrar por fechaUltModificacionIni y fechaUltModificacionFin .
- v1.1 - La respuesta que se muestra en la definición de la API para el método se corresponde con esta versión. Los filtros disponibles en ese caso son: nombre, estado, idAgrupacion, fechaUltModificacionIni, fechaUltModificacionFin.
Para obtener un grupo lógico concreto se ejecutará el método:
Creación y edición
Es posible crear instancias de BBDD mediante el método:
Requisitos funcionales
- El nombre no puede superar los 100 caracteres ni puede existir otra instancia BBDD con el mismo nombre.
- La descripción no puede superar los 255 caracteres.
- La memoria RAM no puede superar los 150 caracteres.
- La capacidad de disco no puede superar los 150 caracteres.
- El tipo de procesador debe ser válido.
- La agrupación debe ser válida y el usuario delegado debe pertenecer a la misma.
- El tipo de instancia debe ser válido.
- El formato de ventana horaria es HH:mm.
- El catálogo software debe ser válido.
- El tipo de instancia de replicación debe ser válido.
- El software de replicación debe ser válido. Si el tipo de instancia de replicación es diferente de "No replica", debe corresponder con la clasificación tecnológica de replicación. Para consultar elementos compatibles con este campo, debe consultar la tabla maestra de clasificaciones tecnológicas filtrando por el nombre REPLICACION y listar catálogos software que pertenezcan a esas clasificaciones tecnológicas.
- El tipo de replicación debe ser válido si el tipo de instancia de replicación es diferente de "No replica".
La modificación de la instancia se realizará con el método:
Requisitos funcionales
- La instancia de base de datos a modificar debe ser válida.
- Mismos requisitos de campos que para la creación.
¡Importante!
Para realizar correctamente la modificación se debe enviar el objeto completo cada vez que se consuma este recurso.
En caso de no enviar alguno de los valores, el recurso borrará la información para los atributos no informados.
Entidades asociadas
Servidores
Los servidores asociados a una instancia de base de datos, al ser elementos de hardware, se corresponden a recursos de infraestructura en CMS.
La información sobre los servidores de una instancia de base de datos se podrá consultar a través del listado filtrando por la instancia (uuidInstanciaBBDD) y el parámetro codigo=POR_INSTANCIA_BBDD en la versión v1.0.
Ejemplo /cgescms/recursos/infraestructura?uuidInstanciaBBDD=9FC3A29215CD01FAA609000C29B08512&codigo=POR_INSTANCIA_BBDD
Asociar y quitar servidores
Para consultar los recursos de infraestructura que pueden ser asociados como servidores a instancias, debe consultar el método de listado de recursos filtrando por el codigo=CMS_INSTANCIAS
Existe la posibilidad de gestionar las relaciones entre instancia de BBDD y servidor. Para crear una relación, encontramos el método:
Requisitos funcionales
- El identificador de la instancia debe ser válido.
- El identificador del servidor debe ser válido.
- La relación entre la instancia de base de datos y el servidor no debe existir previamente.
Para eliminar la relación, se puede ejecutar:
Requisitos funcionales
- El identificador de la instancia debe ser válido.
- El identificador del servidor debe ser válido.
- La relación entre ambas debe ser una relación activa.
Esquemas
Para la consulta de todos los esquemas asociados a una instancia de base de datos puede consultar el siguiente método filtrando por uuidInstanciaBBDD y estado en su versión v1.0.
Ejemplo /cgescms/esquemas?uuidInstanciaBBDD=9FC3A29215CD01FAA609000C29B08512&estado=0
Relaciones grupo lógico-entorno-plataforma
Para la consulta de todas las relaciones grupo lógico-entorno-plataforma asociadas a una instancia de base de datos puede consultar el siguiente método filtrando por uuidInstanciaBBDD y estado en su versión v1.1.
Ejemplo /cgescms/relgrplogentplats?uuidInstanciaBBDD=9FC3A29215CD01FAA609000C29B08512&estado=0