Skip to main content

PUT /unmanageOffline

Use this method to configure settings for automatically unmanaging devices that are offline for specific amount of time.

Note

Automatic unmanagement of offline devices is supported for Flex System chassis, switches, Lenovo Flex System servers, Lenovo System x servers, ThinkAgile, and ThinkSystem servers.

Authentication​

Authentication with username and password is required.

Request URL​

PUT https://{management_server_IP}/unmanageOffline

Query parameters​

None

Request body​

ParameterRequired / OptionalTypeDescription
offlinePeriodOptionalIntegerAmount of time, in hours, that devices must be offline before they are automatically unmanaged

This value can be from 1 – 24 hours. The default is 24 hours.

unmanageOfflineRequiredBooleanIndicates whether Lenovo XClarity Administrator automatically unmanages devices that are offline for the a specific amount of time. This can be one of the following values.
  • true. Enables automatic unmanagement of offline devices.

    XClarity Administrator checks for offline devices every hour. If a device is offline for at least the amount of time specified by offlinePeriod, XClarity Administrator automatically unmanages that device.

  • false. Disables automatic unmanagement of offline devices.
The following example configure automatic unmanagement settings.
{
   "offlinePeriod": 48,
   "unmanageOffline": "true"
}

Response codes​

CodeDescriptionComments
200OKThe request completed successfully.
400Bad RequestA 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.
404Not foundA specified resource cannot be found. A descriptive error message is returned in the response body.
500Internal Server ErrorAn internal error occurred. A descriptive error message is returned in the response body.

Response body​

None