4.4.2.1.3.8.4. Storage¶
Storage Descriptor
Name |
Type |
Description (LDAP Attribute) |
---|---|---|
string |
Storage ID (dcmStorageID) |
|
string |
RFC2079: Uniform Resource Identifier (dcmURI) |
|
boolean |
Indicates that binary DICOM objects of one Series are packed in one TAR archive on this Storage System; false if absent. (dcmArchiveSeriesAsTAR) |
|
string |
Format of file path of DICOM binary objects or metadata in JSON format or of ZIP archives containing metadata in JSON format for each DICOM object of one Series, written to this Storage System. ‘{now,date,yyyy/MM/dd}/{0020000D,hash}/{0020000E,hash}/{00080018,hash}’, if absent. (dcmStoragePathFormat) |
|
string |
Specifies behavior if an object already exists on the storage path on the storage system, assembled according to the configured ‘Storage Path Format’. Default behaviour ‘RANDOM_PATH’. Enumerated values: FAILURE (= Signals failure writing the new object) NOOP (= Proceed without writing the new object) RANDOM_PATH (= Replace last path element be random 8 hex digit number and try again) (dcmOnStoragePathAlreadyExists) |
|
integer |
Specifies number of retries to create parent directories of the storage file path - may workaround issues concerning NFS; 0 if absent. (dcmRetryCreateDirectories) |
|
boolean |
Indicate to not rely on ‘createDirectories’ function in ‘java.nio.file.Files’ Java class, to create all nonexistent parent directories first, but instead explicitly create parent directories if NoSuchFileException is thrown. May workaround issues concerning NFS. (dcmAltCreateDirectories) |
|
string |
Indicates to check if a mounted file system did not get detached from its mount point, by specifying the path of a file relative to the path of the Storage URI, which is shadowed by the mount, so its visibility signals that the mount failed. If the file becomes visible, the write operation to the storage fails, preventing to store objects on the file system of the mount point directory. (dcmCheckMountFilePath) |
|
string |
Indicates to check if the specified file on the storage file system exists. If the file becomes inaccessible, the write operation to the storage fails, preventing to store objects on the file system. (dcmCheckExistFilePath) |
|
string |
Options specifying how the file is opened for writing. Default behaviour ‘CREATE_NEW’. Enumerated values: CREATE_NEW (= Create a new file, failing if the file already exists) DSYNC (= Requires that every update to the file’s content be written synchronously to the underlying storage device) SYNC (= Requires that every update to the file’s content or metadata be written synchronously to the underlying storage device) (dcmFileOpenOption) |
|
string |
Initial Location Status of DICOM files written to this Storage System. Default behaviour ‘OK’. Enumerated values: OK (= Indicates access state of stored objects is stable) VERIFY_QSTAR_ACCESS_STATE (= Indicates to verify access state of stored objects from QStar Tape File System) (dcmLocationStatus) |
|
boolean |
Indicate to include counts of locations with status != 0 (=OK) for this Storage System by RESTful service to list Storage Systems; false if absent. (dcmCountLocationsByStatus) |
|
string |
Algorithm for generation of check sums. Enumerated values: MD5 (= Message-digest algorithm) SHA-1 (= Secure Hash Algorithm 1) (dcmDigestAlgorithm) |
|
integer |
Maximum number of retries to store an object on the storage system. (dcmMaxRetries) |
|
string |
Delay to retry to store an object on the storage system in ISO-8601 duration format PnDTnHnMn.nS. Retry immediately if absent. (dcmRetryDelay) |
|
string |
Instance Availability. Enumerated values: ONLINE NEARLINE OFFLINE (dcmInstanceAvailability) |
|
string |
Indicates the type of storage duration. Objects get purged from cache and temporary storage according configured deleter thresholds or - if no deleter threshold is specified and no Retention Periods are configured - all objects on the Storage will get purged. In the case of temporary storage, the studies whose objects were purged are also deleted from the database. Enumerated values: PERMANENT (= Permanent storage) CACHE (= Cache storage) TEMPORARY (= Temporary storage) (dcmStorageDuration) |
|
boolean |
Indicates if a Storage System is read only. (dcmReadOnly) |
|
string |
Identifies a CACHE Storage belonging to a Storage Cluster. Objects of one Study may be distributed over Storage Systems of one Storage Cluster. Used by threshold triggered deletion. (dcmStorageClusterID) |
|
string |
Minimal Usable Space on Storage System. If the usable space falls below that value the Storage System will be marked as full by setting Storage Threshold Exceeds to the current time and - if Storage Threshold Exceeds Permanently is true - the Storage System will be removed from the list of configured Storage Systems of the Network AE requesting that Storage System. Format nnn(MB|GB|MiB|GiB) (dcmStorageThreshold) |
|
string |
Date and time in format YYYYMMDDHHMMSS.FFFFFF when the Storage Threshold exceeded. (dcmStorageThresholdExceeded) |
|
boolean |
Indicates to removed the Storage System from the list of configured Storage Systems of the Network AE requesting that Storage System when the Storage Threshold exceeds. (dcmStorageThresholdExceedsPermanently) |
|
boolean |
Delete Studies from cache/temporary Storage System, if no Deleter Threshold and no other deletion constraint is configured. (dcmNoDeletionConstraint) |
|
string |
Minimal Usable Space on Storage System to trigger deletion. If present, studies are deleted from the Storage System configured for cache (Storage Duration = CACHE) or temporary (Storage Duration = TEMPORARY) storage, if the usable space fall below that value. Format [nn’[‘<schedule>’]’]nnn(MB|GB|MiB|GiB). (dcmDeleterThreshold) |
|
string |
Maximal Usable Space on Storage System to trigger deletion. If present, studies are deleted from the Storage System configured for cache (Storage Duration = CACHE) or temporary (Storage Duration = TEMPORARY) storage, if the used disk space exceeds that value. Format [nn’[‘<schedule>’]’]nnn(MB|GB|MiB|GiB). (dcmDeleterThresholdMaxUseableSpace) |
|
string |
Path of file containing the current used disk space in blocks (1024 bytes), periodically updated by an external application. (dcmDeleterThresholdBlocksFilePath) |
|
string |
Delete Studies from the Storage System configured for cache (dcmStorageDuration=CACHE) or temporary (dcmStorageDuration=TEMPORARY) storage, if their Study Date is longer ago than the specified value in ISO-8601 period format. Format [nn”[“<schedule>”]”](PnYnMnD|PnW). (dcmDeleteStudiesOlderThan) |
|
string |
Delete Studies from the Storage System configured for cache (dcmStorageDuration=CACHE) or temporary (dcmStorageDuration=TEMPORARY) storage, if they were received longer ago than the specified value in ISO-8601 period format. Format [nn”[“<schedule>”]”](PnYnMnD|PnW). (dcmDeleteStudiesReceivedBefore) |
|
string |
Delete Studies from the Storage System configured for cache (dcmStorageDuration=CACHE) or temporary (dcmStorageDuration=TEMPORARY) storage, if they were last accessed longer ago than the specified value in ISO-8601 period format. Format [nn”[“<schedule>”]”](PnYnMnD|PnW). (dcmDeleteStudiesNotUsedSince) |
|
integer |
Number of Threads used for deletion of objects from the Storage System. (dcmDeleterThreads) |
|
string |
Constrains deletion of Studies, additionally to configured deleter thresholds and/or deletion retention period constraints, from the Storage System to Studies which objects are retrievable using one of the AEs from an external C-MOVE SCP. (dcmExternalRetrieveAET) |
|
string |
Updates instance availability on deletion of studies for instances available on external retrieve archive. Enumerated values: ONLINE NEARLINE OFFLINE (dcmExternalRetrieveInstanceAvailability) |
|
string |
Constrains deletion of Studies, additionally to configured deleter thresholds and/or deletion retention period constraints, from the Storage System to Studies whose objects are also accessible from the specified other storages. (dcmExportStorageID) |
|
boolean |
Indicates that objects of one Study are NOT distributed over several Export Storages. (dcmSingleExportStorageByStudy) |
|
string |
Specifies another Storage to which objects are copied in parallel on retrieve to increase the performance on accessing storage systems which provides more bandwidth using multiple connections in parallel. (dcmRetrieveCacheStorageID) |
|
string |
Specifies AE Titles of C-STORE SCPs to which objects are retrieved without copying them to a configured Retrieve Cache Storage. (dcmNoRetrieveCacheOnDestinationAETitle) |
|
boolean |
Indicates to NOT copy retrieved objects to a configured Retrieve Cache Storage, wherein corresponding Instance Records were already purged from the DB. (dcmNoRetrieveCacheOnPurgedInstanceRecords) |
|
integer |
Maximal number of parallel copies to cache storage on retrieve. Only effective if a Retrieve Cache Storage ID is configured. (dcmRetrieveCacheMaxParallel) |
|
string |
Specify storage properties in format {name}={value}. Refer various Storage Properties that can be configured based on the storage type. (dcmProperty) |