Spectra Logic

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

Create Tape Density Directive

Description

Configure formatting tapes of a particular type at the specified density for the specified partition. The density specified is the tape drive type that the tape should be compatible with. The tape will be formatted at the highest density supported by the specified tape drive.

Note:

This request is for TS11x0 data tapes only. LTO tapes can only be written at the density that they are manufactured for, and cleaning tapes cannot be formatted.

Requests

Syntax

POST http[s]://{datapathDNSname}/_rest_/tape_density_directive​?density=TS1140|TS1150|TS1155& partition_id={string}​&tape_type=TS_JC|TS_JD|TS_JK|TS_JL|TS_JY|TS_JZ

Request Parameters

Parameter	Description	Required
density	The tape drive type that the density should be formatted to match. Values: TS1140, TS1150, TS1155	yes
partition_id	The UUID or other unique attribute for the partition.	yes
tape_type	The tape format and generation of the tape cartridge. Values: TS_JC, TS_JD, TS_JK, TS_JL, TS_JY, TS_JZ	yes

Responses

Response Elements

<Data>
   <Density>TS1140|TS1150|TS1155</Density>
   <Id>{string}</Id>
   <PartitionId>{string}</PartitionId>

   <TapeType>
      TS_JC|TS_JD|TS_JK|TS_JL|TS_JY|TS_JZ|UNKNOWN|FORBIDDEN
   </TapeType>
</Data>

where the response elements are defined as follows:

Parameter	Description
Data	A container for the response.
Density	The tape drive type that the density was formatted to match. Values: TS1140, TS1150, TS1155, UNKNOWN
Id	The UUID for the tape density directive.
TapeType	The tape format and generation of the tape cartridge. Values: TS_JC, TS_JD, TS_JK, TS_JL, TS_JY, TS_JZ, UNKNOWN, FORBIDDEN

Example

Sample Request

This request configures 3592 JK tapes used in the partition with UUID f8a7cdb9-3436-484a-9404-212045106738 to be formatted with the density used by TS1140 technology drives.

POST http://blackpearl-hostname/_rest_/tape_density_directive​?density=TS1140&partition_id=f8a7cdb9-3436-484a-9404-212045106738​&tape_type=TS_JK HTTP/1.1

Sample Response

HTTP/1.1 200 OK
<Data>
   <Density>TS1140</Density>
   <Id>78e4234f-8f3d-42d3-9ae1-817e89d993bc</Id>
   <PartitionId>f8a7cdb9-3436-484a-9404-212045106738</PartitionId>
   <TapeType>TS_JK</TapeType>
</Data>