Create a file system
Creates a file system on a virtual server using a storage pool. A label is assigned to the file system during the creation process. The operation returns a URI that can be accessed to retrieve detailed information about the file system.
HTTP request syntax (URI)
POST <base_URI>/v8/storage/filesystems
Parameters
Name | Type | Required | Values | Description |
label | BODY | Y | string | Label of the file system to be created. |
virtualServerId | BODY | Y | number | ID of the virtual server to be used. |
storagePoolId | BODY | Y | number | ID of the storage pool to be used. |
capacity | BODY | Y | number | Capacity of the file system to be created in bytes. |
Return codes
Code | Data | Description |
201 | filesystem | File system object successfully created. |
400 | Error Message | Missing or invalid request contents. |
403 | Error Message | Operation forbidden by access level. |
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.11.11:8444/v8/storage/filesystems -d '{"label":"fs-test", "virtualServerId":4, "storagePoolId":4286815075241083603, "capacity":19327352832}' -X POST
Response example
HTTP/1.1 201 Created { "filesystem": { "blockSize": 0, "capacity": 19268632576, "expansionLimits": 18446744073709552000, "filesystemId": "866260F047C882190000000000000000", "freeCapacity": 0, "isDedupeEnabled": false, "isDedupeSupported": false, "isLogicalCapacityFreeCapacityValid": true, "isLogicalCapacityValid": true, "isNDMPRecoveryTarget": false, "isNonStrictWORM": false, "isObjectReplicationTarget": false, "isReadCached": false, "isReadOnly": false, "isSysLocked": true, "isThinProvisioningEnabled": false, "isThinProvisioningEnabledValid": true, "isTiered": false, "isTrueSparseFileEnabled": false, "isTrueSparseFileEnabledValid": true, "isUnlimitedExpansion": false, "isWORM": false, "label": "fs-test", "logicalCapacity": 0, "logicalFreeCapacity": 0, "objectId": "38363442313232384142423134344143303030303030303030303030303030303a3a3a303a3a3a4f49445f24232140255f56", "status": "NOT_MOUNTED", "storagePoolId": 9676880324761524000, "tierInformation": [], "usedCapacity": 0, "virtualServerId": 4 }, "uri": "https://172.17.11.11:8444/v8v8/storage/filesystems/3836363236304630343743383832313930303030303030303030303030303030" }