Spectra Logic

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

Get Blobs on Amazon S3 Target

Description

Get the object pieces on the specified Amazon S3 target.

Requests

Syntax

GET http[s]://{datapathDNSname}/_rest_/s3_target/{Amazon S3 target instance UUID, name, or other unique attribute} ?operation=GET_PHYSICAL_PLACEMENT/

To determine the UUID for an Amazon S3 target, see Get Amazon S3 Targets.

Request Parameters

Parameter	Description	Required
operation	The operation to perform on the Amazon S3 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 Amazon S3 target.

GET http://blackpearl-hostname/_rest_/s3_target/7a50b0f1-f78d-49a8-bd15-898bdd02a756?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>