Create a snapshot rule
Creates a snapshot rule for a filesystem ID.
HTTP request syntax (URI)
POST <base_URL>/v8/storage/snapshot-rules
Parameters
Name | Type | Required | Values | Description |
filesystemId | BODY | Y | string | Either the file system object ID or HNAS file system ID for which the snapshot rule is created. |
snapshotRuleName | BODY | Y | string | Name of the snapshot rule. |
queueSize | BODY | Y | number | The maximum number of snapshots that can be created by this rule. When the maximum number has been reached, the newest snapshot overwrites the oldest one. The maximum is 1024 snapshots per rule. |
Return codes
Code | Data | Description |
201 | filesystemSnapshotRule | Retrieves a file system snapshot rule. |
400 | Error Message | Missing or invalid request contents. |
403 | Error Message | Operation forbidden by access level. |
404 | Error Message | Requested resource not found. |
500 | Error message | Error associated with the storage system. |
Any HTTP status code other than 201 indicates that the API did not complete successfully.
Request example
curl -vk -H "X-Api-Key: zrxvSDAv9x.RIP4gkmKarG3beF.or.4Tc2im7oeqYN88C9XPGHxbXC" https://172.17.239.120:8444/v8/storage/snapshot-rules -d '{"filesystemId": "8659E4DE8E2FF4EA0000000000000000", "snapshotRuleName":"rickSSRule", "queueSize":1}' -X POST
Response example
HTTP/1.1 201 Created { "filesystemSnapshotRule": { "filesystemId": "8659E4DE8E2FF4EA0000000000000000", "objectId": "343a3a3a38363539453444453845324646344541303030303030303030303030303030303a3a3a7269636b535352756c65", "isValid": true, "name": "rickSSRule", "queueSize": 1, "virtualServerId": 4 }, "uri": "https://172.17.239.120:8444/v8/storage/snapshot-rules/343a3a3a38363539453444453845324646344541303030303030303030303030303030303a3a3a7269636b535352756c65" }