Spectra Logic

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

Modify Data Persistence Rule

Description

Modify a data persistence rule for a data policy.

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

§	If the modify command does not include an optional request parameter, the persistence rules retains the previous setting.

Requests

Syntax

PUT http[s]://{datapathDNSname}/_rest_/data_persistence_rule/ {data persistence rule UUID or other unique}​[?isolation_level=STANDARD|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 level can always be reduced to STANDARD, but can never be increased to BUCKET_ISOLATED once the data policy is in use by at least one bucket. Note:   Values: STANDARD, 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</IsolationLevel>
   <MinimumDaysToRetain>{32‑bit integer}</MinimumDaysToRetain>
   <State>NORMAL|INCLSUION_IN_PROGRESS</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. 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. Value: 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 200 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>