HP OneView - Manual (Página 61)

5 Uso de las API de REST y otras interfaces de
programación
REST (Representational State Transfer) es un servicio web que utiliza operaciones CRUD (creación,
lectura, actualización y eliminación) básicas que se llevan a cabo en los recursos mediante los
métodos POST, GET, PUT y DELETE del protocolo HTTP. Para obtener más información acerca
de los conceptos de REST, consulte
http://en.wikipedia.org/wiki/Representational_state_transfer .
El dispositivo tiene una arquitectura orientada a recursos que proporciona una interfaz REST
uniforme. Cada recurso tiene un URI (Uniform Resource Identifier) y representa un dispositivo físico
o una construcción lógica. Puede utilizar las API de REST para manipular los recursos.
Para obtener información general acerca de las API de REST, consulte los siguientes temas:
•
«Operaciones con recursos»
•
«Códigos de retorno»
•
«Formato de los URI»
•
«Formato del modelo de recursos»
•
«Inicio de sesión en el dispositivo mediante las API de REST»
•
«Versión de la API de REST»
•
«Operaciones asíncronas frente a síncronas»
•
«Recurso de tarea»
•
«Tratamiento de errores»
•
«Control de concurrencia mediante etags»
•
«Consulta de recursos utilizando parámetros comunes de la API de REST»
•
«State Change Message Bus»
•
«Herramientas para desarrolladores en un explorador web»
•
«Uso de los comandos de Python y Windows PowerShell (vista previa técnica)»
5.1 Operaciones con recursos
Las API de RESTful no tienen estado. El gestor de recursos mantiene como representación de los
recursos el estado que se devuelve para los recursos. El cliente mantiene el estado de la aplicación
y podría manipular el recurso localmente, pero hasta que no se use un método PUT o POST, el
recurso, tal como lo conoce el gestor de recursos, no cambia.
Descripción Método de HTTP Operación
Crea nuevos recursos. Una solicitud POST síncrona devuelve el recurso
recién creado. Un solicitud POST asíncrona devuelve un URI
TaskResource
en el encabezado Location. Este URI realiza el
seguimiento del progreso de la operación POST.
POST URI del recurso (carga =
datos del recurso)
Create
(Creación)
Devuelve las representaciones del recurso solicitado GET URI del recurso Read (Lectura)
Actualiza un recurso existente PUT URI del recurso (carga =
datos de actualización)
Update
(Actualización)
Elimina el recurso especificado DELETE URI del recurso Delete
(Eliminación)
5.1 Operaciones con recursos 61