Get Single Tape Cartridge
Gets a tape cartridge 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 --request POST \
--url https://<Director_IP_address>:4443/c/router \
--header "content-type: application/json" \
--cookie @cookies.txt \
--data "{
"action": "TapeCartridgeManagement",
"method": "getCartridge",
"data": [6],
"type": "rpc",
"tid": 1
}
Request Fields
Field
|
Type
|
Value(s)
|
---|---|---|
action
|
string |
|
method
|
string |
|
data
|
array |
ID of the tape cartridge |
type
|
string | rpc
|
tid
|
integer | 1
|
Response Sample
{
"action": "TapeCartridgeManagement",
"method": "getCartridge",
"tid": "1",
"type": "rpc",
"message": null,
"where": null,
"cause": null,
"data": {
"uuid": null,
"vid": "TAPE_CARTRIDGE-6",
"name": "DRI01",
"barcode": "DRI01",
"label": null,
"contents": "EMPTY",
"status": "ONLINE",
"state": "AVAILABLE",
"stateInfo": "OK",
"type": "RW",
"protectedDate": null,
"retiredDate": null,
"markedAsFreeDate": null,
"markedAsCleaningDate": null,
"overWritable": null,
"lastWritten": null,
"numberOfBackups": 0,
"numberOfSavePoints": 0,
"deviceId": 3,
"deviceName": "HP-Compag-5000",
"deviceType": "TAPE_LIBRARY",
"deviceCustomName": "VTl",
"containerIndex": 4,
"containerType": "NORMAL_SLOT",
"attachedDevice": true,
"locationId": 1,
"locationName": "My office",
"mediaPoolId": -1,
"mediaPoolName": "",
"lockedShared": false,
"lockedExclusive": false,
"lockReasons": [],
"lockDeviceReasons": [],
"moveFromContainerType": null,
"moveFromContainerIndex": null,
"moveToContainerType": null,
"moveToContainerIndex": 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 |
Cartridge parameters. See the table below |
data
Field |
Type |
Description |
---|---|---|
|
boolean |
Checks if the tape device is attached |
|
string |
Barcode of the tape cartridge |
|
int |
Number of slots or drives. Only for tape library |
|
string |
Type of the tape library containing the tape cartridge. Possible values: |
|
string |
Tape cartridge contents. Possible values: |
|
string |
Tape device name |
|
long |
Tape device ID |
|
string |
Tape device type. Possible values: |
|
string |
Tape cartridge label |
|
DateTime |
Date of the last write operation |
|
int |
Location ID of the tape device |
|
string |
Location name of the tape device |
|
array |
Lock device reasons |
|
array |
Lock reasons |
|
boolean |
|
|
boolean |
|
|
DateTime |
Date that the tape was marked as a cleaning tape |
|
DateTime |
Date that the tape was marked as a free tape |
|
int |
Media pool ID of the tape device |
|
string |
Media pool name of the tape device |
|
int |
Index of the container the tape cartridge to be moved from |
|
string |
The type of the container the tape cartridge to be moved from. Possible values: |
|
int |
Index of the to container the tape cartridge to be moved to |
|
string |
Type of the container the tape cartridge to be moved to. Possible values: |
|
string |
Tape cartridge name |
|
long |
Number of backups on the tape cartridge |
|
long |
Number of savepoints on the tape cartridge |
|
DateTime |
Date when all recovery points on the tape will expire |
|
DateTime |
Date when the tape was protected |
|
DateTime |
Date when he tape was retired |
|
string |
Tape cartridge state. Possible values: |
|
string |
Tape cartridge state info. Possible values : |
|
string |
Tape cartridge status. Possible values: |
|
string |
Tape cartridge type. Possible values : |
|
string |
Tape cartridge UUID |
|
string |
Tape cartridge VID |