Base de servicios web DE REST
Sugerir cambios
PDF
La transferencia de estado representacional (REST) es un estilo para crear aplicaciones web distribuidas. Cuando se aplica al diseño de una API de servicios web, establece un conjunto de tecnologías para exponer recursos basados en servidor y administrar sus estados. Usa protocolos y estándares convencionales para proporcionar una base flexible a la hora de administrar clústeres de ONTAP.
|
Mientras QUE REST establece un conjunto común de tecnologías y prácticas recomendadas, los detalles de cada API pueden variar en función de las opciones que se tomen durante el desarrollo. Debe conocer las características de diseño de la API DE REST de ONTAP antes de utilizarla con una implementación activa. |
Recursos y representación estatal
Los recursos son los componentes básicos de un sistema basado en la Web. Al crear una aplicación DE SERVICIOS web DE REST, las tareas de diseño más tempranas incluyen:
-
Identificación de recursos basados en sistemas o servidores
Cada sistema utiliza y mantiene los recursos. Un recurso puede ser un archivo, una transacción comercial, un proceso o una entidad administrativa. Una de las primeras tareas en el diseño de una aplicación basada en servicios web DE REST es identificar los recursos.
-
Definición de estados de recursos y operaciones estatales asociadas
Los recursos siempre se encuentran en uno de un número limitado de estados. Los estados, así como las operaciones asociadas utilizadas para afectar los cambios de estado, deben estar claramente definidos.
Extremos de URI
Todos los recursos REST deben definirse y ponerse a disposición mediante un esquema de direccionamiento bien definido. Los extremos en los que se encuentran e identifican los recursos utilizan un identificador uniforme de recursos (URI). El URI proporciona un marco general para crear un nombre único para cada recurso de la red. El Localizador uniforme de recursos (URL) es un tipo de URI que se utiliza con los servicios web para identificar y acceder a los recursos. Los recursos normalmente se exponen en una estructura jerárquica similar a un directorio de archivos.
Mensajes HTTP
El Protocolo de transferencia de hipertexto (HTTP) es el protocolo utilizado por el cliente y servidor de servicios web para intercambiar mensajes de solicitud y respuesta sobre los recursos. Como parte del diseño de una aplicación de servicios web, los métodos HTTP se asignan a los recursos y a las correspondientes acciones de administración del estado. HTTP no tiene estado. Por lo tanto, para asociar un conjunto de solicitudes y respuestas relacionadas como parte de una transacción, se debe incluir información adicional en los encabezados HTTP transportados con los flujos de datos de solicitud y respuesta.
Formato JSON
Aunque la información se puede estructurar y transferir entre un cliente de servicios web y un servidor de varias maneras, la opción más popular es la notación de objetos JavaScript (JSON). JSON es un estándar del sector para representar estructuras de datos simples en texto sin formato y se utiliza para transferir información de estado que describe los recursos. La API REST de ONTAP utiliza JSON para formatear los datos transportados en el cuerpo de cada solicitud y respuesta de HTTP.
Transacción de API de REST típica
Cada transacción de API consta de una solicitud HTTP y la respuesta asociada. En esta ilustración, se muestra cómo recuperar la versión del software ONTAP que utiliza el clúster.
La solicitud enviada desde el cliente al servidor consta de lo siguiente:
-
OBTENER verbo
-
La ruta URL del clúster
-
Parámetro de consulta (campos)
-
Solicitar encabezados, incluida la autorización
La respuesta enviada desde el servidor al cliente consta de lo siguiente:
-
Código de estado 200
-
Encabezados de respuesta
-
Cuerpo de la respuesta que contiene la versión del software del clúster