Move cartridge to slot

Creates a work item to move a cartridge to a specified slot or a slot that is chosen by the library.

Request syntax

POST /v1/workItems {"type": "moveToSlot", "cartridge": <volser>,"sourceInternalAddress": <internalAddress>,"destinationLocation": <location>}
Moves a cartridge to a slot chosen by the library.

Request body parameters

type (string, required): The type of work item that is being created. In this case, moveToSlot .

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 front tier of a slot where the cartridge is to be moved. If not specified, the library automatically selects a slot.
For TS4500, the command fails if the cartridge that is to be moved is not in the tier 0 or tier1. For Diamondback, the command fails if the cartridge that is to be moved is not in the tier 0. If the cartridge that is to be moved is in a drive, the command fails.

Example

Move a cartridge by VOLSER to a slot chosen by the library.



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

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

Response attribute description

ID (number): This is always 0. To monitor cartridge movement, poll the cartridge that is being moved and wait for the location attribute to change.