Get Single Tape Library

Gets info of a single tape library by its ID.

Endpoint

https://<Director_IP_address>:4443/c/router

Tenant Endpoint

For tenants of the multi-tenant product the endpoint must be:
https://<Director_IP_address>:4443/t/<tenant_UUID>/c/router

Request Example

Copy 
curl --request POST \
     --url https://<Director_IP_address>:4443/c/router \
     --header "content-type: application/json" \
     --cookie @cookies.txt \
     --data "{
              "action": "TapeLibraryManagement",
             "method": "getLibrary",
             "data": [3],
             "type": "rpc",
             "tid": 1
             }"

Request Fields

Field
Type
Value(s)
action string

TapeLibraryManagement

method string

getLibrary

data array

ID of the tape library
type string rpc
tid int 1

Response Sample

Copy 
{
    "action": "TapeLibraryManagement",
    "method": "getLibrary",
    "tid": "1",
    "type": "rpc",
    "message": null,
    "where": null,
    "cause": null,
    "data": {
        "id": 3,
        "name": "VTl",
        "transporterId": 1,
        "transporterName": "1.1.1.1",
        "compression": "HARDWARE_BASED",
        "blockSize": 262144,
        "locationId": 1,
        "locationName": "My office",
        "mediaPoolId": null,
        "mediaPoolName": null,
        "offlineLocationId": 1,
        "offlineLocationName": "My office",
        "changer": {
            "id": 1,
            "deviceName": "HP-Compag-5000",
            "scsiAddress": "1:1:1:1",
            "serialNumber": "qMB3XTGEZdaRjfMT",
            "path": "library_2",
            "uuid": "67453fce-e58d-4ed1-a926-65b8ff16202",
            "drives": [
                {
                    "id": 1,
                    "uuid": "10453fce-e58d-4ed1-a926-65b28f17001",
                    "path": "library_2_drive_0",
                    "index": 0,
                    "deviceName": null,
                    "scsiAddress": "1:1:1:2",
                    "serialNumber": "df46KWKPsayeFocu"                },
                {
                    "id": 2,
                    "uuid": "00653fce-e58d-4ed1-28hj-65b28f17555",
                    "path": "library_2_drive_1",
                    "index": 1,
                    "deviceName": null,
                    "scsiAddress": "1:1:1:2",
                    "serialNumber": "mapurxrowxb3d9dy"             }
                      ],
            "discovered": false,
            "checked": false
                   },
        "lockReasons": []
                }
}

Response Fields

Field
Value
Description
message string Message if the request failed
where string Reference to the method where the problem occurred
cause string Cause of failure

data

Json

Tape library info. See the table below

data

Field

Type

Description

compression

string

Compression level of the tape device. Possible values: DISABLED, HARDWARE_BASED, SOFTWARE_BASED_FAST, SOFTWARE_BASED_MEDIUM, SOFTWARE_BASED_BEST

id

int

Tape library ID. For the create method, this field is ignored

name

string

Tape library name

transporterId

long

ID of the assigned Transporter

transporterName

string

Name of the assigned Transporter

blockSize

int

Block size of the current tape device. Default value: 256 KB

locationId

int

ID of the location of a tape library

locationName

string

Name of the location of the tape library. Default value: "My office"

mediaPoolId

int

ID of the media pool of tape library

mediaPoolName

string

Name of the media pool of tape library

offlineLocationId

int

ID of the location for tapes ejected from this tape library

offlineLocationName

string

Name of the location for tapes ejected from this tape library

changer



id

long

Changer ID

deviceName

string

Tape device name

scsiAddress

string

SCSI address

serialNumber

string

Changer serial number

path

string

Path of the changer

uuid

string

Changer UUID

discovered

boolean


checked

boolean


drives



uuid

string

Tape library drive UUID

id

long

Tape library drive ID

deviceName

string

Tape library drive name

path

string

Path of the tape library drive

scsiAddress

string

SCSI address

serialNumber

string

Tape library drive serial number