Get Single Standalone Tape Drive

Product version: 10.11

Last modified: 31 July 2024

Gets info of a single standalone tape drive 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": "TapeDriveManagement",
            "method": "getDrive",
            "data": [1],
            "type": "rpc",
            "tid": 1}'

Request Fields

Field	Type	Value(s)
`action`	string	`TapeDriveManagement`
`method`	string	`getDrive`
`data`	array	ID of the standalone tape drive
`type`	string	`rpc`
`tid`	int	`1`

Response Sample

curl

Copy

{
    "action": "TapeDriveManagement",
    "method": "getDrive",
    "tid": "1",
    "type": "rpc",
    "message": null,
    "where": null,
    "cause": null,
    "data": {
        "id": 1,
        "name": "st2",
        "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",
        "drive": {
            "uuid": "17453fce-e58d-4ed1-a926-65b8ff171002",
            "path": "stdrive_2",
            "deviceName": "stdrive_2",
            "scsiAddress": null,
            "serialNumber": null,
            "discovered": false,
            "checked": false
                 },
        "lockReasons": null
            }
}

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	Standalone tape drive info. See the table below

data

Field	Type	Description
`id`	int	Standalone tape drive ID. For the `create` method, this field is ignored
`name`	string	Standalone tape drive 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 standalone tape drive
`locationName`	string	Name of the location of a standalone tape drive. Default value: "`My office`"
`mediaPoolId`	int	ID of the media pool of standalone tape drive
`offlineLocationId`	int	ID of the location for tapes ejected from this standalone tape drive
`offlineLocationName`	string	Name of the location for tapes ejected from this standalone tape drive
`compression`	string	Compression level of the tape device. Possible values: `DISABLED, HARDWARE_BASED,SOFTWARE_BASED_FAST, SOFTWARE_BASED_MEDIUM, SOFTWARE_BASED_BEST`
`lockReasons`	array	Lock reasons
`uuid`	string	The standalone tape drive UUID
`deviceName`	string	The standalone tape drive name
`discovered`	boolean
`checked`	boolean
`path`	string	Path of the standalone tape drive
`scsiAddress`	string	SCSI address
`serialNumber`	string	The standalone tape drive serial number