Retrieve utilization data over time

get/compute-ops-mgmt/v1beta1/utilization-over-time

Retrieve CPU, memory bus, I/O bus or CPU interconnect utilization data over a time interval.

SecurityBearer
Request
query Parameters
start-date
required
string <date>

Start date for utilization data retrieval.

Example: start-date=2025-01-01
end-date
required
string <date>

End date for utilization data retrieval.

Example: end-date=2025-04-01
resource-uri
required
string

URI of the resource for which utilization data is to be retrieved. This can be a server URI or a filter URI.

Examples:
resource-uri=/compute-ops-mgmt/v1/servers/875765-S01+1M512501AB
resource-uri=/compute-ops-mgmt/v1beta1/filters/e7cef8e6-a3f6-4490-b669-136e3ca40617
metric-type
required
string

The metric type for which utilization data is to be retrieved.

Enum: "CPU_UTILIZATION" "MEMORY_BUS_UTILIZATION" "IO_BUS_UTILIZATION" "CPU_INTERCONNECT_UTILIZATION"
header Parameters
Tenant-Acid
string <uuid>

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.

Responses
200

OK

400

Bad request

401

Unauthorized

403

Forbidden

406

Not acceptable

500

Internal server error

Request samples 
Response samples 
application/json
{
  • "metricType": "CPU_UTILIZATION",
  • "metricUnit": "Percentage",
  • "items": [
    ]
}