Spectra Logic

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

Create Tape Storage Domain Member

Description

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

Requests

Syntax

POST http[s]://{datapathDNSname}/_rest_/storage_domain_member​?storage_domain_id={string}&tape_partition_id={string}​&tape_type=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​[&write_preference=HIGH|NORMAL|LOW|NEVER_SELECT]

Request Parameters 

Parameter	Description	Required
storage_domain_id	Storage domain UUID, name, or other unique attribute. To determine the UUID for a storage domain, see Get Storage Domains.	yes
tape_partition_id	Tape partition UUID, name, or other unique attribute. To determine the UUID for a tape partition, see Get Tape Partitions.	yes
tape_type	The tape media type. 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	yes
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. Values: HIGH, NORMAL (default), LOW, NEVER_SELECT	no

Responses

Response Elements

<Data>
   <Id>{string}</Id>
   <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 tape storage domain member.
PoolPartitionId	Always null for this operation.
StorageDomainId	The UUID for the storage domain to which the tape partition member was assigned.
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 creates a tape storage domain member for the tape partition with the UUID 8fff1c7e-8a3e-4e00-8b16-8585b130300f, using LTO-5 tape cartridges, in the storage domain with the UUID a3f0888c-9d0c-455c-ae8c-050970c2dab9.

POST http[s]://blackpearl-hostname/_rest_/storage_domain_member​?storage_domain_id=a3f0888c-9d0c-455c-ae8c-050970c2dab9​&tape_partition_id=8fff1c7e-8a3e-4e00-8b16-8585b130300f​&tape_type=LTO5 HTTP/1.1

Sample Response

HTTP/1.1 201 CREATED
<Data>
   <Id>d9a2f5c6-19b8-4818-9b89-495190a4b0f3</Id>
   <PoolPartitionId/>
   <State>NORMAL</State>
   <StorageDomainId>
      a3f0888c-9d0c-455c-ae8c-050970c2dab9
   </StorageDomainId>
   <TapePartitionId>
      8fff1c7e-8a3e-4e00-8b16-8585b130300f
   </TapePartitionId>
   <TapeType>LTO5</TapeType>
   <WritePreference>HIGH</WritePreference>
</Data>