Spectra Logic

1-800-833-1132 : 1-303-449-6400

Get Tape Drive

Description

Get information about the specified tape drive.

Requests

Syntax

GET http[s]://{datapathDNSname}/_rest_/tape_drive/{tape_drive_id}/

To determine the UUID for a tape drive, see Get Tape Drives.

Responses

Response Elements

<Data>
   <ErrorMessage>{string}</ErrorMessage>
   <ForceTapeRemoval>TRUE|FALSE</ForceTapeRemoval>
   <Id>{string}</Id>
   <LastCleaned>{YYYY-MM-DDThh:mm:ss.xxxZ}</LastCleaned>
   <PartitionId>{string}</PartitionId>
   <SerialNumber>{string}</SerialNumber>
   <State>NORMAL|ERROR</State>
   <TapeId>{string}</TapeId>
   <Type>LTO5|LTO6|LTO7|TS1140|TS1150|UNKNOWN</Type>
</Data>

where the response elements are defined as follows:

Parameter	Description
Data	A container for the response.
Error Message	A description of any current error, if applicable.
ForceTapeRemoval
ID	The UUID for the tape drive.
LastCleaned	The last date and time the tape drive was cleaned in the format YYYY-MM-DDThh:mm:ss.xxxZ.
PartitionId	The UUID for the partition to which the drive belongs.
SerialNumber	The manufacturer-assigned serial number for the tape drive.
State	The status of the tape drive. Values: NORMAL, ERROR
TapeId	The UUID for the tape in the tape drive, if present.
Type	The tape format and generation of the tape drive. Values: LTO5, LTO6, LTO7, TS1140, TS1150, UNKNOWN

Example

Sample Request

This request retrieves information about the tape drive with the UUID the tape with the UUID e2b1c2f8-85be-4350-8882-2a2e1cd8ca0e.

GET http://blackpearl-hostname/_rest_/tape_drive/e2b1c2f8-85be-4350-8882-2a2e1cd8ca0e/ HTTP/1.1

Sample Response

HTTP/1.1 200 OK
<Data>
   <ErrorMessage/>
   <ForceTapeRemoval>FALSE</ForceTapeRemoval>
   <Id>e2b1c2f8-85be-4350-8882-2a2e1cd8ca0e</Id>
   <LastCleaned/>
   <PartitionId>720270ee-9d79-46d2-833b-6150724593a3</PartitionId>
   <SerialNumber>68001883</SerialNumber>
   <State>NORMAL</State>
   <TapeId>bbaf65f9-69fe-4212-97fe-47466fe39f61</TapeId>
   <Type>LTO5</Type>
</Data>