Start service on drive
Initiates a service action on the specified drive. This puts the drive in the
inServiceMode state and is typically done at the start of a replacement
procedure.
While the drive state is inServiceMode, the drive is offline on the SCSI
interface for data path or control path commands. Any commands for mounting a data cartridge to this
drive that is coming through a different control path will be rejected.
Request syntax
POST
/v1/tasks {"type": "startDriveService", "location": "drive_F<f>C<c>R<r>"}
Initiates a service
action on the specified drive. This puts the drive in the inServiceMode state and
starts a long-running task in the library that is visible from the GUI.
POST
/v1/tasks {"type": "startDriveService", "sn": <serial number>}
Initiates a service action on the drive with the specified serial number. This puts the drive in the
inServiceMode state and starts a long-running task in the library that is visible
from the GUI.
Request body parameters
type(string, required)-
The task type to run. In this case,
startDriveService. location(string, optional)-
The location of the drive to put into service mode. Either
locationorsnis required.
sn(string, optional)-
The globally unique serial number of the drive. Either
locationorsnis required.
Example
> POST /v1/tasks {"type": "startDriveService", "location": "drive_F2C4R2"}
HTTP/1.1 201 Created
Location: /v1/tasks/42
Content-Type: application/json
Content-Length: 10
{"ID": 45}