Page tree

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
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
actionstring

BackupManagement

The action that is invoked

methodstring

create

The method that is invoked

dataarray

Data of a tape drive to be created

typestringrpc

Type of communication protocol

tidint1

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 valuesDISABLED, 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

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

Response Fields

Field
Value
Description
messagestringMessage if the request failed
wherestringReference to the method where the problem occurred
causestringCause of failure

data

long

ID of the standalone tape drive, which is created

  • No labels