POST /files/managementServer/data

Use this POST method to import a Lenovo XClarity Administrator backup.

To import a backup, complete the following steps.

  1. Import the backup using POST /files/managementServer/data?action=import. You must specify the passphrase to import the file.

  2. Validate the backup and make it available for later use using POST /files/managementServer/data?action=process.

Note: This API requires Lenovo XClarity Administrator v2.1.0 or later.

Authentication

Authentication with user name and password is required.

Request URL

POST https://<management_server_IP>/files/managementServer/data

Query parameters

Attributes Required / Optional Description
action Required Action to take. This can be one of the following values.
  • import. Upload a backup package to the XClarity Administrator repository.

  • process. Validate the backup package for integrity and compatibility, and prepare the backup for later use.

The following example imports the backup to the XClarity Administrator.
POST https:// 192.0.2.0/files/managementServer/data?action=import
The following example validates and prepares the backup file.
POST https:// 192.0.2.0/files/managementServer/data?action=process

Request body

The request body differs depending on the value of the action query parameter.
action=import
Use the "multipart/form-data" media type to import the backup package. Use the attributes in the following table as the multipart name in the body. For more information about the multipart/form-data media type, see Returning Values from Forms: multipart/form-data webpage.
Attributes Required / Optional Type Description
filename Required String Name of the backup file to import

For example:

HTTP Header
Content-Type: multipart/form-data; boundary=AaB03x

Request body

--AaB03x
   Content-Disposition: form-data; name=" uploadedfile"; 
                        filename=" LXCA_backup_Jul20.tar"
   Content-Type: application/x-tar 
--AaB03x--
action=process
Specify a JSON object with the following attribute.
Attributes Required / Optional Type Description
passphrase Required String Package passphrase that was specified by the user

For example:

{
   "passphrase": "xxxxxxxxxx"
}

Response codes

Code Description
200 OK
201 Created. The file was validated successfully.
400 Bad Request
401 Unauthorized
500 Internal server error

Response body

Attributes Type Description
result String Results of the request. This can be one of the following values.
  • success. The request completed successfully.
  • failed. The request failed. A descriptive error message was returned.
  • warning. The request completed with a warning. A descriptive error message was returned.
messages Array of objects Information about one or more messages
  id String Message identifier of a returned message
  text String Message text associated with the message identifier
  explanation String Additional information to clarify the reason for the message
  recovery Array of objects Recovery information
    text String User actions that can be taken to recover from the event
    URL String Link to the help system for more information, if available

Response example

{
   "result": "success",
   "message": []
}