GET /nodes/{uuid}/maintenanceHistory
Use this method to return information about the maintenance history for a specific ThinkSystem or ThinkAgile device.
Note
This REST API requires Lenovo XClarity Administrator v3.3.0 or later.
Authentication
Authentication with username and password is required.
Request URL
GET https://{management_server_IP}/nodes/{uuid}/maintenanceHistory
where {uuid} is the UUID of the node to be retrieved. To obtain the node UUID, use the GET /nodes method.
Query parameters
None
Request body
None
Response codes
| Code | Description | Comments |
|---|---|---|
| 200 | OK | The request completed successfully. |
| 404 | Not found | A specified resource cannot be found. A descriptive error message is returned in the response body. |
| 500 | Internal Server Error | An internal error occurred. A descriptive error message is returned in the response body. |
Response body
| Parameters | Type | Description | ||
|---|---|---|---|---|
| results | Array of objects | Information about each maintenance activity If maintenance history is not available for the specified device, an empty array is returned | ||
| id | String | Maintenance activity ID | ||
| createdTimestamp | String | Timestamp when the maintenance activity occurred This timestamp is specified using ISO-8601 format (for example, 2019-05-02T19:28:14.000Z). For information about ISO-8601 format, see the W3C Date and Time Formats webpage. | ||
| messages | String | Message text that describes the maintenance activity | ||
| type | String | Maintenance type. This can be one of the following values.
| ||
The following example is returned if the request is successful.
{
"results": [{
"id": "1",
"createdTimestamp": "2020-07-01T04:46:59Z",
"message": "Primary XCC firmware is activated to TEI3A2C .",
"type": "Firmware"
},
{
"id": "2",
"createdTimestamp": "2020-07-01T04:47:09Z",
"message": "DIMM(SN: 125CE8A1) in slot 3 is added.",
"type": "Hardware"
},
...,
{
"id": "28",
"createdTimestamp": "2020-10-15T15:25:12Z",
"message": "Backup XCC firmware is updated to TEI3A8L by XCC Web.",
"type": "Firmware"
},
{
"id": "29",
"createdTimestamp": "2020-10-21T09:50:14Z",
"message": "Primary XCC firmware is activated to TEI3A8L.",
"type": "Firmware"
}]
}
Give documentation feedback