Recursos y propiedades
En esta sección se describen los recursos y las propiedades de las interfaces REST basadas en los archivos de esquema estándar DMTF y los archivos de esquema OEM proporcionados por Lenovo. En la subsección Resumen de recursos, se muestra el número de recursos, la ruta de acceso de recursos y el archivo de esquema al que se hace referencia. Otra subsección, Valores de propiedad, proporciona la definición de cada URI que incluye valores de propiedad, acciones y otras operaciones REST.
Si REST encuentra un error y no puede completar la solicitud, devolverá "500 Error interno del servidor".
Si la respuesta no está lista después de más de 120 segundos de haber recibido la solicitud, REST devuelve “503 Servicio temporalmente no disponible”.
Si hay más de una solicitud a los mismos recursos de esquema, se manejarán una por una, es decir, la segunda solicitud se manejará después de que se realice la primera solicitud. Por ejemplo, si se envían dos solicitudes a los recursos de MetricReport, la primera accede a PowerMetrics y la segunda accede a CPUTemp. La solicitud a CPUTemp esperará hasta que se complete la solicitud a PowerMetrics, por lo que el tiempo de respuesta de CPUTemp en este caso será más largo que si únicamente se hubiera enviado una solicitud a CPUTemp.
PATCH
Para la actualización de REST (PATCH), REST comprobará primero si todas las propiedades/valores de entrada coinciden con la definición del esquema. Si hay alguna propiedad/valor de entrada que es incorrecto, REST no realizará ninguna actualización y devolverá un error (400 Solicitud incorrecta). Si alguna de las propiedades de entrada es de solo lectura o no está implementada, el valor de esta propiedad no cambiará. Si un valor de propiedad requiere validación adicional, se describen más detalles en la columna “Comment” de la propiedad. De lo contrario, se enviará directamente a la fuente de datos. REST devolverá directamente un error cuando se produzca un error al actualizar el origen de datos. Si se produce algún error durante las operaciones, REST no revertirá las actualizaciones que ya se hayan realizado.
PATCH Body ERROR | Código de estado HTTP | Messageld (Base) | Comentario |
Vacío | 400 (Solicitud incorrecta) | EmptyJSON | |
Formato Json incorrecto | 400 (Solicitud incorrecta) | MalformedJSON | |
Solo propiedades desconocidas | 400 (Solicitud incorrecta) | PropertyUnknown | |
Tipo de valor no válido | 400 (Solicitud incorrecta) | PropertyValueTypeError | |
Rango/formato de valor no válido | 400 (Solicitud incorrecta) | PropertyValueFormatError | |
Valor de enumeración no válido | 400 (Solicitud incorrecta) | PropertyValueNotInList | |
Solo propiedades de solo lectura o no implementadas | 400 (Solicitud incorrecta) | PropertyNotWritable | |
Propiedades grabables válidas junto con propiedades de solo lectura o no implementadas | 200 (OK) | PropertyNotWritable | ExtendedInfo se agregará para las propiedades de solo lectura en la respuesta. |
Propiedades válidas que se pueden escribir junto con propiedades desconocidas | 200 (OK) | PropertyUnknown | ExtendedInfo se agregará para las propiedades desconocidas en la respuesta. |
Error de contenido None | 500 (Error interno del servidor) | GeneralError | Por ejemplo, error de llamada a la API. |
Anotación de Odata | Esto se ignora. Cualquier propiedad que coincide con el patrón “@odata.” también se trata como anotación de Odata. | ||
Solo anotación de Odata | 400 (Solicitud incorrecta) | ExtendedInfo se agregará para NoOperation en la respuesta. |
Recopilación
Todos los recursos de recopilación implementados y sus propiedades se ajustarán al DSP 0266 y al esquema de recolección. Por ejemplo, sus URI se ajustarán al “Redfish.Uris” del esquema CSDL. En este documento, no se describen todos los recursos de recopilación implementados, a menos que el recurso de recopilación implementado necesite algunos comentarios.
Si el usuario desea acceder a un recurso miembro de la recopilación, primero debe acceder a su recurso de recopilación para comprobar si el recurso existe o no. De lo contrario, no se podrá acceder al recurso o es posible que los datos del recurso no sean válidos.
Propiedades de anotación de Odata
Todas las propiedades de anotación de Odata implementadas deben cumplir con el DSP 0266. En este documento, todas las propiedades de anotación de Odata implementadas no se describen específicamente a menos que la propiedad implementada necesite algunos comentarios adicionales.