Skip to content

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
Languages
Servers
Mock server

https://stage-developer-portal-hpe.redocly.app/_mock/docs/greenlake/services/compute-ops-mgmt/public/openapi/compute-ops-mgmt-latest/

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/

accounts - v1beta1

Operations

activation-keys - v1beta1

Operations

activation-tokens - v1beta1

Operations

activities - v1beta2

Operations

ahs-files - v1beta1

Operations

appliance-firmware-bundles - v1

Operations

appliance-firmware-bundles - v1beta1

Operations

async-operations - v1

Operations

async-operations - v1beta1

Operations

energy-over-time - v1beta1

Operations

energy-by-entity - v1beta1

Operations

external-services - v1beta1

Operations

filters - v1beta1

Operations

firmware-bundles - v1

Operations

firmware-bundles - v1beta2

Operations

groups - v1

Operations

groups - v1beta3

Operations

groups - v1beta2

Operations

job-templates - v1beta2

Operations

jobs - v1

Operations

jobs - v1beta3

Operations

jobs - v1beta2

Operations

metrics-configurations - v1

Operations

oneview-appliances - v1beta1

Operations

oneview-settings - v1beta1

Operations

oneview-server-templates - v1beta1

Operations

reports - v1beta2

Operations

schedules - v1beta2

Operations

server-locations - v1beta1

Operations

Get location details

Request

Get location details with id of the servers associated with the location. The associted servers for the location includes both direct connect and OneView managed servers.

Security
Bearer
Path
location_idstring(uuid)required

Location ID

curl -i -X GET \
  'https://stage-developer-portal-hpe.redocly.app/_mock/docs/greenlake/services/compute-ops-mgmt/public/openapi/compute-ops-mgmt-latest/compute-ops-mgmt/v1beta1/server-locations/{location_id}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Successful Response

Bodyapplication/json
idstring(uuid)

Unique server-location identifier.

Example: "36e00ac2-16fb-4dd5-8495-7e6df82fc15e"
typestringread-only

The type of the resource.

Value "compute-ops-mgmt/server-location"
generationinteger

Monotonically increasing update counter.

Example: 1
createdAtstring(date-time)

Time of the server-location's creation in UTC.

Example: "2023-12-25T01:04:21.799937+00:00"
updatedAtstring(date-time)

Time of the server-location's last update in UTC.

Example: "2023-12-25T01:06:30.799489+00:00"
resourceUristring(uri-reference)

The URI of this resource.

Example: "/compute-ops-mgmt/v1beta1/server-locations/b870f080-6448-48c5-b23a-d04f2d489174"
serversArray of strings(productId+serialNumber)

List of ids of servers assigned to server-location

Example: ["177751-Y66+89177751666","320888-H80+89320888180"]
Response
application/json
{ "id": "36e00ac2-16fb-4dd5-8495-7e6df82fc15e", "type": "compute-ops-mgmt/server-location", "generation": 1, "createdAt": "2023-12-25T01:04:21.799937+00:00", "updatedAt": "2023-12-25T01:06:30.799489+00:00", "resourceUri": "/compute-ops-mgmt/v1beta1/server-locations/b870f080-6448-48c5-b23a-d04f2d489174", "servers": [ "177751-Y66+89177751666", "320888-H80+89320888180" ] }

Assign location to servers

Request

Assign a location for servers managed by HPE OneView. Use HPE GreenLake Locations API for managing location of servers which are managed directly by Compute Ops Management.

Security
Bearer
Path
location_idstring(uuid)required

ID of the location in HPE GreenLake

Bodyapplication/json
serversArray of strings(productId+serialNumber)required

List of server ids to assign location

Example: ["177751-Y66+89177751666","320888-H80+89320888180"]
curl -i -X POST \
  'https://stage-developer-portal-hpe.redocly.app/_mock/docs/greenlake/services/compute-ops-mgmt/public/openapi/compute-ops-mgmt-latest/compute-ops-mgmt/v1beta1/server-locations/{location_id}/servers' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "servers": [
      "177751-Y66+89177751666",
      "320888-H80+89320888180"
    ]
  }'

Responses

Successful Response

Response
No content

Remove location of servers

Request

Remove location of one or more servers managed by HPE OneView. Use HPE GreenLake Locations API for managing location of servers which are managed directly by Compute Ops Management.

Security
Bearer
Path
location_idstring(uuid)required

ID of the location in HPE GreenLake

Query
idArray of strings(productId+serialNumber (percent-encoded))required
Examples:
id=177751-Y66%2B8899177751666258
id=177751-Y66%2B8899177751666258&id=320888-H80%2B8899320888180208
curl -i -X DELETE \
  'https://stage-developer-portal-hpe.redocly.app/_mock/docs/greenlake/services/compute-ops-mgmt/public/openapi/compute-ops-mgmt-latest/compute-ops-mgmt/v1beta1/server-locations/{location_id}/servers?id=string' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Successful Response

Response
No content

server-settings - v1beta1

Operations

settings - v1

Operations

settings - v1beta1

Operations

servers - v1

Operations

servers - v1beta2

Operations

server-warranty - v1beta2

Operations

user-preferences - v1

Operations

user-preferences - v1beta1

Operations

utilization-over-time - v1beta1

Operations

utilization-by-entity - v1beta1

Operations

webhooks - v1beta1

Operations