Spectra Logic

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

Get Storage Domain

Description

Get information about the specified storage domain.

Requests

Syntax

GET http[s]://{datapathDNSname}/_rest_/storage_domain/{storage domain UUID, name, or other unique attribute}/

To determine the UUID for a storage domain, see Get Storage Domains.

Responses

Response Elements

<Data>
   <AutoEjectUponCron>{string}</AutoEjectUponCron>
   <AutoEjectUponJobCancellation>
      TRUE|FALSE
   </AutoEjectUponJobCancellation>
   <AutoEjectUponJobCompletion>
      TRUE|FALSE
   </AutoEjectUponJobCompletion>
   <AutoEjectUponMediaFull>
      TRUE|FALSE
   </AutoEjectUponMediaFull>
   <Id>{string}</Id>
   <LtfsFileNaming>OBJECT_ID|OBJECT_NAME</LtfsFileNaming>
   <MaxTapeFragmentationPercent>
      {32-bit integer}
   </MaxTapeFragmentationPercent>
   <MaximumAutoVerificationFrequencyInDays>
      {32-bit integer}
   </MaximumAutoVerificationFrequencyInDays>
   <MediaEjectionAllowed>
      TRUE|FALSE
   </MediaEjectionAllowed>
   <Name>{string}</Name>

   <VerifyPriorToAutoEject>
      CRITICAL|URGENT|HIGH|NORMAL|LOW|BACKGROUND
   </VerifyPriorToAutoEject>
   <WriteOptimization>CAPACITY|PERFORMANCE</WriteOptimization>
</Data>

where the response elements are defined as follows:

Parameter	Description
Data	The container for the response.
AutoEjectUpon Cron	The CRON expression that indicates when to auto eject media. If set, a CRON job is created based on the CRON string specified. Once the CRON job is executed, all media assigned to the storage domain not already pending ejection is queued for ejection.
AutoEjectUponJobCancellation	Whether all media assigned to the storage domain, not already pending ejection, is queued for ejection whenever a job is canceled. Values: TRUE, FALSE
AutoEjectUponJobCompletion	Whether all media assigned to the storage domain, not already pending ejection, is queued for ejection whenever a job completes. Values: TRUE, FALSE
AutoEjectUpon MediaFull	Whether all media assigned to the storage domain, not already pending ejection, is queued for ejection whenever the media cannot fit another 100 GB chunk. Values: TRUE, FALSE
Id	The UUID for the storage domain.
LtfsFileNaming	The LTFS file naming mode used on tapes in the storage domain. Values: OBJECT_ID, OBJECT_NAME. See ltfs_file_naming for descriptions.
MaxTape Fragmentation Percent	Not currently used.
MaximumAuto Verification FrequencyInDays	The number of days since the last verification when a piece of unchanged media is not considered for verification.
Name	The name of the storage domain.
VerifyPriorToAuto Eject	The priority for verifying tapes being ejected automatically due to any of the auto-eject triggers. The priority is null if verification is not required prior to ejection. The priority determines the resources assigned and the processing order. Values: CRITICAL, URGENT, HIGH, NORMAL, LOW, BACKGROUND
WriteOptimization	Whether job chunks are written as quickly as possible (PERFORMANCE) or across as few pieces of media as possible (CAPACITY). Values: CAPACITY, PERFORMANCE

Example

Sample Request

This request gets information about the storage domain with the name “sd1”.

GET http://blackpearl-hostname/_rest_/storage_domain/sd1 HTTP/1.1

Sample Response

HTTP/1.1 200 OK
<Data>
   <AutoEjectUponCron/>
   <AutoEjectUponJobCancellation>
      FALSE
   </AutoEjectUponJobCancellation>
   <AutoEjectUponJobCompletion>FALSE</AutoEjectUponJobCompletion>
   <AutoEjectUponMediaFull>FALSE</AutoEjectUponMediaFull>
   <Id>30313cfa-f8b2-4093-830c-3c8d06db6f6b</Id>
   <LtfsFileNaming>OBJECT_ID</LtfsFileNaming>
   <MaxTapeFragmentationPercent>65</MaxTapeFragmentationPercent>
   <MaximumAutoVerificationFrequencyInDays>
      365
   </MaximumAutoVerificationFrequencyInDays>
   <MediaEjectionAllowed>TRUE</MediaEjectionAllowed>
   <Name>sd1</Name>

   <VerifyPriorToAutoEject/>
   <WriteOptimization>CAPACITY</WriteOptimization>
</Data>