Spectra Logic

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

Modify Storage Domain

Description

Modify a storage domain.

Note:

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

Requests

Syntax

PUT http[s]://{datapathDNSname}/_rest_/storage_domain/{storage domain UUID, name, or other unique attribute}/[?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]

[&ltfs_file_naming=OBJECT_NAME|OBJECT_ID] [&max_tape_fragmentation_percent={32-bit integer}] [&maximum_auto_verification_frequency_in_days={32-bit integer}] [&media_ejection_allowed=TRUE|FALSE][&name={string}] [&verify_prior_to_auto_eject=CRITICAL|URGENT|HIGH|NORMAL|LOW| BACKGROUND][&write_optimization=CAPACITY|PERFORMANCE]

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

Request Parameters

Parameter	Description	Required
auto_eject_upon_ cron	A CRON expression to indicate when to auto eject media. If set, a CRON job will be 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. Note: This parameter is only valid if media_ejection_allowed=TRUE.	no
auto_eject_upon_ job_cancellation	Determines whether all media assigned to the storage domain, not already pending ejection, is queued for ejection whenever a job is canceled. Note: This parameter is only valid if media_ejection_allowed=TRUE. Values: TRUE, FALSE	no
auto_eject_upon_ job_completion	Determines whether all media assigned to the storage domain, not already pending ejection, is queued for ejection whenever a job completes. Note: This parameter is only valid if media_ejection_allowed=TRUE. Values: TRUE, FALSE	no
auto_eject_upon_media_full	Determines 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. Note: This parameter is only valid if media_ejection_allowed=TRUE. Values: TRUE, FALSE	no
ltfs_file_naming	Determines the LTFS file naming mode used on tapes in the storage domain. Values: § OBJECT_NAME — LTFS file names use the format {bucket name}/{object name}, for example bucket1/video1. Object names must comply with LTFS file naming rules. If the tapes are ejected from the BlackPearl gateway and loaded into a non-BlackPearl tape partition, the file names match the object names. § OBJECT_ID (default) — LTFS file names use the format {bucket name}/{object id}, for example bucket1/1fc6f09c-dd72-41ea-8043-0491ab8a6d82. Object names do not need to comply with LTFS file naming rules. The object names are saved as LTFS extended attributes.	no
max_tape_ fragmentation_ percent	Not currently used.	no
maximum_auto_ verification_ frequency_in_days	The number of days since the last verification when a piece of unchanged media is not considered for verification.	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, FALSE	no
name	The name for the storage domain.	no
verify_prior_to_ auto_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	no
write_optimization	Specifies 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. It is better to use CAPACITY mode if the tapes will be ejected after the job completes or if the bucket is written to very rarely and capacity in the library is of concern. PERFORMANCE mode is recommended in all other cases. Values: CAPACITY, PERFORMANCE	no

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 modifies the storage domain with the name “sd1” to make mediaEjectionAllowed=FALSE.

POST http://blackpearl-hostname/_rest_/storage_domain/sd1/?mediaEjectionAllowed=FALSE HTTP/1.1

Sample Response

HTTP/1.1 200 OK

<Data>
   <AutoEjectUponCron/>
   <AutoEjectUponJobCancellation>
      FALSE
   </AutoEjectUponJobCancellation>
   <AutoEjectUponJobCompletion>FALSE</AutoEjectUponJobCompletion>
   <AutoEjectUponMediaFull>FALSE</AutoEjectUponMediaFull>
   <Id>02e1db8f-db6f-4dd9-9c79-9ac1dd4aa3de</Id>
   <MaxTapeFragmentationPercent>65</MaxTapeFragmentationPercent>
   <MaximumAutoVerificationFrequencyInDays>
      365
   </MaximumAutoVerificationFrequencyInDays>
   <MediaEjectionAllowed>FALSE</MediaEjectionAllowed>
   <Name>sd1</Name>
   </VerifyPriorToAutoEject>
   <WriteOptimization>CAPACITY</WriteOptimization>
</Data>