CreateVolume totalSize explanation is wrong

Page URL

https://docs.netapp.com/us-en/element-software/api/reference_element_api_createvolume.html

Page title

CreateVolume

Summary

Total size of the volume, in bytes. Size is rounded up to the nearest megabyte.

First, that's wrong. totalSize can be precise down to several bytes (2nd example below). Maybe some "internal" allocation in terms of metadata is indeed rounded up, but how is that relevant or useful?

Second, what it should really inform the user that totalSize is range(1,16384) MiB, so that users know the part that matters.

Request:

{
  "method": "CreateVolume",
  "params": {
    "name": "volumeName",
    "accountID": 1,
    "totalSize": 1073741820,
    "enable512e": true,
    "attributes": {
      "proxmox": true,
      "key": "value",
      "some_id": 1
    },
    "qosPolicyID": 4,
    "associateWithQoSPolicy": true,
    "enableSnapMirrorReplication": false,
    "fifoSize": "5",
    "minFifoSize": "3"
  },
  "id": 1
}

Response:

{
  "error": {
    "code": 500,
    "message": "totalSize must be greater than 1073741824",
    "name": "xInvalidAPIParameter"
  },
  "id": 1
}

Request with 8 bytes more (previously 1073741820, now 1073741828 bytes):

{
  "method": "CreateVolume",
  "params": {
    "name": "volumeName",
    "accountID": 1,
    "totalSize": 1073741828,
    "enable512e": true,
    "attributes": {
      "proxmox": true,
      "key": "value",
      "some_id": 1
    },
    "qosPolicyID": 4,
    "associateWithQoSPolicy": true,
    "enableSnapMirrorReplication": false,
    "fifoSize": "5",
    "minFifoSize": "3"
  },
  "id": 1
}

Response:

{
  "id": 1,
  "result": {
    "curve": {
      "1048576": 15000,
      "131072": 1950,
      "16384": 270,
      "262144": 3900,
      "32768": 500,
      "4096": 100,
      "524288": 7600,
      "65536": 1000,
      "8192": 160
    },
    "volume": {
      "access": "readWrite",
      "accountID": 1,
      "attributes": {
        "key": "value",
        "proxmox": true,
        "some_id": 1
      },
      "blockSize": 4096,
      "createTime": "2026-02-15T08:40:25Z",
      "currentProtectionScheme": "singleHelix",
      "deleteTime": "",
      "enable512e": true,
      "enableSnapMirrorReplication": false,
      "fifoSize": 5,
      "iqn": "iqn.2010-01.com.solidfire:juut.volumename.5737",
      "lastAccessTime": null,
      "lastAccessTimeIO": null,
      "minFifoSize": 3,
      "name": "volumeName",
      "previousProtectionScheme": null,
      "purgeTime": "",
      "qos": {
        "burstIOPS": 3000,
        "burstTime": 60,
        "curve": {
          "1048576": 15000,
          "131072": 1950,
          "16384": 270,
          "262144": 3900,
          "32768": 500,
          "4096": 100,
          "524288": 7600,
          "65536": 1000,
          "8192": 160
        },
        "maxIOPS": 3000,
        "minIOPS": 50
      },
      "qosPolicyID": 4,
      "scsiEUIDeviceID": "6a75757400001669f47acc0100000000",
      "scsiNAADeviceID": "6f47acc1000000006a75757400001669",
      "sliceCount": 0,
      "status": "active",
      "totalSize": 1074790400,
      "virtualVolumeID": null,
      "volumeAccessGroups": [],
      "volumeConsistencyGroupUUID": "dab9d9a5-aabe-44c6-820c-685e3395d127",
      "volumeID": 5737,
      "volumePairs": [],
      "volumeUUID": "72fe392f-0400-47e7-aa69-17df23d89693"
    },
    "volumeID": 5737
  }
}

Public issues must not contain sensitive information

• This issue contains no sensitive information.