Network Attached Storage​

 HNAS API "Reset" variable on quota creation.

  • Network Attached Storage
  • Hitachi Network Attached Storage NAS
João Serra's profile image
João Serra posted 09-13-2021 11:23

 

To implement a quota on a Virtual file system, the API is this:

 

curl -v -X POST --insecure -H "Content-Type: application/json; charset=UTF-8" -H "X-Management-IPs: 172.17.239.142"  -H "X-Subsystem-User: supervisor" -H "X-Subsystem-Password: supervisor" -H "X-Subsystem-Type: FILE" https://172.17.57.75:8444/v7/storage/virtual-volumes/353a3a3a37353431323730394531434239414142303030303030303030303030303030303a3a3a3136/quotas -d ‘{"diskUsageThreshold": {"limit":1234567890,"isHard":true,"reset":65,"warning":75,"severe":95},"fileCountThreshold":{"limit":1000,"isHard":false,"reset":85,"warning":90,"severe":95},"logEvent":true}’

 

The question is what is the “reset value”?

 

Is it a % value that resets the warning status. It seems like it but there is no reference of it on the API description:

 

This is the link where the this API is described:

 

https://knowledge.hitachivantara.com/Documents/Storage/NAS_Platform/13.6/Hitachi_NAS_File_Storage_REST_API_Reference/Virtual_volume_quota_resource/06_Create_a_virtual_volume_quota

Johann du Toit's profile image
Johann du Toit

Hi Joao,

"reset" works when "isHard" is set to "false".

When set to false, it will not stop the user from exceeding the quota, but will generate a warning or severe alert, based on which value was exceeded. The alert will be reset, if data is deleted and usage falls under the "reset" value.

Albert Hagopian's profile image
Albert Hagopian

Additionally, the latest update to REST API is located here 

For latest ViVol info, look here.

Hopefully you are running a very recent version of HNAS where you can enable the "native" REST API instead of using the "legacy" version as we are moving to enable the "native" as the only version in the very near future.

For additional information on vivol quota information and the reset value, please see the man page for quota in the CLI.

                -w, --usage-warn

                    Usage warning threshold (%)

                -p, --usage-critical

                    Usage critical threshold (%)

                -r, --usage-reset

                    Amount by which usage must fall below a threshold before re-logging its event (%)

                -a, --fcount-warn

                    File count warning threshold (%)

                -b, --fcount-critical

                    File count critical threshold (%)

                -c, --fcount-reset

                    Amount by which file count must fall below a threshold before re-logging its event (%)