Spectra Logic

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

Get Blobs on DS3 Target

Description

Get the object pieces on the specified DS3 target.

Requests

Syntax

GET http[s]://{datapathDNSname}/_rest_/ds3_target​/{DS3 target read preference UUID or other unique attribute} ?operation=GET_PHYSICAL_PLACEMENT

To determine the UUID for the DS3 target read preference, see Get DS3 Target Read Preferences.

Request Parameters

Parameter	Description	Required
operation	The operation to perform on the DS3 target. For this command, the operation is Get_Physical_Placement.	yes

Responses

Response Elements

<Data>
   <Object Bucket="{string}" Id="{string}" 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	The container for the response.
Object	The container for the information about one object..
Bucket	The name of the bucket containing the object.
Id	The UUID for the object.
Latest	Whether or not the object is the latest version of the file. Values: TRUE, FALSE
Length	The length in bytes of the of object.
Name	The the name of the object.
Offset	The the object in bytes from the start of the object.
Version	The version number of the object.

Example

Sample Request

This request gets a list of all blobs on the DS3 target.

GET http://blackpearl-hostname/_rest_/ds3_target/c927287a-90eb-428e-88ae-faedc3749e17?operation=GET_PHYSICAL_PLACEMENT HTTP/1.1

Sample Response

<Data>
   <Object Bucket="default_bucket_name" Id="1c4fc33b-f997-43f8-   bdb9-9bb5e748c7b8" Latest="TRUE" Length="10" Name="obj1"    Offset="0" Version="1"/>
   <Object Bucket="default_bucket_name" Id="46d7d57d-f4ae-4406-   bb1b-a850b9a22ecc" Latest="TRUE" Length="10" Name="obj2"    Offset="0" Version="1"/>
</Data>