Spectra Logic

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

Modify Bucket - Spectra S3

Description

Modify the owner or data policy for a bucket.

Note:

The data policy for a bucket can be changed to another data policy provided that all of the criteria below are met:

§	The checksum type of the new data policy is the same as the old

§	All persistence rules in the old data policy must have a State of NORMAL. They cannot be in the State INCLUSION_IN_PROGRESS

§	All persistence rules in the new data policy must have a State of NORMAL. They cannot be in the State INCLUSION_IN_PROGRESS

§	The sets of storage domains targeted by permanent, temporary, and retired persistence rules are each identical between the new and old data policies

§	The isolation levels match identically for each storage domain targeted

§	The versioning policy of the new data policy is the same as the old

Note:

If an optional request parameter is not included, the previous setting is retained.

Requests

Syntax

PUT http[s]://{datapathDNSname}/_rest_/bucket/{bucket_name}​[?data_policy_id={string}][&user_id={string}]

Request Parameters 

Parameter	Description	Required
data_policy_id	The UUID, name, or other unique attribute for the data policy.	no
user_id	The UUID, username, or other unique identifier for the bucket owner.	no

Responses

Response Elements

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

   <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.
Name	The name of the bucket.
UserId	The UUID for the bucket owner.

Example

Sample Request

This request modifies “bucket1” to use the data policy with the name “DP2”:

PUT http://blackpearl-hostname/_rest_/bucket/bucket1​?data_policy_id=DP2 HTTP/1.1

Sample Response

HTTP/1.1 200 OK
<Data>
   <CreationDate>2015-07-22 14:22:50.53</CreationDate>
   <DataPolicyId>
      edc234bc-5acd-4de2-a158-2a166ad607e8
   </DataPolicyId>
   <Id>173de2f9-a6b5-4b88-ba0e-2fd925aa1e4c</Id>
   <LastPreferredChunkSizeInBytes/>
   <Name>bucket1</Name>
   <UserId>47e1051f-0536-42e7-a3b8-4e4acfe19ace</UserId>
</Data>