Create a storage pool

NAS File Storage REST API v7 Reference

Version
14.7.x
14.6.x
Audience
anonymous
Part Number
MK-92HNAS088-05

Creates a non-tiered storage pool using a set of system drives. A label is assigned to the storage pool during the creation process. The operation returns a URI that can be accessed to obtain detailed information about the storage pool immediately after the URI is returned.

HTTP request syntax (URI)

POST <base_URI>/v7/stroage/storage-pools

Parameters

Name Type Required Values Description
label BODY Y string Label for the storage pool to be created.
chunkSize BODY Y number Chunk size in bytes.
systemDrives BODY Y array System drives to be used to create the storage pool. To create a storage pool, the number of system drives must be at least 4 but cannot exceed 32.

Return codes

Code Data Description
201 storagePool Storage pool object successfully created.
400 No Data Missing or invalid request contents.
500 Error message Error associated with the storage system.
501 No Data Server has not implemented the request operation on the resource.

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/v7/storage/storage-pools -d '{"label":"sp-test", "chunkSize":19327352832, "systemDrives":[10, 11, 12, 13]}' -X POST

Response example

HTTP/1.1 201 Created
{
   "storagePool" : {
      "chunkSize" : 19327352832,
      "freeCapacity" : 42932895744,
      "isAssignedToLocalCluster" : true,
      "isFilesystemExpansionAllowed" : true,
      "isHealthy" : true,
      "isTiered" : false,
      "label" : "sp-test",
      "objectId" : "3530353739333031303130363332303038383a3a3a",
      "storagePoolId" : 505793010106320088,
      "totalCapacity" : 42932895744,
      "usedCapacity" : 0
   },
   "uri" : "https://172.17.11.11:8444/v7/storage/storage-pools/3530353739333031303130363332303038383a3a3a"
}