HP OneView - Manual (Página 62)

5.2 Códigos de retorno
Descripción
Código de
retorno
Operación correcta 2xx
Error del lado del cliente con el mensaje de error devuelto 4xx
Error del Dispositivo con el mensaje de error devuelto 5xx
NOTA: Si se produce un error, lo que se indica mediante un código de retorno 4xx o 5xx, se
devuelve un ErrorMessage. El modelo de recurso esperado no se devuelve.
5.3 Formato de los URI
Todos los URI hacen referencia a recursos. El cliente no tiene que crear ni modificar los URI. El
URI de un recurso es estático y utiliza el formato https://{appl}/rest/categoría del
recurso/ID de instancia del recurso
donde:
https://{appl} Dirección del dispositivo
/rest Tipo de URI
/categoría del recurso Categoría del recurso (por ejemplo, server-profiles)
/ID de instancia del
recurso
Identificador de la instancia específica del recurso (opcional)
5.4 Formato del modelo de recursos
Los recursos son compatibles con JSON (JavaScript Object Notation) para el intercambio de datos
mediante una API de REST. Si no se especifica otra cosa en la operación de la API de REST, el
valor predeterminado es JSON.
5.5 Inicio de sesión en el dispositivo mediante las API de REST
Cuando se inicia sesión en el dispositivo usando la API de REST login-sessions, se devuelve
un identificador de sesión. El identificador de sesión se utiliza en todas las operaciones posteriores
de la API de REST en el encabezado auth, excepto como se indica en Encabezados de la solicitud
de la API de REST. El identificador de sesión es válido durante 24 horas.
Fin de sesión Inicio de sesión
Operación
DELETE
API
/rest/login-sessions
Encabezados de la solicitud
auth:{SuIdDeSesión}
Encabezados de la solicitud de la API de REST
Cuerpo de la solicitud
Ninguno
Respuesta
204 No Content
Operación
POST
API
/rest/login-sessions
Encabezados de la solicitud
Encabezados de la solicitud de la API de REST
Cuerpo de la solicitud
{"userName":"SuNombreDeUsuario","password":"SuContraseña"}
NOTA: Este es un ejemplo de un inicio de sesión local en el
dispositivo. Si está utilizando un servicio de directorio, debe
agregar los siguientes atributos: authnHost y
authLoginDomain
.
Respuesta
El LoginSessionIdDTO que incluye el identificador de sesión
62 Uso de las API de REST y otras interfaces de programación