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


Hardware Operations : Tape Library and Component Operations : Cancel Eject of Tape

Cancel Eject of Tape
Description
Cancels a pending tape eject on the specified tape. If the eject is in process, it cannot be canceled.
Requests
Syntax
PUT http[s]://{datapathDNSname}/_rest_/tape/{tape UUID or barcode}?operation=CANCEL_EJECT
To determine the UUID for a tape, see Get Tapes.
Request Parameters
Responses
Response Elements
<Data>
   <AssignedToStorageDomain>TRUE|FALSE</AssignedToStorageDomain>
   <AvailableRawCapacity>{
64‑bit integer}</AvailableRawCapacity>
   <BarCode>{string}</BarCode>
   <BucketId>{string}</BucketId>
   <DescriptionForIdentification>
      {string}
   </DescriptionForIdentification>
   <EjectDate>{YYYY-MM-DDThh:mm:ss.xxxZ}</EjectDate>
   <EjectLabel>{string}</EjectLabel>
   <EjectLocation>{string}</EjectLocation>
   <EjectPending>{YYYY-MM-DDThh:mm:ss.xxxZ}</EjectPending>
   <FullOfData>TRUE|FALSE</FullOfData>
   <Id>{string}</Id>
   <LastAccessed>{YYYY-MM-DDThh:mm:ss.xxxZ}</LastAccessed>
   <LastCheckpoint>{string}</LastCheckpoint>
   <LastModified>{YYYY-MM-DDThh:mm:ss.xxxZ}</LastModified>
   <LastVerified>{YYYY-MM-DDThh:mm:ss.xxxZ}</LastVerified>
   <PartiallyVerifiedEndOfTape>
      {
YYYY-MM-DDThh:mm:ss.xxxZ}
   </PartiallyVerifiedEndOfTape>
   <PartitionId>{string}</PartitionId>
   <PreviousState>
      NORMAL|BAD|BAR_CODE_MISSING|DATA_CHECKPOINT_MISSING|
      EJECT_FROM_EE_PENDING|EJECT_TO_EE_IN_PROGRESS|EJECTED|
      FOREIGN|FORMAT_IN_PROGRESS|FORMAT_PENDING|
      IMPORT_IN_PROGRESS|INCOMPATIBLE|INSPECTION_PENDING|LOST|
      LTFS_WITH_FOREIGN_DATA|OFFLINE|ONLINE_IN_PROGRESS|
      ONLINE_PENDING|SERIAL_NUMBER_MISMATCH|UNKNOWN
   </PreviousState>
   <SerialNumber>{string}</SerialNumber>
   <State>
      NORMAL|BAD|BAR_CODE_MISSING|DATA_CHECKPOINT_MISSING|
      EJECT_FROM_EE_PENDING|EJECT_TO_EE_IN_PROGRESS|EJECTED|
      FOREIGN|FORMAT_IN_PROGRESS|FORMAT_PENDING|
      IMPORT_IN_PROGRESS|INCOMPATIBLE|INSPECTION_PENDING|LOST|
      LTFS_WITH_FOREIGN_DATA|OFFLINE|ONLINE_IN_PROGRESS|
      ONLINE_PENDING|SERIAL_NUMBER_MISMATCH|UNKNOWN
   </State>
   <StorageDomainId>{string}</StorageDomainId>
   <TakeOwnershipPending>TRUE|FALSE</TakeOwnershipPending>
   <TotalRawCapacity>{64‑bit integer}</TotalRawCapacity>
   <Type>
      LTO5|LTO6|LTO7|LTO8|LTOM8|LTO_CLEANING_TAPE|TS_JC|TS_JD|
      TS_JK|TS_JL|TS_JY|TS_JZ|TS_CLEANING_TAPE|UNKNOWN|FORBIDDEN
   </Type>
   <VerifyPending>
      CRITICAL|URGENT|HIGH|NORMAL|LOW|BACKGROUND
   </VerifyPending>
   <WriteProtected>TRUE|FALSE</WriteProtected>
