Test drive
Starts a test drive operation by using a diagnostic cartridge. This is done to verify a drive is running correctly and should be used only for diagnostic purposes. The results of the test will be available in the library event list.
Request syntax
POST /v1/tasks
{"type": "testDrive", "location": "drive_F<f>C<c>R<r>"}
Starts a test drive operation by using a diagnostic cartridge.
This starts a long-running task in the library that is visible from the GUI.
POST /v1/tasks
{"type": "testDrive", "sn": <serial number>}
Starts a test operation
by using a diagnostic cartridge on the drive with the specified serial number. This 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,
testDrive. location(string, optional)-
The location of the tape drive to run the test on. Either
locationorsnis required.
sn(string, optional)-
The globally unique serial number of the drive. Either
locationorsnis required.
Example
> POST /v1/tasks {"type": "testDrive", "location": "drive_F2C4R2"}
HTTP/1.1 201 Created
Location: /v1/tasks/42
Content-Type: application/json
Content-Length: 10
{"ID": 42}