Spectra Logic

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

Get Storage Domains

Description

Get information about all storage domains. Use parameters as selection criteria to return a subset of the list.

Requests

Syntax

GET http[s]://{datapathDNSname}/_rest_/storage_domain/[?auto_eject_upon_cron={string}] [&auto_eject_upon_job_cancellation=TRUE|FALSE] [&auto_eject_upon_job_completion=TRUE|FALSE] [&auto_eject_upon_media_full=TRUE|FALSE][&last_page] [&media_ejection_allowed=TRUE|FALSE][&name={string}] [&page_length={32-bit integer}][&page_offset={32-bit integer}] [&page_start_marker={string}] [&write_optimization=CAPACITY|PERFOMRANCE]

Request Parameters 

Parameter	Description	Required
auto_eject_upon_ cron	A CRON expression to indicate when to auto eject media.	no
auto_eject_upon_ job_cancellation	Whether all media assigned to the storage domain, not already pending ejection, is queued for ejection whenever a job is canceled. Values: TRUE, FALSE (default)	no
auto_eject_upon_ job_completion	Whether all media assigned to the storage domain, not already pending ejection, is queued for ejection whenever a job completes. Values: TRUE, FALSE (default)	no
auto_eject_upon_media_full	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 (default)	no
last_page	If included, only the last page of results is returned.	no
name	The name for the storage domain.	no
media_ejection_ allowed	Whether the storage domain or a piece of media assigned to the storage domain, can be ejected from the gateway without generating a failure. Values: TRUE (default), FALSE	no
page_length	The maximum number of storage domains to list. Default: all items after page_offset.	no
page_offset	The starting point for the first storage domain to list. Default: 0.	no
page_start_marker	The UUID or other unique attribute for the item just before the first item to list. Notes:   § Specifying both page_offset and page _start_marker causes an error. § If neither page_offset, nor page_start_marker are specified, the page_offset default is used.	no
write_optimization	Whether job chunks are written as quickly as possible or across as few pieces of media as possible. For example, when PERFORMANCE mode is set for a tape partition, job chunks are written as quickly as possible, using all tape drive resources, even if that means that more tapes are allocated to the bucket than are necessary to write the data. Values: CAPACITY (default), PERFORMANCE	no

Responses

Response Elements

<Data>
   <StorageDomain>
      <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>
   </StorageDomain>
   ...
</Data>

where the response elements are defined as follows:

Parameter	Description
Data	The container for the response.
StorageDomain	The container for information about one storage domain.
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 all storage domains on the gateway.

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

Sample Response

HTTP/1.1 200 OK
<Data>
   <StorageDomain>
      <AutoEjectUponCron/>
      <AutoEjectUponJobCancellation>
         FALSE
      </AutoEjectUponJobCancellation>
      <AutoEjectUponJobCompletion>
         FALSE
      </AutoEjectUponJobCompletion>
      <AutoEjectUponMediaFull>FALSE</AutoEjectUponMediaFull>
      <Id>b5ef719c-a455-4527-a7b6-6a4780c3f67f</Id>
      <LtfsFileNaming>OBJECT_ID</LtfsFileNaming>
      <MaxTapeFragmentationPercent>
          65
      </MaxTapeFragmentationPercent>
      <MaximumAutoVerificationFrequencyInDays>
         365
      </MaximumAutoVerificationFrequencyInDays>
      <MediaEjectionAllowed>TRUE</MediaEjectionAllowed>
      <Name>sd1</Name>
      </VerifyPriorToAutoEject>
      <WriteOptimization>CAPACITY</WriteOptimization>
   </StorageDomain>
   ...
</Data>