REST API server supports embedding for single-level associations.
For example, system drives have associations with a storage pool (as shown in the following example).
Note: Without the embed keyword or with the notation embed=false, the output does not display data associated with the systemDrives keyword). REST API server supports embedding only for the GET API operation of a single resource (for example, a storage pool).
Request
curl --insecure -H "X-Api-Key: zrxvSDAv9x.RIP4gkmKarG3beF.or.4Tc2im7oeqYN88C9XPGHxbXC" https://172.43.12.33:8444/v7/storage/filesystems/ 38363442313232384142423134344143303030303030303030303030303030303a3a3a303a3 a3a4f49445f24232140255f56?embed=true
Response
HTTP/1.1 200 OK { "filesystem" : { "blockSize" : 32768, "capacity" : 58518929408, "expansionLimits" : 107374182400, "filesystemId" : "864B1228ABB144AC0000000000000000", "freeCapacity" : 18763186176, "isDedupeEnabled" : true, "isDedupeSupported" : true, "isLogicalCapacityFreeCapacityValid" : true, "isLogicalCapacityValid" : true, "isNDMPRecoveryTarget" : false, "isNonStrictWORM" : false, "isReadCached" : false, "isReadOnly" : false, "isSysLocked" : true, "isThinProvisioningEnabled" : false, "isThinProvisioningEnabledValid" : true, "isTrueSparseFileEnabled" : false, "isTrueSparseFileEnabledValid" : true, "isUnlimitedExpansion" : false, "isWORM" : false, "label" : "xyz-obj-rep-target-new", "logicalCapacity" : 0, "logicalFreeCapacity" : 0, "objectId" : "38363442313232384142423134344143303030303030303030303030303030303a3a3a303a3a3a4f49445f24232140255f56", "status" : "MOUNTED", "storagePoolId" : 9676880324761524863, "storagePools" : [ { "chunkSize" : 19327352832, "freeCapacity" : 175728754688, "isAssignedToLocalCluster" : true, "isFilesystemExpansionAllowed" : true, "isHealthy" : true, "isTiered" : false, "label" : "historDevStoragePool", "objectId" : "393637363838303332343736313532343836333a3a3a3a3a3a303a3a3a4f49445f24232140255f56", "storagePoolId" : 9676880324761524863, "totalCapacity" : 429492535296, "usedCapacity" : 253763780608 } ], "usedCapacity" : 39755743232, "virtualServerId" : 3, "virtualServers" : [ { "UUID" : "b70d82b2-0386-11d0-9043-49e1bb864b23", "ipAddresses" : [ "172.17.58.122" ], "isEnabled" : true, "name" : "xyz-evs-58-122", "objectId" : "333a3a3a3a3a3a303a3a3a4f49445f24232140255f56", "status" : "ONLINE", "type" : "File services", "virtualServerId" : 3 } ] } }