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|TS1140|TS1150|UNKNOWN</DriveType>

   <DriveTypes> (only if full_details is included)
      LTO5|LTO6|LTO7|TS1140|TS1150|UNKNOWN
   </DriveTypes>
   ...
   <ErrorMessage>{string}</ErrorMessage>
   <Id>{string}</Id>
   <ImportExportConfiguration>
      SUPPORTED|NOT_SUPPORTED
   </ImportExportConfiguration>
   <LibraryId>{string}</LibraryId>
   <Name>{string}</Name>
   <Quiesced>NO|PENDING|YES</Quiesced>
   <SerialNumber>{string}</SerialNumber>
   <State>ONLINE|OFFLINE</State>
   <TapeTypes> (only if full_details is included)
      LTO5|LTO6|LTO7|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 used by the gateway. Values: LTO5, LTO6, LTO7, TS1140, TS1150, UNKNOWN
DriveTypes	All drive types assigned to the partition. Only one drive type should be assigned to a partition. Values: LTO5, LTO6, LTO7, TS1140, TS1150, 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 gateway. The gateway only supports standard eject mode for T50e and T120 libraries. Values: SUPPORTED, NOT_SUPPORTED
LibraryId	The UUID for the library.
Name	The name of the partition.
Quiesced	Whether the partition is in a temporarily inactive state. Values: YES, NO, PENDING
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, 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>
   <Name>name-tape partition</Name>
   <Quiesced>NO</Quiesced>
   <SerialNumber>tape partition</SerialNumber>
   <State>ONLINE</State>
   <TapeTypes>LTO6</TapeTypes>
</Data>