Spectra Logic

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

Get Bucket - Spectra S3

Description

Shows information about the specified bucket, such as logical used capacity and data policy.

Requests

Syntax

GET http[s]://{datapathDNSname}/_rest_/bucket/{bucket UUID, name, or other unique attribute}

To determine the UUID for a bucket, see Get Buckets - Spectra S3.

Responses

Response Elements

<Data>
   <CreationDate>{YYYY-MM-DDThh:mm:ss.xxxZ}</CreationDate>
   <DataPolicyId>{string}</DataPolicyId>
   <Id>{string}</Id>
   <LastPreferredChunkSizeInBytes>
      {64‑bit integer}
   </LastPreferredChunkSizeInBytes>
   <LogicalUsedCapacity>{64‑bit integer}</LogicalUsedCapacity>
   <Name>{string}</Name>
   <UserId>{string}</UserId>
</Data>

where the response elements are defined as follows:

Parameter	Description
Data	The container for the response.
CreationDate	The date and time the bucket was created in the format YYYY-MM-DDThh:mm:ss.xxxZ
DataPolicyId	The UUID for the assigned data policy.
Id	The UUID for the bucket.
LastPreferred ChunkSizeInBytes	The last preferred chunk size computed for a PUT job for this bucket.
LogicalUsed Capacity	The logical capacity used in bytes.
Name	The name of the bucket.
UserId	The UUID for the bucket owner.

Example

Sample Request

This request gets the bucket capacity summary and default settings for “bucket1”.

GET http://blackpearl-hostname/_rest_/bucket/bucket1 HTTP/1.1

Sample Response

HTTP/1.1 200 OK
<Data>
   <CreationDate>2015-07-22T14:22:50.083Z</CreationDate>
   <DataPolicyId>
      33cfbff0-bd43-43b9-a144-8abe69328217
   </DataPolicyId>
   <Id>f00729b7-dfa6-4a18-9bf7-a0759aa7dbb3</Id>
   <LastPreferredChunkSizeInBytes/>
   <LogicalUsedCapacity>0</LogicalUsedCapacity>
   <Name>bucket1</Name>
   <UserId>22de0f70-be2e-4d9b-b28a-ac250a2a2405</UserId>
</Data>