Modify drive use

Modifies the use of the drive to data access, control path, or verification.

  • Data access sets the drive to be used for read and write activity.

  • Control path sets the drive to be used as a point of contact for library control commands that are sent over the SCSI interface and for read and write activity.

  • Verification sets the drive to be used by the media verification feature for a logical library to verify media. Verification drives are not online to the host system.

Request syntax

PATCH /v1/drives/<location> {"use": <"access" | "controlPath" | "verification">}
Modifies the use of the drive in the specified location (data access, control path, or verification).

PATCH /v1/drives/<sn> {"use": <"access" | "controlPath" | "verification">}
Modifies the use of the drive with the specified serial number (data access, control path, or verification).

Path parameters

location (string)

The unique location of the drive.

sn (string)

The globally unique serial number of the drive.

Request body parameters

use (string, optional)

The assigned use this tape drive has been given within the logical library. Values include:

Use Description
access Data access drives
controlPath Data access and control path drives
verification Media verification drives

Example

> PATCH /v1/drives/drive_F3C2R1 {"use": "access"}
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 0