Spectra Logic

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

Modify Azure Data Replication Rule

Description

Modify an Azure data replication rule for a data policy.

Note:

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

Requests

Syntax

PUT http[s]://{datapathDNSname}/_rest_/azure_data_replication_rule/{data replication rule UUID or other unique attribute}​[&max_blob_part_size_in_bytes={64-bit integer}][replicate_deletes=TRUE|FALSE][&type=PERMANENT|RETIRED]

Request Parameters 

Parameter	Description	Required
max_blob_part_ size_in_bytes	Specifies the maximum blob part size used when creating bulk PUT jobs. The maximum blob part size is 1 TB. Larger blob part sizes make public cloud workflows simpler, but may make it more difficult or impossible to reliably transmit blobs. Less reliable network connections to the public cloud require smaller blob part sizes. Values: Min: 100MB, Max: 1TB, Default: 1GB	no
replicate_deletes	Whether objects deleted from buckets are also deleted from the replication target. Values: TRUE (default) — Any delete received locally always replicates on the Azure target. If the local BlackPearl system cannot communicate with one or more targets, the delete fails. FALSE— Any deletes received locally do not replicate to the target.	no
type	The type of replication rule. Values: § PERMANENT — A copy of the data is replicated to the target. § RETIRED — A copy of already replicated data is maintained, but the rule is not applied to new data.	no

Responses

Response Elements

<Data>
   <DataPolicyId>{string}</DataPolicyId>
   <Id>{string}</Id>

   <MaxBlobPartSizeInBytes>

     {64-bit integer}
   </MaxBlobPartSizeInBytes>
   <ReplicateDeletes>TRUE|FALSE</ReplicateDeletes>
   <State>NORMAL</State>

   <TargetDataPolicy>{string}</TargetDataPolicy>

   <TargetId>{string}</TargetId>
   <Type>PERMANENT|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.
MaxBlobSizeIn Bytes	The maximum blob size used when creating bulk PUT jobs. Default: 100 GB
Id	The UUID for the DS3 replication rule.
ReplicateDeletes	Whether objects deleted from local buckets are also deleted from the replication target. Values: TRUE, FALSE
State	The state of the persistence rule. Value: NORMAL — The persistence rule is in a normal, included state.
TargetDataPolicy	The UUID for the data policy on the Blackpearl target.
TargetId	The UUID for the Blackpearl target.
Type	The type of replication rule. Values: Values: § PERMANENT — A copy of the data is replicated to the target. § RETIRED — A copy of already replicated data is maintained, but the rule is not applied to new data.

Example

Sample Request

This request retires the Azure replication rule with the UUID 34dde4ff-8603-4c44-b0e9-39150f9cc3ad.

POST http://blackpearl-hostname/_rest_/azure_data_replication_rule/34dde4ff-8603-4c44-b0e9-39150f9cc3ad?type=RETIRED HTTP/1.1

Sample Response

HTTP/1.1 200 OK
<Data>
   <DataPolicyId>
      88832b42-731e-4a82-be8d-3d787117ca7d
   </DataPolicyId>

   <MaxBlobPartSizeInBytes>

     48321fc3-821f-5b73-fc3a-4a877241fb6a
   </MaxBlobPartSizeInBytes>
   <Id>34dde4ff-8603-4c44-b0e9-39150f9cc3ad</Id>
   <ReplicateDeletes>TRUE</ReplicateDeletes>
   <State>NORMAL</State>

   <TargetDataPolicy/>
   <TargetId>e4858769-57e0-4f34-a2d0-3f7ad57aa80f</TargetId>
   <Type>RETIRED</Type>
</Data>