Move cartridge to I/O station

Edit online

Creates a work item to move a cartridge to the specified I/O station or the I/O station that is chosen by the library.

Request syntax

POST /v1/workItems [{"type": "moveToIOStation", "cartridge": <volser>, "sourceInternalAddress": <internalAddress>, "destinationLocation": <location>}]
Moves a cartridge to an I/O station chosen by the library.

Request body parameters

type (string, required)
The type of work item that is being created. In this case, moveToIOStation .
cartridge (string, optional)
The VOLSER of the cartridge to be moved. If duplicate VOLSERs exist for this cartridge in the library, the sourceInternalAddress must be used. If sourceInternalAddress is specified, this is not required.
sourceInternalAddress (string, optional)
The internal address of the cartridge that is to be moved. This changes if a cartridge is assigned or unassigned from a logical library or if the cartridge is moved by the host or library. Query this value before use. If cartridge is specified, this is not required.
destinationLocation (string, optional)
The location of the I/O slot in the magazine installed in the I/O station in the library where the cartridge is to be moved. If not specified, the library automatically selects an I/O slot.

For TS4500, the command fails if the cartridge that is to be moved is not in tier 0 or tier 1. For Diamondback, the command fails if the cartridge that is to be moved is not in tier 1. If the cartridge that is to be moved is in a drive, the command fails.

Example 



> POST /v1/workItems {"type": "moveToIOStation", "cartridge": "AAA000L8"}

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 10
				
{"ID": 0}

Response attribute description

ID (number)

The unique identifier of the work item created. This is always 0. To monitor cartridge movement, poll the cartridge that is being moved and wait for the location attribute to change.