Spectra Logic

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}/[&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
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>
   <Id>{string}</Id>
   <PoolPartitionId>{string}</PoolPartitionId>
   <State>NORMAL</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.
Id	The UUID for the storage domain member.
PoolPartitionId	The UUID for the pool partition.
StorageDomainId	The UUID for the storage domain assigned the tape partition member.
State	The state of the tape partition member. Values: § NORMAL — The storage domain member is included normally.
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>
   <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>