POST /nodes/ssdRemainingLifeStatistics
Use this method to return remaining-life statistics for SSDs in all or specific managed servers.
Note
This REST API requires Lenovo XClarity Administrator v3.4.0 or later.
Authentication
Authentication with username and password is required.
Request URL
POST https://{management_server_IP}/nodes/ssdRemainingLifeStatistics
Query parameters
| Parameter | Required / Optional | Description |
|---|---|---|
| lowRemainingLifeBoundary={integer} | Optional | Low remaining-life threshold, as a percentage The default value is 10. |
| highRemainingLifeBoundary={integer} | Optional | High remaining-life threshold, as a percentage The default value is 50. |
The following example returns statistics for SSDs with a low threshold of 10% and a high threshold of 50%.
POST https://192.0.2.0/nodes/ssdRemainingLifeStatistics
The following example returns statistics for SSDs with a low threshold of 15% and a high threshold of 85%.
POST https://192.0.2.0/nodes/ssdRemainingLifeStatistics
?lowRemainingLifeBoundary=15&highRemainingLifeBoundary=85
Request body
| Attributes | Required / Optional | Type | Description | ||
|---|---|---|---|---|---|
| uuids | Optional | Array of strings | Returns statistics for SSDs in one or more specific servers, specified by UUIDs separated by a comma If not specified, statistics are returned for SSDs in all managed servers. | ||
The following example returns remaining-life statistics for two managed servers.
{
"uuids": ["FBEF740B178F4EFAA846E7225EE256DC", "B1B549049DE811E00005000500050005"]
}
Response codes
| Code | Description | Comments |
|---|---|---|
| 200 | OK | The request completed successfully. |
| 400 | Bad Request | A query parameter or request attribute is missing or not valid, or the operation is not supported. 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
| Attributes | Type | Description | ||
|---|---|---|---|---|
| highRemainingLife | Integer | Number of SSDs for which the remaining life is greater than the highRemainingLifeBoundary | ||
| lowRemainingLife | Integer | Number of SSDs for which the remaining life is less than or equal to the lowRemainingLifeBoundary | ||
| midRemainingLife | Integer | Number of SSDs for which the remaining life is between the lowRemainingLifeBoundary and highRemainingLifeBoundary | ||
| unknownRemainingLife | Integer | Number of SSDs for which the remaining life is unknown Note XCC cannot retrieve the SSD remaining life for onboard SATA drives. | ||
The following example is returned if the request is successful.
{
"highRemainingLife": 180,
"lowRemainingLife": 1,
"midRemainingLife": 20,
"unknownRemainingLife": 0
}
Give documentation feedback