Spectra Logic

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

Get Cache Filesystem

Description

Get information about the specified cache filesystem.

Requests

Syntax

GET http[s]://{datapathDNSname}/_rest_/cache_filesystem/{Cache filesystem UUID}/

To determine the UUID for a cache filesystem, see Get Cache Filesystems.

Responses

Response Elements

<Data>
   <AutoReclaimInitiateThreshold>
      {double}
   </AutoReclaimInitiateThreshold>
   <AutoReclaimTerminateThreshold>
      {double}
   </AutoReclaimTerminateThreshold>
   <BurstThreshold>{double}</BurstThreshold>
   <Id>{string}</Id>
   <MaxCapacityInBytes>{64‑bit integer}</MaxCapacityInBytes>
   <MaxPercentUtilizationOfFilesystem>
      {double}
   </MaxPercentUtilizationOfFilesystem>
   <NodeId>{string}</NodeId>
   <Path>{string}</Path>
</Data>

Note:

double=double-precision floating point number

where the response elements are defined as follows:

Parameter	Description
Data	A container for the response.
AutoReclaim InitiateThreshold	The percentage full at which cache reclamation begins, expressed as a double-precision floating point number.
AutoReclaim Terminate Threshold	The percentage full at which cache reclamation terminates, expressed as a double-precision floating point number.
BurstThreshold	The percent utilization the cache must exceed to disable bursting, which permits the allocation of all cache resources on one job regardless of the job's priority. Having a bust threshold below 1.0 ensures that one job does not prevent resources from being available for other jobs.
Id	The UUID for the cache filesystem.
MaxCapacityIn Bytes	The maximum capacity that can be used by the cache. Note: If both MaxCapacityInBytes and MaxPercentUtilizationOfFilesystem are specified, the lesser of the two is used for the maximum cache capacity.
MaxPercent UtilizationOf Filesystem	The maximum capacity that can be used by the cache as a percentage of the total usable cache capacity. Note: If both MaxCapacityInBytes and MaxPercentUtilizationOfFilesystem are specified, the lesser of the two is used for the maximum cache capacity.
NodeId	The UUID for the for the node associated with the cache.
Path	The path to the cache filesystem on the BlackPearl system.

Example

Sample Request

This request gets information about the cache filesystem with UUID 8dfef781-a13c-4ea5-ac22-db4f7425a8c4.

GET http://blackpearl-hostname/_rest_/cache_filesystem/8dfef781-a13c-4ea5-ac22-db4f7425a8c4 HTTP/1.1

Sample Response

HTTP/1.1 200 OK
<Data>
   <AutoReclaimInitiateThreshold>
      0.82
   </AutoReclaimInitiateThreshold>
   <AutoReclaimTerminateThreshold>
      0.72
   </AutoReclaimTerminateThreshold>
   <BurstThreshold>0.85</BurstThreshold>
   <Id>8dfef781-a13c-4ea5-ac22-db4f7425a8c4</Id>
   <MaxCapacityInBytes>524288000</MaxCapacityInBytes>
   <MaxPercentUtilizationOfFilesystem/>
   <NodeId>6f3baf6a-acdc-4626-b930-3062f5b70fb6</NodeId>
   <Path>
      /usr/local/BlackPearl/frontend/cachedir/
   </Path>
</Data>