GET /storage
Use this method to return properties for all storage devices and tape libraries.
Authentication
Authentication with username and password is required.
Request URL
GET https://{management_server_IP}/storage
Query parameters
| Parameters | Required / Optional | Description |
|---|---|---|
| excludeAttributes={attributes} | Optional | Returns a response that excludes the specified attributes for each resource. You can specify one or more attributes that are listed in the response body, separated by a comma. Note
|
| formatType={type} | Optional | Returns information in the specified format. This can be one of the following values.
If the format type is not specified, JSON format is returned. Note To retrieve properties for a large number of devices, use |
| includeAttributes=<attributes} | Optional | Returns a response that includes the base attributes and the specified attributes for each resource. You can specify one or more attributes that are listed in the response body, separated by a comma. Note
|
The following example returns a CSV file that contains information about all storage devices.
GET https://192.0.2.0 /storage?formatType=csv
Request body
None
Response codes
| Code | Description | Comments |
|---|---|---|
| 200 | OK | The request completed successfully. |
| 400 | Bad Request | A query parameter or request attribute is missing or not valid, or the operation is not supported. A descriptive error message is returned in the response body. |
| 401 | Unauthorized | The user cannot be authenticated. Authentication has not been provided or has failed. A descriptive error message is returned in the response body. |
| 403 | Forbidden | The orchestrator server was prevented from fulfilling the request. A descriptive error message is returned in the response body. Ensure that you have privileges to perform the request. |
| 409 | Conflict | There is a conflict with the current state of the resource. A descriptive error message is returned in the response body. |
| 500 | Internal Server Error | An internal error occurred. A descriptive error message is returned in the response body. |
Response body
| Attributes | Type | Description | ||||
|---|---|---|---|---|---|---|
| storageList | Array | List of all storage devices and tape libraries. | ||||
| See GET /storage/{uuid_list} | Object | Detailed information about the individual storage device and and tape library. | ||||
Response example
The following example is returned if the request is successful.
{
"storageList": [{
"accessState": Online",
"canisterSlots": 2,
"cmmHealthState": "Normal",
"contact": "F",
"description": "F",
"diskGroups": 2,
"driveBays": 12,
"enclosureCount": 1,
"enclosures": [{
"canisters": [{
"cmmDisplayName": "controller_a",
"controllerId": "A",
"controllerRedundancyMode": "Active-ActiveULP",
"controllerRedundancyStatus": "Redundant",
"disks": 9,
"diskBusType": "SAS",
"diskChannels": 2,
"energyMetrics": {
"diskControllerTemperature": [],
"inletAirTemperature": [],
"memoryTemperature": []
},
"expansionPorts": [{
"health": "N/A",
"healthReason": "No drive enclosure is connected to this expansion port. This is normal if this
is the last (or only) enclosure in the cabling sequence of the system.",
"healthRecommendation": "-Noactionisrequired.",
"name": "OutPort",
"status": "Disconnected"
}],
"failOverReason": "Notapplicable",
"failedOverToThisController": "No",
"firmware": {
"backplaneType": "7",
"bundleVersion": "GL221R020-14",
"buildDate": "ThuJun2909: 26: 26MDT2017",
"capiVersion": "3.19",
"cpldCodeVersion": "56",
"diskInterfaceHardwareVersion": "3",
"expanderControllerCodeVersion": "3206",
"hardwareVersion": "5.2",
"hostInterfaceHardwareVersion": "2",
"hostInterfaceModuleModel": "6",
"hostInterfaceModuleVersion": "11",
"managementControllerCodeVersion": "GLM221R037-02",
"managementControllerLoaderCodeVersion": "6.27.25440",
"scBootMemoryReferenceCodeVersion": "1.2.1.10",
"storageControllerCodeBaselevel": "GLS221R13-01",
"storageControllerCodeVersion": "GLS221R13-01",
"storageControllerCpuType": "Gladden1300MHz",
"storageControllerLoaderCodeVersion": "27.016",
"version": "5.6",
"versionType": "nonencrypted"
},
"hardwareVersion": "5.2",
"health": "Normal",
"healthReason": "",
"healthRecommendation": "",
"hostPorts": 4,
"networkPorts": {
"addressingMode": "Manual",
"gateway": "10.243.0.1",
"health": "OK",
"healthReason": "",
"healthRecommendation": "",
"ipAddress": "10.243.9.148",
"ipVersion": 4,
"macAddress": "00: c0: ff: 28: 03: c7",
"name": "mgmtport_a",
"networkMask": "255.255.240.0"
},
"phyIsolation": "Enabled",
"ports": [{
"action": "- If this host port is intentionally unused, no actionis required.\n
- Otherwise, use an appropriate interface cable to connect this host
port to a switch o rhost.\n
- If a cable is connected, check the cable and the switch or host for
problems.",
"actualSpeed": "",
"configSpeed": "Auto",
"health": "N/A",
"media": "FC(-)",
"port": "A2",
"reason": "There is no active connection to this host port.",
"status": "Disconnected",
"targetId": "227000c0ff280e8b",
"topology": "PTP"
},
...,
{
"action": "- If this host port is intentionally unused, no actionis required.\n
- Otherwise, use an appropriate interface cable to connect this host
port to a switch o rhost.\n
- If a cable is connected, check the cable and the switch or host for
problems.",
"actualSpeed": "",
"configSpeed": "Auto",
"health": "N/A",
"media": "FC(-)",
"port": "A3",
"reason": "There is no active connection to this host port.",
"status": "Disconnected",
"targetId": "237000c0ff280e8b",
"topology": "PTP"
}]
"position": "Top",
"powerState": "On",
"revision": "0",
"serialNumber": "11S00WC050Y010DH677180",
"status": "Operational",
"systemCacheMemory": 6144,
}],
"drives": [{
"firmwareVersion": null",
"health": "OK",
"healthReason": "",
"healthRecommendation": "",
"location": "0.9",
"model": "ST2000NM0034X",
"serialNumber": "Z4H02R730000R538RM68",
"size": "2000.3TiB",
"status": "Up",
"type": "SASMDL",
"vendorName": "LENOVO-X"
},
...,
{
"firmwareVersion": null,
"health": "OK",
"healthReason": "",
"healthRecommendation": "",
"location": "0.4",
"model": "ST2000NM0034X",
"serialNumber": "Z4H07S8L0000R628K52C",
"size": "2000.3TiB",
"status": "Up",
"type": "SASMDL",
"vendorName": "LENOVO-X"
}],
"enclosureInfo": {
"diskCount": 9,
"driveBays": 12,
"enclosureId": 0,
"health": "OK",
"model": "S3200",
"midplaneSerialNumber": "11S00WC065Y010DH67C0RF",
"status": "Up",
"vendorName": "Lenovo",
"wwn": "500C0FF0280E8B3C"
},
"energyMetrics": {
"enclosurePower": []
},
"frus": [{
"description": "SPSMemoryCard",
"fruLocation": "LOWERIOMMEMORYCARDSLOT",
"fruStatus": "OK",
"partNumber": "40-00000053",
"serialNumber": "",
"shortName": "MemoryCard"
},
...,
{
"description": "48X44xCNCRIOM-LX6GBLENOVO",
"fruLocation": "LOWERIOMSLOT",
"fruStatus": "OK",
"partNumber": "00WC050",
"serialNumber": "11S00WC050Y010DH677182",
"shortName": "RAIDIOM"
}],
"location": {
"lowestRackUnit": 0,
"location": "",
"rack": "",
"room": ""
},
"powerSupplies": [{
"health": "OK",
"healthReason": "",
"healthRecommendation": "",
"model": "00WC067",
"position": "Right",
"status": "Up",
"vendorName": ""
},
{
"health": "OK",
"healthReason": "",
"healthRecommendation": "",
"model": "00WC067",
"position": "Left",
"status": "Up",
"vendorName": ""
}],
"slots": ["0", "1", "2", "4", "5", "6", "8", "9", "10"]
}],
"excludedHealthState": "Normal",
"healthReason": "",
"ipv4Addresses": ["10.243.9.148", "10.243.9.149"],
"isConnectionTrusted": "true",
"location": {
"location": "",
"lowestRackUnit": 0,
"rack": "",
"room": ""
},
"machineType": "6411",
"mgmtProcIPaddress": "192.0.2.0",
"model": "S3200",
"name": "S3200",
"otherMcStatus": "Operational",
"overallHealthState": "Normal",
"parent": {
"uri": "",
"uuid": ""
},
"pfu": "Idle",
"productBrand": "Storage",
"productName": "S3200",
"scsiProductId": "S3200",
"scsiVendorId": "Lenovo",
"securityDescriptor": {
"managedAuthEnabled": true
"managedAuthSupported": true,
"publicAccess": true,
"roleGroups": ["lxc-admin","lxc-security-admin"],
"storedCredentials": null,
"uri": "storage/0069030ADC5F453E9EE49CA4B44DB8DC"
},
"serialNumber": "280E8B",
"storageNodeCapacityList": [{
"blockStorage": {
"available": "6.66 TiB",
"fullThresholdPercent": "96",
"size": "6.83 TiB",
"used": "168 GiB"
},
"nodeName": "PerfDM7100F-02"
}, {
"blockStorage": {
"available": "6.66 TiB",
"fullThresholdPercent": "96",
"size": "6.83 TiB",
"used": "168 GiB"
},
"nodeName": "PerfDM7100F-01"
}],
"supportedLocales": "English(English), Arabic(العربية), Portuguese(português), Spanish(español),
French(français), German(Deutsch), Italian(italiano), Japanese(日本語),
Korean(한국어), Dutch(Nederlands), Russian(русский),
Chinese-Simplified(简体中文), Chinese-Traditional(繁體中文)",
"systemLocation": "LXCA_empty_field, LXCA_empty_field, LXCA_empty_field",
"type": "LenovoStorage",
"userDefinedName": "Storage1",
"userDescription": "F",
"uri": "storage/208000C0FF280E8B",
"uuid": "208000C0FF280E8B",
"vendorName": "Lenovo",
"virtualPools": 2,
"wwnn": "208000C0FF280E8B",
}]
}
Give documentation feedback