Import Pools

PUT http[s]://{datapathDNSname}/_rest_/pool?operation=IMPORT[&data_policy_id={string}][&priority=URGENT|HIGH|NORMAL|LOW|BACKGROUND][&storage_domain_id={string}][&user_id={string}][&verify_data_after_import=CRITICAL|URGENT|HIGH|NORMAL|LOW|BACKGROUND][&verify_data_prior_to_import=TRUE|FALSE]

Parameter	Description	Required
operation	The operation to perform. For this request, the operation is import. Value: IMPORT	yes
data_policy_id	The UUID, name, or other unique attribute for the data policy to associate with any buckets on the pool that do not already exist on the BlackPearl system. Note: If there are new buckets on the pool, the data_policy_id is 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
storage_domain_id	The UUID, name, or other unique attribute for the storage domain to associate with the data on the pool. Note: If there are new buckets on the pool and this parameter is not specified, the BlackPearl system attempts to determine the most logical storage domain in which to add the pool.	no
user_id	The UUID, name, or other unique attribute for the user to associate with any buckets on the pool that do not already exist on the BlackPearl system. Note: If there are new buckets on the pool, the user_id is required.	no
verify_data_after_ import	The priority for verifying the data after import. This determines the resources assigned and the processing order. Values: URGENT, HIGH, NORMAL, LOW	no
verify_data_before_import	Whether the data must be verified before the pool is imported. Values: TRUE, FALSE Note: It is recommended to verify data prior to import whenever it is possible that the pool being imported contains objects with the same name as objects already in the bucket. Without verifying data prior to import, it is possible for the existing object to be replaced with the one being imported, even if the one being imported is partially corrupt and cannot be read.	no

Parameter

Description

Required

operation

The operation to perform. For this request, the operation is import. Value: IMPORT

yes

data_policy_id

The UUID, name, or other unique attribute for the data policy to associate with any buckets on the pool that do not already exist on the BlackPearl system.

Note: If there are new buckets on the pool, the data_policy_id is required.

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

storage_domain_id

The UUID, name, or other unique attribute for the storage domain to associate with the data on the pool.

Note: If there are new buckets on the pool and this parameter is not specified, the BlackPearl system attempts to determine the most logical storage domain in which to add the pool.

user_id

The UUID, name, or other unique attribute for the user to associate with any buckets on the pool that do not already exist on the BlackPearl system.

Note: If there are new buckets on the pool, the user_id is required.

verify_data_after_ import

The priority for verifying the data after import. This determines the resources assigned and the processing order.
Values: URGENT, HIGH, NORMAL, LOW

verify_data_before_import

Whether the data must be verified before the pool is imported. Values: TRUE, FALSE

Note: It is recommended to verify data prior to import whenever it is possible that the pool being imported contains objects with the same name as objects already in the bucket. Without verifying data prior to import, it is possible for the existing object to be replaced with the one being imported, even if the one being imported is partially corrupt and cannot be read.

PUT http://blackpearl-hostname/_rest_/pool?operation=IMPORT&data_policy_id=dp1&user_id=user1 HTTP/1.1