Spectra Logic

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

Create Azure Data Replication Rule

Description

Create an Azure data replication rule for a data policy. An Azure data replication rule targets a specified Microsoft Azure cloud platform.

You cannot specify the same Azure target multiple times in different replication rules applied to the same data policy. You can reference the same Azure target across different data policies.

You must create the data policy and register the Azure target before creating the replication rule. See Create Data Policy and Register DS3 Target.

Requests

Syntax

POST http[s]://{datapathDNSname}/_rest_/azure_data_replication_rule?data_policy_id={string}
&target_id={string}&type=PERMANENT [&max_blob_part_size_in_bytes={64-bit integer}][&replicate_deletes=TRUE|FALSE]

Request Parameters 

Parameter	Description	Required
data_policy_id	Data policy name, UUID, or other unique attribute.	yes
target_id	Azure target name, UUID, or other unique attribute.	yes
type	The type of replication rule to create. Value: PERMANENT Note: Replication rules can be modified to have a type of RETIRED, but cannot be created as RETIRED.	yes
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

Responses

Response Elements

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

     {64-bit integer}
   </MaxBlobPartSizeInBytes>

   <ReplicateDeletes>TRUE|FALSE</ReplicateDeletes>
   <State>NORMAL</State>

   <TargetId>{string}</TargetId>
   <Type>PERMANENT</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 Azure data replication rule.
Max Blob Size In Bytes	The maximum blob size used when creating bulk PUT jobs. Default: 100 GB
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.
TargetId	The UUID for the Azure target.
Type	The type of replication rule. Values: PERMANENT

Example

Sample Request

This request creates a permanent Azure data replication rule for the data policy named “datapolicy1” for the Azure target with the name “azuretarget1”.

POST http://blackpearl-hostname/_rest_/azure_data_replication_rule​?data_policy_id=datapolicy1&target_id=azuretarget1&type=PERMANENT HTTP/1.1

Sample Response

HTTP/1.1 200 OK

<Data>

   <DataPolicyId>

     5d6fc2b5-169f-4863-8d7f-14e93dec01ec

   </DataPolicyId>

   <Id>dcba2d02-4f2c-4c9a-9b72-9c92fb9da36f</Id>

   <MaxBlobPartSizeInBytes>

     b1c814cc-71e4-55fb-c7da-142c52b644b1
   </MaxBlobPartSizeInBytes>

   <ReplicateDeletes>TRUE</ReplicateDeletes>
   <State>NORMAL</State>

   <TargetId>a0d900bc-60d3-45ec-b6de-023d61a517c0</TargetId>

   <Type>PERMANENT</Type>

</Data>