Get logical libraries

Edit online

Retrieves information about the logical libraries that are partitioned in the library.

Request syntax

GET /v1/logicalLibraries
Retrieves information about the logical libraries that are partitioned in the library.

GET /v1/logicalLibraries/{name}
Retrieves information about the logical library with the specified name.

Path parameters

name (string)

The unique name of the logical library in the library.

Example

> GET /v1/logicalLibraries
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1903
[
  {
    "name": "myLib1",
    "mediaType": "LTO",
    "drives": 2,
    "virtualSlots": 730,
    "virtualIOSlots": 255,   
    "cartridges": 84,
    "encryptionMethod": "libraryManagedBarcode",
 }, {
     . . .
 }
]

Attributes

name (string)

The unique name of the logical library in the library.

mediaType (string)

The cartridge media type supported by the logical library. One of LTO or 3592.

drives (number)

The number of drives that are assigned to this logical library. These drives are reported to the host application software for this logical library as data transfer element (drive) addresses.

virtualSlots (number)

The number of virtual storage slots in the logical library reported to the host application software as storage element (storage slot) addresses. For TS4500, this value cannot be less than the number of data cartridges that are assigned to this logical library or greater than the totalCapacity of the library, which is the default. For Diamondback, this value is not modifiable.

virtualIOSlots (number)

The number of virtual I/O slots in the logical library reported to the host application software as import/export element (I/O slot) addresses. For TS4500, this value cannot be less than the number of physical I/O slots. For example, if the library has two I/O magazines, each with 18 slots, this value must be at least 36. This value defaults to 255 and cannot exceed it. For Diamondback, this value is not modifiable.

cartridges (number)

The number of cartridges that are assigned to the logical library.

encryptionMethod (string)

The encryption method currently enabled for this logical library. One of none, systemManaged, applicationManaged, libraryManagedBarcode, libraryManagedInternalLabelSelective (TS4500 only), or libraryManagedInternalLabelAll (TS4500 only).