Zona
Ruta API
devmgr/v2/storage-systems
Verbos HTTP admitidos
Los verbos HTTP admitidos incluyen GET, POST y DELETE:
• Las solicitudes GET se utilizan para solicitudes de sólo lectura.
• LAS solicitudes POST se utilizan para crear y actualizar objetos, así como para solicitudes de lectura que
podrían tener implicaciones de seguridad.
• Las solicitudes DE ELIMINACIÓN suelen utilizarse para quitar un objeto de la gestión, quitar un objeto por
completo o restablecer el estado del objeto.
Actualmente, la API de servicios web no admite PUT ni PARCHE. En su lugar, puede usar
POST para proporcionar la funcionalidad típica de estos verbos.
Aceptar encabezados
Al devolver un cuerpo de la solicitud, Web Services devuelve los datos en formato JSON (a menos que se
especifique lo contrario). Algunos clientes solicitan por defecto "'text/html'" o algo similar. En estos casos, la
API responde con un código HTTP 406, indicando que no puede proporcionar datos en este formato. Como
práctica recomendada, debe definir el encabezado Accept como "'Application/json'" para los casos en los que
espere JSON como tipo de respuesta. En otros casos en los que no se devuelve un cuerpo de respuesta (por
ejemplo, ELIMINAR), siempre que el encabezado Accept no provoque ningún efecto no intencional.
Respuestas
Cuando se realiza una solicitud a la API, una respuesta devuelve dos partes fundamentales de información:
• Código de estado HTTP: Indica si la solicitud se ha realizado correctamente.
• Cuerpo de respuesta opcional — normalmente proporciona un cuerpo JSON que representa el estado del
recurso o un cuerpo que proporciona más detalles sobre la naturaleza de un fallo.
Debe comprobar el código de estado y la cabecera de tipo de contenido para determinar el aspecto del cuerpo
de respuesta resultante. Para los códigos de estado HTTP 200-203 y 422, Web Services devuelve un cuerpo
Descripción
Se realiza una solicitud a un recurso DE REST o un
extremo específico dentro de la API de servicios web.
La mayoría de los extremos tienen el siguiente
formato:
devmgr/v2/<resource>/[id]
La ruta API consta de tres partes:
•
(Administrador de dispositivos) es el
devmgr
espacio de nombres de la API de servicios web.
•
Indica la versión de la API a la que tiene
v2
acceso. También puede utilizar
acceder a los extremos de inicio de sesión.
•
storage-systems
documentación.
utils
para
es una categoría de la
797
