GET /nodes/<UUID>/mediaMount

Use this GET method to retrieve information about all discovered media.

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

Information about all discovered media is not included in node inventory using GET /nodes/<UUID_list>.

Authentication

Authentication with user name and password is required.

Request URL

GET https://<management_server_IP>/nodes/<UUID>/mediaMount

where <UUID> is the UUID of a ThinkServer server. To obtain the node UUID, use the GET /nodes method.

Query parameters

None

Request body

None

Response codes

Code Description
200 OK
400 Bad request
403 Forbidden. The server was prevented from fulfilling the request.
404 Not found. The requested resource could not be found.
500 Internal server error. An unexpected condition was encountered that prevented the request from succeeding.

Response body

Table 1. ThinkServer servers
Attributes Type Description
mediaLocation String Location of the media that is mounted to the ThinkServer server, if the media is mounted
mediaServerAddress String IP address of the server on which media is located
mediaState String Indicates whether the media is mounted. This can be one of the following values.
  • mount

  • unmount

mediaType String Media type. This can be one of the following values.
  • CD/DVD. CD drive

  • FD. Flash drive

  • HD. Disk drive

mountMediaEnabled String Indicates whether the mounted media is enabled. This can be one of the following values.
  • true. The mounted media is enabled.

  • false. The mounted media is disabled.

Table 2. All servers other than ThinkServer
Attributes Type Description
memberCount Integer (Servers other than ThinkServer only) Number of media members
members Array of objects (Servers other than ThinkServer only) Information about each media member
  domainName String (Samba only) Domain of the user name to access the file path
  filePath String File path of the map image
  options String (Samba and NFS only) The mount options to map the image of the file path
  shareType String Map type of the image. This can be one of the following values.
  • ftp

  • http

  • https

  • nfs

  • samba

  • sftp

  UID String Unique ID of the media member
  username String (Samba, NFS, HTTP, HTTPS, FTP, and SFTP only) User name that is used to access the file path

Response example

The following example is returned for a ThinkServer server if the request is successful.
{
   "mediaLocation": "/path/to/someiso.iso",
   "mediaServerAddress": "10.243.5.21",
   "mediaState": "mount",
   "mediaType": "HD"
   "mountMediaEnabled": "true",
}
The following example is returned for a System x server if the request is successful.
{
   "memberCount": 2,
   "members": [{
      "domainName": "10.243.8.196",
      "filePath": "https://10.243.8.196/path/to/some.iso",
      "options": "ro",
      "shareType": "NFS",
      "UID": "28F0114D78",
      "username": "JOE"
   },
   {
      "domainName": "10.243.5.166",
      "filePath": "sftp://10.243.5.166/path/to/some.iso",
      "options": "ro",
      "shareType": "SFTP",
      "UID": "BB7CDCB184",
      "username": "JOE"
   }]
}