PUT /storage/<UUID>

Use this PUT method to modify properties or perform management actions on a specific storage devices.

Note: This API requires Lenovo XClarity Administrator v1.2.0 or later.
The request body differs depending on the action that you want to perform. You can use this PUT method to perform the following management actions.
Note: To power on or off canisters in the storage device, use PUT /storage/<UUID>/<controller>
If you specify this attribute, this method starts a job that runs in the background to perform the operation. The response header includes a URI in the form /tasks/<task_id> (for example, /tasks/12) that represents the job that is created to perform this request. You can use GET /tasks/detail to monitor the status and progress of the job. If a job was not successfully started, refer to the response code and response body for details.
Attention: A successful response indicates that the request was successfully transmitted and accepted by the management server. It does not indicate that the operation that is associated with the job was successful.

Authentication

Authentication with user name and password is required.

Request URL

PUT https://<management_server_IP>/storage/<UUID>

where <UUID> is the UUID of the storage device to be retrieved. To obtain the node UUID, use the GET /storage method.

Query parameters

Attributes Required / Optional Description
synchronous=<value> Optional When modifying attributes, indicates when the job ID is returned
  • true. (default) Returns the job ID and job status after the job is complete.

  • false. Returns the job ID immediately. You can use GET /tasks/detail to monitor the status and progress of the job.

Note: This query parameter applies only when one or more property parameters are specified in the request body.

Request body

Table 1. Modify storage properties
Attributes Required / Optional Type Description
contact Optional String The contact information
name Optional String Storage-device name
userDescription Optional String The storage-device description
Table 2. Collect and export service data
Attributes Required / Optional Type Description
sftpURI Required String Collects and exports service data to the specified Secure FTP site.
Table 3. Configure device authentication and access control.
Note: Only users with lxc-supervisor or lxc-security-admin authority can modify the access-control settings.
Attributes Required / Optional Type Description
securityDescriptor Required Object Information about the authentication enablement and support the associated stored credentials for a managed device.
  managedAuthEnabled Optional Boolean Indicates whether the device uses managed authentication. This can be one of the following values.
  • true. The device uses managed authentication.

  • false. The device uses local authentication

  publicAccess Optional Boolean Indicates whether the resource can be accessed by all role groups. This can be one of the following values.
  • true. The resource is can be access by all role group.

  • false. The resource is restricted to specific role groups.

  roleGroups Optional Array of strings List of role groups that are permitted to view and manage this device.
  storedCredentials Required if managedAuthEnabled is set to true Object Information about the stored credential that is associated with this device, if applicable.
    id Required if managedAuthEnabled is set to true String ID of the stored credential to associated with the device

Request example

The following example modifies the hostname, location, and contact information for the target storage device:
{
   "contact":"new contact",
   "name":"new name",
   "userDescription":"new userDescription"
}
The following example collects and exports an FFDC archive to sftp://SYSMGR:JhdJshf922nms@10.241.53.50.
{
   "sftpURI":"sftp://SYSMGR:JhdJshf922nms@10.241.53.50"
}
The following example restricts access to the managed device to members of the specified role groups:
{
   "securityDescriptor" : {
      "publicAccess": false,
      "roleGroups": ["sales-os-admin","corp_fw_admin"]
   }
}

Response codes

Code Description
200 OK
400 Bad request
401 Unauthorized
403 Forbidden
404 Not found
409 Conflict
500 Internal server error

Response body

None