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

Modify Storage Domain Member

Description

Modify a storage domain member.

Note:

If an optional request parameter is not included, the previous setting is retained.

Requests

Syntax

PUT http[s]://{datapathDNSname}/_rest_/storage_domain_member/{storage domain member UUID or other unique attribute}/[?auto_compaction_threshold={32-bit integer}]​[&state={NORMAL|EXCLUSION_IN_PROGRESS}]​[&write_preference=HIGH|NORMAL|LOW|NEVER_SELECT]

To determine the UUID for a storage domain member, see Get Storage Domain Members.

Request Parameters 

Parameter	Description	Required
auto_compaction_ threshold	The percentage of a tape with deleted objects at which auto compaction is triggered. The minimum is 10.	no
state	The state of the storage domain member. Values: § NORMAL — The storage domain member is included normally. § EXCLUSION_IN_PROGRESS — Start the process of excluding the storage domain member. Data that resides on it will be copied to other storage domain members.	no
write_preference	Determines the preferred usage of the tape 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. Note: The write_preference cannot be changed to NEVER_SELECT if the storage domain is in use and there are no other storage domain members assigned that have a higher write_preference. Values: HIGH, NORMAL, 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>{string}</TapePartitionId>
   <TapeType>{string}</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	The percentage of a tape with deleted objects at which auto compaction is triggered.
Id	The UUID for the storage domain member.
PoolPartitionId	The UUID for the pool partition.
State	The state of the storage domain 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 assigned the tape partition member.
TapePartitionId	The UUID for the tape partition.
TapeType	The type of tape used by this tape storage domain member. Values: LTO5, LTO6, LTO7, LTO8, LTOM8, LTO_CLEANING_TAPE, TS_JC, TS_JY, TS_JK, TS_JD, TS_JZ, TS_JL, TS_CLEANING_TAPE, UNKNOWN, FORBIDDEN
WritePreference	The preferred usage of the tape 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 modifies the pool partition storage domain membership with UUID 4d5a08b9-cf15-4f8a-a004-73f907071c86 to have write_preference=HIGH.

PUT http[s]://blackpearl-hostname/_rest_/storage_domain_member/4d5a08b9-cf15-4f8a-a004-73f907071c86?write_preference=HIGH HTTP/1.1

Sample Response

HTTP/1.1 201 CREATED
<Data>
   <AutoCompactionThreshold>20</AutoCompactionThreshold>
   <Id>4d5a08b9-cf15-4f8a-a004-73f907071c86</Id>
   <PoolPartitionId>
      c9c12aee-2029-462a-b291-1c76426b3567
   </PoolPartitionId>
   <State>NORMAL</State>
   <StorageDomainId>
      aa3078cf-7e01-4e23-854a-648d04e7ae26
   </StorageDomainId>
   <TapePartitionId/>
   <TapeType/>
   <WritePreference>HIGH</WritePreference>
</Data>