Get Single Tape Library

Product version: 10.11

Last modified: 31 July 2024

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

curl

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

curl

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