Spectra Logic

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

Modify Tape Partition

Description

Modify the number of drives in the partition reserved for reading or writing, or set the tape partition 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_partition/{tape_partition_id}/[?minimum_read_reserved_drives=
{32-bit integer}][&minimum_write_reserved_drives={32-bit integer}][&quiesced=NO|PENDING]

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

Request Parameters

Parameter	Description	Required
minimum_read_ reserved_drives	The minimum number of drives in the partition reserved for reads.	no
minimum_write_ reserved_drives	The minimum number of drives in the partition reserved for writes.	no
quiesced	Request that the system prepare the tape partition to go into an inactive state (PENDING), or return the tape partition to an active state (NO). Values: NO, PENDING	no

Responses

Response Elements

<Data>
   <DriveType>
      LTO5|LTO6|LTO7|LTO8|TS1140|TS1150|TS1155|UNKNOWN
   </DriveType>
   <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>
</Data>

where the response elements are defined as follows:

Parameter	Description
Data	The container for the response.
DriveType	The type of drives assigned to the 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

Example

Sample Request

This request changes the tape library partition with the UUID 15c3a202-07e9-4ff9-8e4b-05dcaa55875a to quiesced=pending.

PUT http://blackpearl-hostname/_rest_/tape_partition/15c3a202-07e9-4ff9-8e4b-05dcaa55875a?quiesced=PENDING HTTP/1.1

Sample Response

HTTP/1.1 200 OK
<Data>
   <DriveType/>
   <ErrorMessage/>
   <Id>15c3a202-07e9-4ff9-8e4b-05dcaa55875a</Id>
   <ImportExportConfiguration>
      SUPPORTED
   </ImportExportConfiguration>
   <LibraryId>8cf68800-8845-4c88-84af-3278d76f0bcf</LibraryId>
   <MinimumReadReservedDrives>0</MinimumReadReservedDrives>
   <MinimumWriteReservedDrives>0</MinimumWriteReservedDrives>
   <Name>MoviePartition</Name>
   <Quiesced>PENDING</Quiesced>
   <SerialId>01000090A5000950</SerialId>
   <SerialNumber>21130090A5000950</SerialNumber>
   <State>ONLINE</State>
</Data>