Get slot information

Request syntax
Path parameters
cURL example
Attribute summary
Attribute descriptions

Request syntax

GET /v1/slots
Retrieves information about all storage slots in the tape library. Default sorting is by location in numerical order based on Frame, Column, and then Row in order.

GET /v1/slots/<location>
Retrieves information about the storage slot in the specified location.

Path parameters

location: The string location of the slot in the library, not including the tier. For example, “slot_F3C4R8”.

cURL example

> GET /v1/slots
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1903

[
    {
      "location": "slot_F2C3R13",
      "state": "normal",
      "contents": ["AAA000L8", null, null, null, null],
      "puts": 4572,
      “putRetries”: 10,
      “getRetries”: 0,
      "tiers": 5
    }, {
         .	.	.
    }
]

Attribute summary

Name	Schema
`location`	String (location)
`state`	String
`contents`	Array of Strings (volsers)
`puts`	Integer
`putRetries`	Integer
`getRetries`	Integer
`tiers`	Integer

Attribute descriptions

location: The string location of the slot in the library, not including the tier. For example, “slot_F3C4R8”.

state

The current state of the slot. The state of a slot includes the following values.

State	Description
`inServiceMode`	The slot is manually placed in service mode. However, it cannot be selected as a cartridge destination, cartridges can be moved from the slot.
`normal`	The slot is ready for use.

contents: An array of strings that shows the VOLSERs of the cartridges that are contained in the slot. The values are listed in order of lowest numbered tier to highest numbered tier. Any empty tier is listed as null. Note that this is reported as a single-item array for a tier 0 (single-deep, door-side) slot.

puts: An integer that shows the number of times a gripper has put a cartridge into this slot. This includes all put actions, including shuffle and unshuffle moves.

putRetries: An integer that shows the number of times a retry was required while a gripper was putting a cartridge into this slot.

getRetries: An integer that shows the number of times a retry was required while a gripper was getting a cartridge from this slot.
tiers: An integer that represents the number of tiers within the slot.