Spectra Logic

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

Import Azure Target

Description

Imports a copy of the objects in the specified bucket on the specified Azure target to the local BlackPearl system.

Requests

Syntax

PUT http[s]://{datapathDNSname}/_rest_/azure_target/
{unique identifier or attribute}?operation=import
&cloud_bucket_name={string}[&conflict_resolution_mode=
{CANCEL|ACCEPT_MOST_RECENT|ACCEPT_EXISTING}]
[&data_policy_id={unique identifier or attribute}][&priority={CRITICAL|URGENT|HIGH|NORMAL|LOW|BACKGROUND}][&user_id={unique identifier or attribute}]

Request Parameters

Parameter	Description	Required
operation	The operation to perform. For this request, the operation is import. Value: IMPORT	yes
cloud_bucket _name	The name or UUID of the bucket on the Azure target to transfer to the BlackPearl system.	yes
conflict_resolution_mode	How the BlackPearl system handles object name conflicts. Values: § ACCEPT_EXISTING — Keep the file currently in the BlackPearl database. § ACCEPT_MOST_RECENT — Keep the file with the most recent creation date. § CANCEL (default) — Cancel the import process.	no
data_policy_id	The UUID, name, or other unique attribute for the data policy to associate with objects on the Azure target that do not already exist on the BlackPearl system. Note: If a bucket with the name cloud_bucket_name, does not already exist on the BlackPearl system, then data_policy_id and user_id are required.	no
priority	The priority for processing the import. The priority determines the resources assigned and the processing order. Imports can be interrupted every 30 minutes if a job with a higher priority is received. Values: URGENT, HIGH, NORMAL, LOW	no
user_id	The UUID, name, or other unique attribute for the user to associate with any buckets on the Azure target that do not already exist on the BlackPearl system. Note: If a bucket with the name cloud_bucket_name, does not already exist on the BlackPearl system, then data_policy_id and user_id are required.	no

Responses

The operation returns status only.

Notable status codes:

§	204: No Content (success)

§	500: Internal Error

Example

Sample Request

This command imports the objects in the bucket named “Images” from the specified Azure target.

PUT http://blackpearl-hostname/_rest_/azure_target/
f30df4ae-78df-42b4-96a35d11c15e3cf9?operation=IMPORT
&cloudBucketName=Images HTTP/1.1

 

Sample Response

HTTP/1.1 204 No Content