Spectra Logic

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

Get Physical Placement for Object Parts on Tape

Description

Get the list of object parts on the specified tape.

Requests

Syntax

GET http[s]://{datapathDNSname}/_rest_/tape/{tape UUID or barcode}/?operation=GET_PHYSICAL_PLACEMENT

Request Parameters

Parameter	Description	Required
operation	The operation to perform. For this request, the operation is to get physical placement. Value: GET_PHYSICAL_PLACEMENT	yes

Responses

Response Elements

<Data>
   <Object Latest="TRUE|FALSE" Length="{64-bit integer}"
      Name="{string}"Offset="{64-bit integer}"
      Version="{64-bit integer}">
   ...
</Data>

where the response elements are defined as follows:

Parameter	Description
Data	A container for the response.
Object	The container for information about one object.
Latest	Whether this version of the object is the latest. Values: TRUE, FALSE
Length	The length in bytes of the object.
Name	The name of the object.
Offset	The offset in bytes from the start of the object.
Version	The version number of the object.

Example

Sample Request

This request returns a list of all object parts on the tape with the UUID 5e6d27f7-7261-4ad9-a2f3-c89791c1f7ff'.

GET http://blackpearl-hostname/_rest_/tape/5e6d27f7-7261-4ad9-a2f3-c89791c1f7ff/?operation=GET_PHYSICAL_PLACEMENT HTTP/1.1

Sample Response

HTTP/1.1 200 OK
<Data>
   <Object Latest="TRUE" Length="10" Name="o1" Offset="0"
      Version="1"/>
   <Object Latest="TRUE" Length="10" Name="o2" Offset="0"
      Version="1"/>
</Data>