Skip to main content

PUT /warranty

Use this method to refresh the warranty information on the management server.

Authentication​

Authentication with username and password is required.

Request URL​

PUT https://{management_server_IP}/warranty

Query parameters​

None

Request body​

AttributesRequired / OptionalTypeDescription
​refreshRequiredStringType of refresh to perform. This can be one of the following values.
  • normal. Updates the warranty information based on the managed devices.
  • total. Updates the warranty information just like the normal refresh and attempts to rerun all the previously failed requests to the Lenovo warranty service.
groupUUIDOptionalArray of stringsRefreshes warranty information for one or more resource groups, specified by UUID
The following example refreshes the warranty information for two groups.
{
   "groupUUID": ["AAAAAAAAAAAAAAAAAAAAAAAA","BBBBBBBBBBBBBBBBBBBBBBBB"],
   "​refresh": "normal"
}

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.
500Internal Server ErrorAn internal error occurred. A descriptive error message is returned in the response body.

Response body​

AttributesTypeDescription
​childrenArray of objectsWarranty information for each component in this device
deviceName​StringDevice name
​deviceTypeStringComponent type. This can be one of the following values.
  • Chassis
  • Edge Server. ThinkSystem SE server
  • IBM Tape. IBM tape library
  • Lenovo ThinkServer
  • Lenovo Storage
  • Rackswitch
  • Rack-Tower Server. ThinkSystem SD, ThinkSystem SR, or ThinkSystem ST, System x, Converged, or NeXtScale server
​endDateStringWarranty end date
groupNameStringName of the resource groups to which the device belongs. If the archive does not belong to a resource group, the value is Not Available.
groupUUIDStringUUID of the resource groups to which the device belongs
​idStringUUID of this object
​serialNumberStringDevice serial-number
Note
For RackSwitch devices, this is the entitled serial number.
​startDateString​Wwarranty start date
​statusString​Warranty status. This can be one of the following values.

  • active

  • expired

  • NA. Not applicable

warrantyType​StringWarranty type. This can be one of the following values.

  • 3PL

  • 3XL

  • MS12

  • NA. Not applicable

The following example is returned if the request is successful.
{
   "​children": [],
   "deviceName​": "Chassis_1",
   "​deviceType": "Chassis",
   "​endDate": "",
   "groupName": ["Not Available"],
   "groupUUID": [],
   "​id": "00DD973D1C2CE511B19E3C18A000F4F0",
   "​serialNumber": "23FBX24",
   "​startDate": "",
   "​status": "Expired",
   "warrantyType​": ""
}