Spectra Logic

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

Import Foreign Tapes

Description

Imports all tapes in the library associated with a different BlackPearl gateway. If one or more buckets being imported does not already exist, the user ID and data policy to use for any new buckets must be specified. The storage domain to use may optionally be specified. If not specified, the gateway will attempt to automatically determine the most logical storage domain in which to add the tape.

Requests

Syntax

PUT http[s]://{datapathDNSname}/_rest_/tape/?operation=IMPORT[&conflict_resolution_mode=ACCEPT_EXISTING| ACCEPT_IMPORT|ACCEPT_HIGHEST_VERSION|ACCEPT_MOST_RECENT|CANCEL] [&data_policy_id={string}][&storage_domain_id={string}] [&user_id={string}]

Request Parameters

Parameter	Description	Required
operation	The operation to perform. For this request, the operation is import. Value: IMPORT	yes
conflict_resolution_mode	How the data path backend handles object name conflicts. Values: § ACCEPT_EXISTING — Keep the file currently in the BlackPearl database. § ACCEPT_IMPORT — Keep the file currently being imported. § ACCEPT_HIGHEST_VERSION — Keep the file with the highest version number. § 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 any buckets on the tape that do not already exist on the gateway. Note: If there are new buckets on the tape, the data_policy_id is required.	no
storage_domain_id	The UUID, name, or other unique attribute for the storage domain to associate with the data on the tape. Note: If this parameter is not specified, the gateway attempts to determine the most logical storage domain in which to add the tape. If the tape could be imported into multiple storage domains, the import fails, unless the storage domain id is provided.	no
user_id	The UUID, name, or other unique attribute for the user to associate with any buckets on the tape that do not already exist on the gateway. Note: If there are new buckets on the tape, the user_id is required.	no

Responses

Response Elements

The operation returns status only.

Notable status codes:

§	204: No Content (success)

§	207: Multi-Status (with list of errors)

Example

Sample Request

This request queues all unformatted tapes to be formatted.

PUT http://blackpearl-hostname/_rest_/tape/?operation=IMPORT
HTTP/1.1

Sample Response

HTTP/1.1 204 No Content