Get space auto-cleaning configuration
Returns configuration of auto-cleaning mechanism in the space specified by space Id in the path.
Path parameters
| Parameter | Type & Description |
|---|---|
| id required | string The Id of a space of which auto-cleaning configuration should be returned. |
Request Examples
onepanel-rest-cli -u onepanel:$PASSPHRASE getSpaceAutoCleaningConfiguration id=$SPACE_ID --host https://$OP_PANEL_HOST:9443Responses
The space auto-cleaning configuration.
If true, auto-cleaning mechanism is enabled in the space.
Amount of data [b], which should trigger the auto-cleaning in the space. Only replicas maintained by this storage provider will be removed. This parameter is required to enable auto-cleaning.
Amount of data [b], at which the auto-cleaning process should stop. This parameter is required to enable auto-cleaning.
rules object (SpaceAutoCleaningRules) Rules used to select certain list of file replicas that can be evicted by auto-cleaning mechanism.
Rules used to select certain list of file replicas that can be evicted by auto-cleaning mechanism.
Informs whether selective rules should be used by auto-cleaning mechanism.
maxOpenCount object (SpaceAutoCleaningRuleSetting) Files that have been opened less than maxOpenCount times may be cleaned. The default value is 9007199254740991 (2^53-1).
Files that have been opened less than maxOpenCount times may be cleaned. The default value is 9007199254740991 (2^53-1).
Informs whether given setting is enabled.
Integer value of a given setting.
minHoursSinceLastOpen object (SpaceAutoCleaningRuleSetting) Files that haven't been opened for longer than or equal to given period [h] may be cleaned. The default value is 0.
Files that haven't been opened for longer than or equal to given period [h] may be cleaned. The default value is 0.
Informs whether given setting is enabled.
Integer value of a given setting.
minFileSize object (SpaceAutoCleaningRuleSetting) Only files which size [b] is greater than given value may be cleaned. The default value is 1.
Only files which size [b] is greater than given value may be cleaned. The default value is 1.
Informs whether given setting is enabled.
Integer value of a given setting.
maxFileSize object (SpaceAutoCleaningRuleSetting) Only files which size [b] is less than given value may be cleaned. The default value is 1125899906842624 (1 PiB).
Only files which size [b] is less than given value may be cleaned. The default value is 1125899906842624 (1 PiB).
Informs whether given setting is enabled.
Integer value of a given setting.
maxHourlyMovingAverage object (SpaceAutoCleaningRuleSetting) Files that have moving average of open operations count per hour less than given value may be cleaned. The average is calculated in 24 hours window. The default value is 9007199254740991 (2^53-1).
Files that have moving average of open operations count per hour less than given value may be cleaned. The average is calculated in 24 hours window. The default value is 9007199254740991 (2^53-1).
Informs whether given setting is enabled.
Integer value of a given setting.
maxDailyMovingAverage object (SpaceAutoCleaningRuleSetting) Files that have moving average of open operations count per day less than given value may be cleaned. The average is calculated in 30 days window. The default value is 9007199254740991 (2^53-1).
Files that have moving average of open operations count per day less than given value may be cleaned. The average is calculated in 30 days window. The default value is 9007199254740991 (2^53-1).
Informs whether given setting is enabled.
Integer value of a given setting.
maxMonthlyMovingAverage object (SpaceAutoCleaningRuleSetting) Files that have moving average of open operations count per month less than given value may be cleaned. The average is calculated in 12 months window. The default value is 9007199254740991 (2^53-1).
Files that have moving average of open operations count per month less than given value may be cleaned. The average is calculated in 12 months window. The default value is 9007199254740991 (2^53-1).
Informs whether given setting is enabled.
Integer value of a given setting.
Example
{
"enabled": true,
"target": 1073741824,
"threshold": 1099511627776,
"rules": {
"enabled": true,
"maxOpenCount": {
"enabled": true,
"value": 1000
},
"minHoursSinceLastOpen": {
"enabled": true,
"value": 10
},
"minFileSize": {
"enabled": true,
"value": 1
},
"maxFileSize": {
"enabled": true,
"value": 1024
},
"maxHourlyMovingAverage": {
"enabled": true,
"value": 10
},
"maxDailyMovingAverage": {
"enabled": false,
"value": 100
},
"maxMonthlyMovingAverage": {
"enabled": false
}
}
}Unauthorized request.
Forbidden request.
Space does not exist or is not supported by the provider.
Internal server error.
error object (ErrorDetails) Object describing an error.
Object describing an error.
String identifying the error type. Does not change between error instances.
Human readable error description. May contain information specific to given error instance.
Details about the error instance. The object schema is specific to each error type.
Example
{
"error": {
"id": "badValueString",
"details": {
"key": "name"
},
"description": "Bad value: provided \"name\" must be a string."
}
}