Skip to main content

Get volumes

Contributors netapp-aoife

You can retrieve the list of volumes of an on-premises system.

Step 1. Select the system

Perform the workflow Get systems and choose the publicId for the workingEnvironmentId path parameter.

Step 2. Get the volumes

You can issue a REST API call to retrieve the volumes.

HTTP method and endpoint

This REST API call uses the following method and endpoint.

HTTP method Path

GET

occm/api/onprem/volumes?workingEnvironmentId=<ONPREM_WORKING_ENV_ID>

Curl example
curl --location --request GET ''https://api.bluexp.netapp.com/occm/api/onprem/volumes?workingEnvironmentId=<ONPREM_WORKING_ENV_ID>' --header 'Content-Type: application/json' --header 'x-agent-id: <AGENT_ID>' --header 'Authorization: Bearer <ACCESS_TOKEN>'
Additional input parameters

The JSON input example includes the minimum list of parameters.

Parameter Type Required Description

workingEnvironmentId <WORKING_ENV_ID>

Path

Yes

Identifies the system

JSON output example

The JSON output example includes the list of volumes for the system.

Example output
[
  {
    "name": "vol1",
    "uuid": "7770155f-0000-1xxx-880d-1155axcfdrewr73",
    "svmName": "svm_onpremwe",
    "size": {
      "size": 100,
      "unit": "GB"
    },
    "usedSize": {
      "size": 0.0019989013671875,
      "unit": "GB"
    },
    "junctionPath": "/vol1",
    "volumeTotalInodes": 0000000,
    "volumeUsedInodes": 00,
    "mountPoint": "10.xxx.0.10:/vol1",
    "compressionSpaceSaved": {
      "size": 0,
      "unit": "GB"
    },
    "deduplicationSpaceSaved": {
      "size": 0,
      "unit": "GB"
    },
    "thinProvisioning": true,
    "compression": true,
    "deduplication": true,
    "snapshotPolicy": "default",
    "securityStyle": "unix",
    "exportPolicyInfo": {
      "name": "export-svm_onpremwe-vol1",
      "policyType": "custom",
      "ips": [
        "0.0.0.0/0"
      ],
      "nfsVersion": [
        "nfs3",
        "nfs4"
      ],
      "rules": [
        {
          "index": 1,
          "ruleAccessControl": "readwrite",
          "ips": [
            "0.0.0.0/0"
          ],
          "nfsVersion": [
            "nfs3",
            "nfs4"
          ],
          "superUser": true
        }
      ]
    },
    "shareNames": [],
    "shareInfo": [],
    "parentVolumeName": "",
    "rootVolume": false,
    "state": "online",
    "volumeType": "rw",
    "aggregateName": "aggr2",
    "parentSnapshot": null,
    "autoSizeMode": "grow",
    "maxGrowSize": {
      "size": 1100,
      "unit": "GB"
    },
    "providerVolumeType": null,
    "cloneNames": [],
    "moving": false,
    "primaryNoFailoverMountPoint": null,
    "secondaryNoFailoverMountPoint": null,
    "capacityTier": null,
    "capacityTierUsedSize": null,
    "cifsShareAccessPoint": null,
    "primaryCifsShareAccessPoint": null,
    "secondaryCifsShareAccessPoint": null,
    "tieringPolicy": "none",
    "tierInactiveUserData": {
      "size": 0,
      "unit": "GB"
    },
    "tierInactiveUserDataPercent": 0,
    "comment": "",
    "qosPolicyGroupName": null,
    "snaplockType": "non_snaplock",
    "constituentsAggregates": [],
    "snapshotsUsedSize": {
      "size": 217088,
      "unit": "Byte"
    },
    "cbsBackupsInfo": null,
    "minimumCoolingDays": null,
    "targetName": "iqn.1992-08.com.netapp:sn.c304f509478e11ed88cvcvyhdc8fc573:vs.2",
    "iscsiEnabled": false,
    "isFlexGroupVolume": false
  }
]