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

Create Pool Storage Domain Member

Description

Adds the specified pool partition as a member of the specified storage domain.

Requests

Syntax

POST http[s]://{datapathDNSname}/_rest_/storage_domain_member​?pool_partition_id={string}&storage_domain_id={string}​[&write_preference=HIGH|NORMAL|LOW|NEVER_SELECT]

Request Parameters 

Parameter	Description	Required
pool_partition_id	Pool partition UUID, name, or other unique attribute. To determine the UUID for a pool partition, see Get Pool Partitions.	yes
storage_domain_id	Storage domain UUID, name, or other unique attribute. To determine the UUID for a storage domain, see Get Storage Domains.	yes
write_preference	Determines the preferred usage of the pool partition when additional capacity is needed. The BlackPearl system uses a partition with HIGH write_preference before a partition with a NORMAL write_preference, and so on. Use NEVER_SELECT to indicate that the partition is read-only. Values: HIGH, NORMAL (default), LOW, NEVER_SELECT	no

Responses

Response Elements

<Data>
   <AutoCompactionThreshold>
      {32-bit integer}
   </AutoCompactionThreshold>
   <Id>{string}</Id>
   <PoolPartitionId>{string}</PoolPartitionId>
   <State>NORMAL|EXCLUSION_IN_PROGRESS</State>
   <StorageDomainId>{string}</StorageDomainId>
   <TapePartitionId/>

   <TapeType/>
   <WritePreference>HIGH|NORMAL|LOW|NEVER_SELECT</WritePreference>
</Data>

where the response elements are defined as follows:

Parameter	Description
Data	The container for the response.
AutoCompaction Threshold	This does not apply for pools.
Id	The UUID for the pool storage domain member.
PoolPartitionId	The UUID for the pool partition.
State	The state of the pool partition member. Values: § NORMAL — The storage domain member is included normally. § EXCLUSION_IN_PROGRESS — The storage domain member is in the process of being excluded (data that resides on it is being copied to other storage domain members).
StorageDomainId	The UUID for the storage domain to which the pool partition member was assigned.
TapePartitionId	Always null for this operation.
TapeType	Always null for this operation.
WritePreference	The preferred usage of the pool partition when additional capacity is needed. The BlackPearl system uses a partition with HIGH write_preference before a partition with a NORMAL write_preference, and so on. A value of NEVER_SELECT indicates that the partition is read-only. Values: HIGH, NORMAL, LOW, NEVER_SELECT

Example

Sample Request

This request creates a pool storage domain member for the pool partition with the UUID a541c709-cceb-4d86-a23c-1998858ae854 in the storage domain with the UUID 9b186102-c116-496f-a6a3-fb392c0060b6.

POST http[s]://blackpearl-hostname/_rest_/storage_domain_member​?pool_partition_id=a541c709-cceb-4d86-a23c-1998858ae854​&storage_domain_id=9b186102-c116-496f-a6a3-fb392c0060b} HTTP/1.1

Sample Response

HTTP/1.1 201 CREATED
<Data>
   <Id>c2d066b1-2563-4db9-a452-f681d57110c6</Id>
   <PoolPartitionId>
      a541c709-cceb-4d86-a23c-1998858ae854
   </PoolPartitionId>
   <State>NORMAL</State>
   <StorageDomainId>
      9b186102-c116-496f-a6a3-fb392c0060b6
   </StorageDomainId>
   <TapePartitionId/>
   <TapeType/>
   <WritePreference>HIGH</WritePreference>
</Data>