Use this method to mount media, unmount media that was previously mounted, or enable or disable support for mounting media on a specific ThinkServer or ThinkSystem server.
Authentication with user name and password is required.
PUT 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.
None
Attributes | Required / Optional | Type | Description | ||
---|---|---|---|---|---|
action | Required | String | (ThinkServer servers only) Enable or disabled
servers to support mounting media. Specify one of the following values.
|
{
"action": "enableMountMedia"
}
Attributes | Required / Optional | Type | Description | ||
---|---|---|---|---|---|
action | Required | String | Mounts an image that was previously mounted
when mount is specified 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/{job_list} 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.
|
||
domainName | Required if shareType is Samba | String | Domain name of the server on which media is
located If a value is not specified, the domain name is used. |
||
mediaLocation | Required | String | Full path of the media ISO | ||
mediaServerAddress | Required | String | IP address of the server on which media is located | ||
mediaType | Required | String | (ThinkServer servers only) The media type. This
can be one of the following values.
|
||
password | Required if shareType is Samba | String | Password to authenticate to the media | ||
shareType | Required | String | Share type. This can be one of the following
values.
|
||
username | Required if shareType is Samba | String | User name to authenticate to the media |
{
"action": "mount",
"domainName":"10.243.7.146",
"mediaLocation":"/path/to/someiso.iso",
"mediaServerAddress": "10.243.7.146",
"mediaType" : "HD",
"password":"password",
"shareType":"samba",
"username":"JOE"
}
{
"action": "mount",
"domainName":"10.243.7.146",
"mediaLocation":"/path/to/some.iso",
"mediaServerAddress": "10.243.7.146",
"password":"password",
"shareType":"nfs",
"username":"JOE"
}
Attributes | Required / Optional | Type | Description | ||
---|---|---|---|---|---|
action | Required | String | Unmounts an image when unmount is specified 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/{job_list} 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.
|
||
mediaType | Required | String | (ThinkServer servers only) Media type. This
can be one of the following values.
|
||
UID | Required | String | (Servers other than ThinkServer only) Unique ID of the mounted
media to be unmounted. If not specified, all mounted media of the
specified type is unmounted. To obtain the mount media ID, use the GET /tasks/{job_list} method. |
{
"action": "unmount",
"mediaType" : "CD"
}
{
"action": "unmount",
"UID" : "597BDF4270"
}
{
"action": "unmount",
}
Code | Description | Comments |
---|---|---|
200 | OK | The request completed successfully. |
400 | Bad Request | A 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. |
401 | Unauthorized | The user cannot be authenticated. Authentication has not been provided or has failed. A descriptive error message is returned in the response body. |
403 | Forbidden | The orchestrator server was prevented from fulfilling the request. A descriptive error message is returned in the response body. Ensure that you have privileges to perform the request. |
500 | Internal Server Error | An internal error occurred. A descriptive error message is returned in the response body. |
Attributes | Type | Description | |
---|---|---|---|
statusCode | Integer | The return code | |
statusDescription | String | Description of the return code. | |
messages | Array of objects | Information about one or more messages. | |
explanation | String | Additional information to clarify the reason for the message. | |
id | String | The message identifier of a returned message. | |
recovery | String | Recovery information | |
recoveryURL | String | ||
text | String | Message text associated with the message identifier. |
{
"statusCode": 403,
"statusDescription": "The request is forbidden by server.",
"messages": [{
"explanation": "The mount media request to the device has been rejected..",
"id": "FQXDM0403N",
"recovery": "Verify the request and make sure it is allowed by server."
"recoveryUrl": "",
"text": "The request is forbidden by server.",
}]
}