Get slots

Retrieves information about the cartridge storage slots in the library including all the tiers within that slot.

Request syntax

GET /v1/slots
Retrieves information about all storage slots in the tape library.

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

Path parameters

location (string): The unique location of the slot.

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
    }, {
         .	.	.
    }
]

Attributes

location (string): The unique location of the slot.

state (string)

The health status of the slot. The state of a slot includes the following values.

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

contents (array of strings): An array of VOLSERs of the cartridges stored in tiers in this slot. The array is in orders of tiers. Any empty tier is listed as null.

puts (number): The number of times a cartridge is placed into the I/O station.

putRetries (number): The number of times a retry was required while placing a cartridge into this slot over the lifetime of this slot.

getRetries (number): The number of times a retry was required while getting a cartridge from this slot over the lifetime of this slot.
tiers (number): Number of tiers in the slot where each tier can hold one cartridge.