Spectra Logic

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

Modify Tape Drive

Description

Modify whether the drive is reserved for reading or writing, or set the tape drive to unquiesced (NO), or pending quiesce (PENDING) state. The system changes the state from pending quiesce (PENDING) to quiesced (YES).

Note:

If an optional request parameter is not included, the previous setting is retained.

Requests

Syntax

PUT http[s]://{datapathDNSname}/_rest_/tape_drive/{tape_drive_id}/[?quiesced=NO|PENDING][&reserved_task_type=ANY|READ|WRITE]

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

Request Parameters

Parameter	Description	Required
quiesced	Request that the system prepare the tape drive to go into an inactive state (PENDING), or return the tape drive to an active state (NO). Values: NO, PENDING	no
reserved_task_ type	Whether the drive is reserved for reads only or writes only, or can be used for either. Values: ANY, READ, WRITE	no

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|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 Azure target 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 reactivates the tape drive with the UUID e2b1c2f8-85be-4350-8882-2a2e1cd8ca0e.

PUT http://blackpearl-hostname/_rest_/tape_drive/e2b1c2f8-85be-4350-8882-2a2e1cd8ca0e/?quiesced=NO 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>