Spectra Logic

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

Modify Data Persistence Rule

Description

Modify a data persistence rule for a data policy.

Notes:

§	If a retired persistence rule is modified to temporary, and the data policy is already applied to a bucket, the data in the bucket is not necessarily copied to the specified storage domain even if there is existing data within the rule's retention period.

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

Requests

Syntax

PUT http[s]://{datapathDNSname}/_rest_/data_persistence_rule/{data persistence rule UUID or other unique}/[?isolation_level= STANDARD|BUCKET_ISOLATED|SECURE_BUCKET_ISOLATED] [&minimum_days_to_retain={32-bit integer}] [&type=PERMANENT|TEMPORARY|RETIRED]

Request Parameters 

Parameter	Description	Required
isolation_level	The level of physical isolation required for the data retention. The STANDARD isolation level provides the best capacity utilization and overall performance. Note: The isolation mode can be reduced at any time but cannot be increased from STANDARD to BUCKET_ISOLATED or SECURE_BUCKET_ISOLATED after a bucket is created, unless the data policy is not in use by any buckets. Values: STANDARD, BUCKET_ISOLATED, SECURE_BUCKET_ISOLATED. See isolation_level for descriptions.	no
minimum_days_to_retain	The minimum number of days the data should be retained based on a TEMPORARY persistence rule. Note: The minimum_days_to_retain for a persistence rule targeting a storage domain with a NEARLINE pool (ArcticBlue) storage domain member must be 90 days or greater.	required if type is being changed to TEMPORARY
type	The type of persistence rule. Notes:   § The TEMPORARY value is not allowed for a persistence rule targeting a storage domain with a tape partition member. § A data persistence rule with type PERMANENT cannot be modified to type RETIRED or TEMPORARY if it is the last PERMANENT persistence rule for an in use storage domain. Values: PERMANENT, RETIRED, TEMPORARY. See Type for descriptions.	no

Responses

Response Elements

<Data>
   <DataPolicyId>{string}</DataPolicyId>
   <Id>{string}</Id>
   <IsolationLevel>
      STANDARD|BUCKET_ISOLATED|SECURE_BUCKET_ISOLATED
   </IsolationLevel>
   <MinimumDaysToRetain>{32-bit integer}</MinimumDaysToRetain>
   <State>NORMAL</State>
   <StorageDomainId>{string}</StorageDomainId>
   <Type>PERMANENT|TEMPORARY|RETIRED</Type>
</Data>

where the response elements are defined as follows:

Parameter	Description
Data	The container for the response.
DataPolicyId	The UUID for the data policy.
Id	The UUID for the persistence rule.
IsolationLevel	The level of physical isolation required for the data retention. Values: STANDARD, BUCKET_ISOLATED, SECURE_BUCKET_ISOLATED See isolation_level for descriptions.
MinimumDaysTo Retain	The minimum number of days the data should be retained based on a TEMPORARY persistence rule.
State	The state of the persistence rule. Values: NORMAL — The persistence rule is in a normal, included state.
StorageDomainId	The UUID for the storage domain.
Type	The type of persistence rule. Values: PERMANENT, TEMPORARY, RETIRED See Type for descriptions.

Example

Sample Request

This request modifies a persistence rule to use standard isolation.

PUT http[s]://blackpearl-hostname/_rest_/data_persistence_rule/d8716fda-c2e5-44c6-8bea-713bb147e5e0/?isolation_level=STANDARD HTTP/1.1

Sample Response

HTTP/1.1 201 OK
<Data>
   <DataPolicyId>
      044854c9-7557-4136-a374-dddf7c29e370
   </DataPolicyId>
   <Id>d8716fda-c2e5-44c6-8bea-713bb147e5e0</Id>
   <IsolationLevel>STANDARD</IsolationLevel>
   <MinimumDaysToRetain/>
   <State>NORMAL</State>
   <StorageDomainId>
      8ed43978-846a-44c9-8e14-f34179e33a33
   </StorageDomainId>
   <Type>PERMANENT</Type>
</Data>