Get Asset Utilisation Summary

get

https://talk.perspio.io/assets/v3/utilisation/summary

Fetch utilisation summary of an asset.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

from

date-time

required

Start time for metrics in ISO 8601 format

date-time

required

End time for metrics in ISO 8601 format

objectIds

string

Comma separated list of Asset ids

groupby

string

required

Group by value. Accepted values: day, month, year

metrics

string

required

Comma-separated list of metrics to retrieve

Headers

x-perspio-filter

string

Global data filter (JSON-serialised) scoping results to matching assets. Optional keys, each an array of strings: locationHierarchyL1..L3, productHierarchyL1..L3, operationalHierarchyL1..L3, groupIds; plus boolean 'enabled'. Omit for no additional filtering (security-group scoping always applies). Example: {"locationHierarchyL1":["NSW"],"enabled":true}

includedisabledassets

boolean

When true, disabled assets are included in the tenant scope applied to this request. Defaults to false.

ContinuationToken

string

Opaque token from a previous response's ContinuationToken header, to fetch the next page.

Responses

400

Invalid Request

401

Unauthorized. The response body's error code identifies which credential failed: invalid_subscription_key, invalid_token, expired_token, or invalid_tenant.

200Success

500Internal Server Error