Spectra Logic

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

Import Amazon S3 Target

Description

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

Requests

Syntax

PUT http[s]://{datapathDNSname}/_rest_/s3_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 Amazon S3 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 Amazon S3 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 “Accounting” from the specified Amazon S3 target.

PUT http://blackpearl-hostname/_rest_/azure_target/
dd9505ed-ca71-43c0-8715-e3a4699244d6?operation=IMPORT
&cloudBucketName=Accounting HTTP/1.1

 

Sample Response

HTTP/1.1 204 No Content