Aggregation level for server hardware inventory report data.
HPE Compute Ops Management API (latest)
HPE Compute Operations Management provides a Restful API to customers who want to manage their devices programmatically or through a command line. The API enables customers to invoke operations or tasks such as list devices, see device details, device health, and manage their device's firmware.
UPDATED API ENDPOINTS
Compute Ops Management now supports the HPE GreenLake API endpoints (<region>.api.greenlake.hpe.com). The Guide contains more information about this change.
Download OpenAPI description
Overview
License
Languages
Servers
API endpoint for US West
https://us-west.api.greenlake.hpe.com/
API endpoint for EU Central
https://eu-central.api.greenlake.hpe.com/
API endpoint for AP Northeast
https://ap-northeast.api.greenlake.hpe.com/
Mock server
https://developer.greenlake.hpe.com/_mock/docs/greenlake/services/compute-ops-mgmt/public/openapi/compute-ops-mgmt-latest/
Query Examples: Examples:
Sort expression in the form <attribute> asc|desc.
Supported attributes for each group-by type:
SERVER:name,id,model,processor,management,serverGeneration,memoryGiB,processorCount,deviceCount,powerSupplyCount,fanCount,driveCount,formFactorSERVER_MODEL:model,countSERVER_GENERATION:serverGeneration,countSERVER_PROCESSOR:processor,countSERVER_MEMORY:memoryGiB,countSERVER_MANAGEMENT:management,countDEVICES:deviceName,partNumber,assemblyNumber,technology,linkLanes,deviceCount,serverCountDEVICE_DETAIL:deviceName,deviceSerialNumber,location,firmwareVersion,serverId,serverNameDEVICE_AND_SERVER:serverId,serverName,deviceName,deviceCountDRIVES:driveModel,driveName,protocol,mediaType,capacityGB,speedGbps,driveCount,serverCountDRIVE_DETAIL:serverId,serverName,driveModel,driveName,driveSerialNumber,location,driveEnclosure,firmware,failurePredicted,predictedMediaLifeLeftPercentDRIVE_AND_SERVER:serverId,serverName,driveModel,driveName,driveCountDRIVE_LIFE_PERCENTAGE:remainingDriveLifeRange,driveCount,serverCountDRIVE_LIFE_DETAIL:serverId,serverName,driveSerialNumber,remainingDriveLifeRange,location,driveEnclosure,failurePredicted,predictedMediaLifeLeftPercentDRIVE_LIFE_AND_SERVER:serverId,serverName,remainingDriveLifeRange,driveCount
sort=name asc
sort=driveCount desc
Filter expression in the form <attribute> eq '\<value>'.
Supported attributes for each group-by type:
SERVER:model,processor,management,serverGeneration,memoryGiBDEVICES,DEVICE_DETAIL,DEVICE_AND_SERVER:deviceNameDRIVES,DRIVE_DETAIL,DRIVE_AND_SERVER:driveModelDRIVE_LIFE_PERCENTAGE,DRIVE_LIFE_DETAIL,DRIVE_LIFE_AND_SERVER:remainingDriveLifeRange
filter=model eq 'ProLiant DL360 Gen10'
filter=remainingDriveLifeRange eq 'RANGE_50_100'
Limit the resources operated on by tags or return only the subset of resources that match all the filter tags.
filter-tags=('Rack' eq 'Rack1')
filter-tags=(('Rack' eq 'Rack1') AND ('Row' eq 'Row1'))
URI of the resource for which server hardware inventory report data is to be retrieved. This can be a server, filter or group URI.
Default "/compute-ops-mgmt/v1beta1/filters/e7cef8e6-a3f6-4490-b669-136e3ca40617"
Examples: resource-uri=/compute-ops-mgmt/v1beta1/filters/f4a8b2c9-7d5e-4321-9876-1a2b3c4d5e6f
resource-uri=/compute-ops-mgmt/v1/servers/875765-S01+1M512501AB
resource-uri=/compute-ops-mgmt/v1/groups/420372b6-af2e-464d-970d-e9339abfc74f
When set to true, the response contains details for servers that do not have inventory data available.
When excluded-servers=true, sort and filter query parameters are not supported.
Default false
Example: excluded-servers=true
Headers
Tenant-Acid header can be used by an MSP workspace to make API calls on behalf of their tenant by specifying the tenant's application customer ID.
In order to make such an API call, the Bearer token must belong to an MSP workspace and this header value must be the application customer ID of a tenant within the MSP workspace. Use the /compute-ops-mgmt/v1beta1/accounts API to determine the application customer IDs for your tenant accounts.
- API endpoint for US West
https://us-west.api.greenlake.hpe.com/compute-ops-mgmt/v1beta1/server-hardware-inventory-report
- API endpoint for EU Central
https://eu-central.api.greenlake.hpe.com/compute-ops-mgmt/v1beta1/server-hardware-inventory-report
- API endpoint for AP Northeast
https://ap-northeast.api.greenlake.hpe.com/compute-ops-mgmt/v1beta1/server-hardware-inventory-report
- Mock server
https://developer.greenlake.hpe.com/_mock/docs/greenlake/services/compute-ops-mgmt/public/openapi/compute-ops-mgmt-latest/compute-ops-mgmt/v1beta1/server-hardware-inventory-report
- curl
- JavaScript
- Node.js
- Python
- Java
- Go
- C#
- PHP
curl -i -X GET \
'https://us-west.api.greenlake.hpe.com/compute-ops-mgmt/v1beta1/server-hardware-inventory-report?group-by=SERVER' \
-H 'Authorization: Bearer <YOUR_JWT_HERE>'OK
itemsArray of item-server (object) or item-server-model (object) or item-server-generation (object) or item-server-processor (object) or item-server-memory (object) or item-server-management (object) or item-devices (object) or item-device-detail (object) or item-device-and-server (object) or item-drives (object) or item-drive-detail (object) or item-drive-and-server (object) or item-drive-life-percentage (object) or item-drive-life-detail (object) or item-drive-life-and-server (object)required
Data rows for the selected group-by value.
One of:
- item-server
- item-server-model
- item-server-generation
- item-server-processor
- item-server-memory
- item-server-management
- item-devices
- item-device-detail
- item-device-and-server
- item-drives
- item-drive-detail
- item-drive-and-server
- item-drive-life-percentage
- item-drive-life-detail
- item-drive-life-and-server
Item shape for group-by=SERVER.
object item-server Recursive
Response
application/json
{ "offset": 0, "count": 10, "total": 125, "items": [ { … } ] }