Spectra Logic

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

Get Tape Partition

Description

Get information about the specified tape partition.

Requests

Syntax

GET http[s]://{datapathDNSname}/_rest_/tape_partition/{tape_partition_id}[?full_details]

To determine the UUID for a tape partition, see Get Tape Partitions.

Request Parameters

full_details

If included, then additional information about the tape partition is included in the response.

no

Responses

Response Elements

<Data>
   <DriveType>
      LTO5|LTO6|LTO7|LTO8|TS1140|TS1150|TS1155|UNKNOWN
   </DriveType>

   <DriveTypes> (only if full_details is included)
      LTO5|LTO6|LTO7|LTO8|TS1140|TS1150|TS1155|UNKNOWN
   </DriveTypes>
   ...
   <ErrorMessage>{string}</ErrorMessage>
   <Id>{string}</Id>
   <ImportExportConfiguration>
      SUPPORTED|NOT_SUPPORTED
   </ImportExportConfiguration>
   <LibraryId>{string}</LibraryId>
   <MinimumReadReservedDrives>
      {32-bit integer}
   </MinimumReadReservedDrives>
   <MinimumWriteReservedDrives>
      {32-bit integer}
   </MinimumWriteReservedDrives>
<Name>{string}</Name>
   <Quiesced>NO|PENDING|YES</Quiesced>

   <SerialId>{string}</SerialId>
   <SerialNumber>{string}</SerialNumber>
   <State>ONLINE|OFFLINE</State>
   <TapeTypes> (only if full_details is included)
      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
   </TapeTypes>
</Data>

where the response elements are defined as follows:

Parameter	Description
Data	The container for the response.
DriveType	The drive type in the partition used by the BlackPearl system. Values: LTO5, LTO6, LTO7, LTO8, TS1140, TS1150, TS1155, UNKNOWN
DriveTypes	All drive types assigned to the partition. Only one drive type should be assigned to a partition. Values: LTO5, LTO6, LTO7, LTO8, TS1140, TS1150, TS1155, UNKNOWN
Error Message	The description of any current error.
Id	The UUID for the partition.
ImportExport Configuration	Whether the import and export configuration of the tape library is supported by the BlackPearl system. If a T50e or T120 library with multiple partitions is associated with a BlackPearl system, you cannot use the BlackPearl system to eject the tapes because of the library’s shared eject port. In this situation, see Spectra BlackPearl system User Guide for instructions for manually ejecting tapes from the BlackPearl system. Values: SUPPORTED, NOT_SUPPORTED
LibraryId	The UUID for the library.
MinimumRead ReservedDrives	The minimum number of drives in the partition reserved for reads.
MinimumWrite ReservedDrives	The minimum number of drives in the partition reserved for writes.
Name	The name of the partition.
Quiesced	Whether the partition is in a temporarily inactive state. Values: NO, PENDING, YES
SerialId	A unique representation of the library partition serial number that remains the same even if the partition exporter is replaced.
SerialNumber	The serial number of the library partition.
State	The status of the tape partition. Values: ONLINE, OFFLINE
TapeTypes	The tape format and generation of the tape cartridge. Values: 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

Example

Sample Request

This request retrieves information about the tape partition with the UUID 9434bc89-67a5-41c2-a161-098972f1dd67 using full_details.

GET http://blackpearl-hostname/_rest_/tape_partition/9434bc89-67a5-41c2-a161-098972f1dd67?full_details HTTP/1.1

Sample Response

HTTP/1.1 200 OK
<Data>
   <DriveType>TS1140</DriveTypes>
   <DriveTypes>TS1140</DriveTypes>
   <ErrorMessage/>
   <Id>9434bc89-67a5-41c2-a161-098972f1dd67</Id>
   <ImportExportConfiguration>
      SUPPORTED
   </ImportExportConfiguration>
   <LibraryId>1b71aadb-4ffc-4649-9f41-3f0cc5d01782</LibraryId>
   <MinimumReadReservedDrives>0</MinimumReadReservedDrives>
   <MinimumWriteReservedDrives>0</MinimumWriteReservedDrives>
   <Name>name-tape partition</Name>
   <Quiesced>NO</Quiesced>

   <SerialId>01000090A5000950</SerialId>
   <SerialNumber>21130090A5000950</SerialNumber>
   <State>ONLINE</State>
   <TapeTypes>LTO6</TapeTypes>
</Data>