Summary of changes in the REST API for v3.0
Lenovo XClarity Administrator v3.0 supports enhancements to the Open REST API.
This documentation includes new methods and parameters that apply to the current XClarity Administrator release and later. If you are using an earlier release of XClarity Administrator, you can use the REST API Reference PDF for a list of methods and parameters that apply to that specific release. To find PDFs for the release that you need, see PDF files.
The following methods were added or updated in this release.
Inventory resources
- GET /nodes and GET /nodes/{uuid_list}.Added the ProcessorIntelSpeedSelect response attribute to return the Intel processor speed setting.
- POST /nodes. Added the collectSMARTData request attribute to collect SMART data for all managed ThinkAgile and ThinkSystem servers.
- (New) GET /nodes/globalConfigSettings. Retrieves the global configuration settings.
- (New) PUT /nodes/globalConfigSettings. Modifies global configuration settings.
- (New) GET /nodes/SMARTData. Retrieves the most recent SMART data that was collected for all managed servers.
- (New) POST /nodes/SMARTData. Collects SMART data for all manage ThinkAgile and ThinkSystem servers.
Job resources
- POST /tasks/schedules. Added the options, restBody, restMethod, restURL, and type request attributes under triggerAction to specify a custom action.
Monitoring and event resources
- (New) GET /events/acknowledgeAlerts. Retrieves a list of active alerts that were acknowledged.
- (New) PUT /events/acknowledgeAlerts. Acknowledges an active alert.
- (New) DELETE /events/acknowledgeAlerts. Removes the acknowledge status for an active alert.
- GET /events/activeAlerts. The type query parameter supports the
acknowledge
value to return data about acknowledged active alerts. - GET /events/activeAlerts/{uuid}. The type query parameter supports the
acknowledge
value to return data about acknowledged active alerts. - GET /events/monitors and GET /events/monitors/{monitor_id}. Added the forwardHidden response parameter to return whether hidden events are forwarded.
- POST /events/monitors. Added the forwardHidden requests parameter to modify whether hidden events are forwarded.
- PUT /events/monitors/{forwarder_id}. Added the forwardHidden requests parameter to modify whether hidden events are forwarded.
Server-configuration resources
- Added the 403 response code (Forbidden) to indicate that advanced functions (including OS deployment) are disabled because the number of each managed server exceeds the number of active licenses.
Firmware update resources
- PUT /updateRepositories/firmware. Added the
refreshThenAcquire
value to the action query parameter to retrieve information about latest available firmware updates from the Lenovo XClarity Support website, and download the updates that are not already downloaded. - PUT /updateRepositories/firmware/uxsps. Added the
refreshThenAcquire
value to the action query parameter to retrieve information about latest available UXSPs from the Lenovo XClarity Support website, and download the UXSPs that are not already downloaded.
- PUT /updateRepositories/firmware. Added the
Operating-system deployment resources
- Added the 403 response code (Forbidden) to indicate that advanced functions (including OS deployment) are disabled because the number of each managed server exceeds the number of active licenses.
- GET /osdeployment/globalSettings. Removed the licenseKeys. win2012r1 response attribute. You can no longer deploy Windows 2012 R1.
- PUT /osdeployment/globalSettings. Removed the licenseKeys. win2012r1 request attribute. You can no longer deploy Windows 2012 R1.
Metrics resources
- (New) POST /metrics_service/metrics. Collects missing metrics data during a specific range of time.
Give documentation feedback