Create Standalone Tape Drive

Product version: 10.11

Last modified: 31 July 2024

Creates a new standalone tape drive.

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

This is an example of creating a standalone tape drive in a local folder on the assigned Transporter host.

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": "create", 
            "data": [{ 
                  "id": null,
                  "blockSize": 32768,
                  "compression": "HARDWARE_BASED",
                  "locationId": 1,
                  "locationName": "",
                  "lockReasons": null,
                  "mediaPoolId": null,
                  "mediaPoolName": null,
                  "name": "Standalone_Drive_2",
                  "offlineLocationId": 1,
                  "offlineLocationName": null,
                  "text": "",
                  "transporterId": 1,
                  "transporterName": "",
                  "drive": {
                          "checked": false,
                          "deviceName": "stdrive_2",
                          "disabledCheck": false,
                          "discovered": false,
                          "icon": "",
                          "iconCls": "iconTd24 icon24_0",
                          "index": "",
                          "path": "stdrive_2",
                          "previousIndex": "",
                          "scsiAddress": "2:2:2:2",
                          "serialNumber": "TQLUmG5pEiNuE3JW",
                          "text": "",
                          "uuid": "17453fce-e58d-4ed1-a926-65b8ff171002"                           }
                    }], 
            "type": "rpc", 
            "tid": 1}'

Request Fields

Field	Type	Value(s)	Description
`action`	string	`BackupManagement`	The action that is invoked
`method`	string	`create`	The method that is invoked
`data`	array		Data of a tape drive to be created
`type`	string	`rpc`	Type of communication protocol
`tid`	int	`1`	Transaction ID. Used to identify the request by both the client and the server

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	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 standalone tape drive
`locationName`	string	Name of the location of standalone tape drive. Default value: "`My office`"
`mediaPoolId`	int	ID of the media pool of tape standalone drive
`mediaPoolName`	string	Name of the media pool
`offlineLocationId`	int	ID of the location for tape ejected from this standalone tape drive
`offlineLocationName`	string	Name of the location for tape ejected from this standalone tape drive
drive
`uuid`	string	The standalone tape drive UUID
`deviceName`	string	The standalone tape drive name
`discovered`	boolean	Used only for handling the product GUI: `true` means the standalone tape drive was added once to the product and it is cleared in the list of standalone tape drives
`checked`	boolean	Used only for handling the product GUI: `true` means the standalone tape drive is selected in the list of standalone tape drives
`path`	string	Path of the standalone tape drive
`scsiAddress`	string	SCSI address of the standalone tape drive
`serialNumber`	string	The standalone tape drive serial number

Response Sample

curl

Copy

{
    "action": "TapeDriveManagement",
    "method": "create",
    "tid": "1",
    "type": "rpc",
    "message": null,
    "where": null,
    "cause": null,
    "data": 66
}

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`	`long`	ID of the standalone tape drive, which is created