Unmount ISO Image

The Unmount ISO Image operation unmounts the currently mounted ISO from the identified partition.

HTTP method and URI

POST /api/partitions/{partition-id}/operations/unmount-iso-image

In this request, the URI variable {partition-id} is the object ID of the targeted partition.

Description

This operation unmounts an ISO image that is associated to a partition. This operation sets the partition's boot-iso-image-name and boot-iso-ins-file properties to null.

A 404 (Not Found) status code is returned if the object-id {partition-id} does not identify a partition object to which the API user has object-access permission. If the API user does not have action permission for the Partition Details task, a 403 (Forbidden) status code is returned. If the partition is in one of the transitional states ("starting" or "stopping"), a 409 (Conflict) status code is returned. A 409 (Conflict) status code is also returned if the partition does not currently have an ISO image associated with it.

Authorization requirements

This operation has the following authorization requirements:
  • Object-access permission to the Partition object designated by {partition-id}.
  • Action/task permission to the Partition Details task.

HTTP status and reason codes

On success, HTTP status code 204 (No Content) is returned and no response body is provided.

The following HTTP status codes are returned for the indicated errors, and the response body is a standard error response body providing the reason code indicated and associated error message.

Table 1. Unmount ISO Image: HTTP status and reason codes
HTTP error status code Reason code Description
400 (Bad Request) Various Errors were detected during common request validation. See Common request validation reason codes for a list of the possible reason codes.
403 (Forbidden) 1 The API user does not have the required permission for this operation.
404 (Not Found) 1 The partition with object-id {partition-id} does not exist, or the API user does not have object-access permission to it.
409 (Conflict) 1 Partition status is not valid to perform the operation.
6 The state of the CPC hosting the partition is not valid to perform the operation (must be in one of the following states: "active", "service-required", "degraded", or "exceptions".)
10 The operation cannot be performed because the affected SE is in the process of being shut down.
118 The partition does not have any image associated with it to perform the operation.
119 The partition is currently configured to boot from the ISO image. That is, the partition's boot-device property is currently set to "iso-image".
503 (Service Unavailable) 1 The request could not be processed because the HMC is not currently communicating with an SE needed to perform the requested operation.

Additional standard status and reason codes can be returned, as described in Invoking API operations.

Example HTTP interaction

Figure 1. Unmount ISO Image: Request
POST  /api/partitions/2052747e-52ac-11e5-a8c4-42f2e9cfe851/unmount-iso-image HTTP/1.1
x-api-session: pd0nrulei0qsa1mwlpaw7cmq26rnsdcdhtp4w4m9gzse7gybg
Figure 2. Unmount ISO Image: Response
204 No Content
server: zSeries management console API web server / 2.0
cache-control: no-cache
date: Wed, 17 Feb 2016 05:30:34 GMT
<No response body>