Spectra Logic

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

Get Object - Spectra S3

Description

Get information about an object.

Requests

Syntax

GET http[s]://{datapathDNSname}/_rest_/object/{object_name}​?bucket_id={string}

Request Parameters

Parameter	Description	Required
bucket_id a	The UUID, name, or other unique attribute for a bucket.	yes

a.	Parameter values can use wild cards (see Wild Card Syntax).

Responses

Response Elements

<Data>
   <BucketId>{string}</BucketId>
   <CreationDate>{YYYY-MM-DDThh:mm:ss.xxxZ}</CreationDate>
   <Id>{string}</Id>

   <Latest>TRUE|FALSE</Latest>
   <Name>{string}</Name>
   <Type>DATA|FOLDER</Type>
   <Version>{64‑bit integer}</Version>
</Data>

where the response elements are defined as follows:

Parameter	Description
Data	The container for the response.
BucketId	The UUID for the bucket in which the object resides.
CreationDate	The date and time the bucket was created in the format YYYY-MM-DDThh:mm:ss.xxxZ.
Id	The UUID for the object.
Latest	Whether this version of the object is the latest. Values: TRUE, FALSE
Name	The name of the object.
Type	The type of object. Values: DATA, FOLDER
Version	The version number of the object.

Example

Sample Request

This request GETs information about the object with the UUID 073fe9c2-5983-4a46-9974-60804b8a6349 in the bucket with the UUID 6d17cd22-d456-4458-8cb6-b553eb81ce3f.

GET http://blackpearl-hostname/_rest_/object/073fe9c2-5983-4a46-9974-60804b8a6349?bucketId=6d17cd22-d456-4458-8cb6-b553eb81ce3f HTTP/1.1

Sample Response

HTTP/1.1 200 OK
<Data>
   <BucketId>6d17cd22-d456-4458-8cb6-b553eb81ce3f</BucketId>
   <CreationDate/>
   <Id>073fe9c2-5983-4a46-9974-60804b8a6349</Id>
   <Latest>TRUE</Latest>
   <Name>object_name</Name>
   <Type>DATA</Type>
   <Version>1</Version>
</Data>