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


Hardware Operations : Tape Library and Component Operations : Get Tape Drive
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>
   <CleaningRequired>TRUE|FALSE</CleaningRequired>
   <ErrorMessage>{string}</ErrorMessage>
   <ForceTapeRemoval>TRUE|FALSE</ForceTapeRemoval>
   <Id>{string}</Id>
   <LastCleaned>{YYYY-MM-DDThh:mm:ss.xxxZ}</LastCleaned>
   <PartitionId>{string}</PartitionId>
   <Quiesced>NO|PENDING|YES</Quiesced>
   <ReservedTaskType>ANY|READ|WRITE</ReservedTaskType>
   <SerialNumber>{string}</SerialNumber>
   <State>
      ERROR|NORMAL|
      NOT_COMPATIBLE_IN_PARTITION_DUE_TO_NEWER_TAPE_DRIVES|OFFLINE
   </State>
   <TapeId>{string}</TapeId>
   <Type>
      LTO5|LTO6|LTO7|LTO8|LTOM8|TS1140|TS1150|TS1155|UNKNOWN
   </Type>
</Data>
where the response elements are defined as follows:
Parameter
Description
Data
A container for the response.
CleaningRequired
Whether the tape drive indicates that it needs to be cleaned. Values: TRUE, FALSE
Error Message
A description of any current error, if applicable.
ForceTapeRemoval
Whether the tape drive is in an error state and asking that the tape in it be forcibly removed. If required, this is performed before any other operations.
Values: TRUE, FALSE
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.
Quiesced
Whether the tape drive is in a temporarily inactive state. Values: NO, PENDING, YES
ReservedTaskType
Whether the drive is reserved for reads only or writes only, or can be used for either.
Values: ANY, READ, WRITE
SerialNumber
The manufacturer-assigned serial number for the tape drive.
State
The status of the tape drive. Values: ERROR, NORMAL, NOT_COMPATIBLE_IN_PARTITION_DUE_TO_NEWER_TAPE_DRIVES, OFFLINE
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, LTO8, TS1140, TS1150, TS1155, UNKNOWN
Example
Sample Request
This request retrieves information about the tape drive 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>
   <CleaningRequired>FALSE</CleaningRequired>
   <ErrorMessage/>
   <ForceTapeRemoval>FALSE</ForceTapeRemoval>
   <Id>e2b1c2f8-85be-4350-8882-2a2e1cd8ca0e</Id>
   <LastCleaned/>
   <PartitionId>720270ee-9d79-46d2-833b-6150724593a3</PartitionId>
   <Quiesced>NO</Quiesced>
   <ReservedTaskType>ANY</ReservedTaskType>
   <SerialNumber>68001883</SerialNumber>
   <State>NORMAL</State>
   <TapeId>bbaf65f9-69fe-4212-97fe-47466fe39f61</TapeId>
   <Type>LTO5</Type>
</Data>