</Data>
where the response elements are defined as follows:
The date and time that the BlackPearl system discovered that the tape was ejected, in the format YYYY-MM-DDThh:mm:ss.xxxZ. If the parameter is empty, the tape has not been ejected.
The date and time that the tape was put in the queue to be ejected in the format YYYY-MM-DDThh:mm:ss.xxxZ. If the parameter is empty, the tape has not been queued for eject or the eject is no longer cancelable.
§
NORMAL — The tape is ready for use.
§
BAD — The tape has been identified as bad due to I/O errors or too many write cycles.
§
BAR_CODE_MISSING — The barcode for the tape is unknown or missing.
§
DATA_CHECKPOINT_FAILURE — The tape should have data on it that is recognizable to the BlackPearl system, but the system could not verify that the data on the tape is at the correct checkpoint or there was an error rolling back to a checkpoint.
§
DATA_CHECKPOINT_FAILURE_DUE_TO_READ_ONLY — The tape should have data on it that is recognizable to the BlackPearl system, but the system could not verify that the data on the tape is at the correct checkpoint or there was an error rolling back to a checkpoint because the tape is read only.
§
DATA_CHECKPOINT_MISSING — The tape should have data on it that is recognizable to the BlackPearl system, but the checkpoint containing the data could not be found on the tape.
§
EJECT_FROM_EE_PENDING — The tape is in the Entry/Exit (E/E) pool waiting to be physically ejected.
§
EJECT_TO_EE_IN_PROGRESS — The tape is currently being moved to the E/E pool.
§
EJECTED — The tape was ejected from the system and is not physically present.
§
FOREIGN — A tape from another BlackPearl system. This data must be copied into a bucket on this system before it is accessible.
§
FORMAT_IN_PROGRESS — The tape is currently being formatted.
§
FORMAT_PENDING — A format was requested for the tape but has not yet started.
§
IMPORT_IN_PROGRESS — A FOREIGN tape is in the process of being imported into a bucket.
§
INCOMPATIBLE — The tape type is not supported by the BlackPearl system.
§
INSPECTION_PENDING — The tape has not yet been inspected.
§
LOST — The tape was removed from the tape library without first exporting it from a bucket.
§
LTFS_WITH_FOREIGN_DATA — An LTFS formatted tape not associated with a BlackPearl system. This data must be copied into a bucket on this system before it is accessible.
§
OFFLINE — The tape is in the E/E pool and requires user confirmation to move it to the storage pool and make it online.
§
ONLINE_IN_PROGRESS — The tape is in the process of being moved from the E/E pool to the storage pool. When complete, its state will change to INSPECTION_PENDING.
§
ONLINE_PENDING — The tape was OFFLINE and received user confirmation to bring it online, but this action has not yet begun.
§
SERIAL_NUMBER_MISMATCH — The tape serial number does not match the one stored in the BlackPearl system.
§
UNKNOWN — The tape contains unknown data or is otherwise unavailable to the BlackPearl system.
§
TRUE — The foreign tape was imported when WriteProtected was TRUE, preventing the tape from being claimed by the current system.
§
FALSE — The tape was imported successfully.
The tape format and generation of the tape cartridge.
Values:
LTO5, LTO6, LTO7, LTO8, LTOM8, LTO_CLEANING_TAPE, TS_JC, TS_JY, TS_JK, TS_JD, TS_JZ, TS_JL, TS_CLEANING_TAPE, UNKNOWN, FORBIDDEN
Example
Sample Request
This request cancels the pending tape eject of the tape with the UUID 1c3fe1dc-95b7-4152-a286-951d0af2a27e.
PUT http://blackpearl-hostname/_rest_/tape/1c3fe1dc-95b7-4152-a286-951d0af2a27e?operation=CANCEL_EJECT HTTP/1.1
Sample Response
<Data>
   <AssignedToStorageDomain>FALSE</AssignedToStorageDomain>
   <AvailableRawCapacity>2408088338432</AvailableRawCapacity>
   <BarCode>018675L6</BarCode>
   <BucketId>0acaac0a-55f9-4d6b-b410-4179d4696f37</BucketId>
   <DescriptionForIdentification/>
   <EjectDate/>
   <EjectLabel/>
   <EjectLocation/>
   <EjectPending/>
   <FullOfData>FALSE</FullOfData>
   <Id>1c3fe1dc-95b7-4152-a286-951d0af2a27e</Id>
   <LastAccessed/>
   <LastCheckpoint/>
   <LastModified/>
   <LastVerified/>
   <PartiallyVerifiedEndOfTape/>
   <PartitionId>bd91171d-7738-4aea-b319-7abce892a7b1</PartitionId>
   <PreviousState/>
   <SerialNumber>HP-AE1WRUY90E</SerialNumber>
   <State>INSPECTION_PENDING</State>
   <StorageDomainId/>
   <TakeOwnershipPending>FALSE</TakeOwnershipPending>
   <TotalRawCapacity>2408088338432</TotalRawCapacity>
   <Type>LTO6</Type>
   <VerifyPending/>
   <WriteProtected>FALSE</WriteProtected>
</Data>