Get per-host cost breakdown

get

https://api.controlup.com/daas-iq/v1/cloud/host-pools/{hostPoolId}/session-hosts/cost

Returns paginated cost attributed to each session host, with Compute/Disk/Network split, disk tier,
power state, and Premium SSD optimization flags, including hosts that have since been deleted.
Answers which host in the pool is expensive; it gives no pool-level total or trend.

Path Params

hostPoolId

uuid

required

The unique identifier of the host pool.

Query Params

startDate

date-time

Start date for the cost range (inclusive). Defaults to 30 days ago.

endDate

date-time

End date for the range (inclusive). Defaults to today.

sort

string

Sort expression for ordering results.

Format:
field:direction,otherField:direction

Directions: asc, desc, ascending, descending — defaults to ascending when omitted

Fields (names are matched case-insensitively):
computeCost, consecutiveDaysDeallocated, costRowOsDiskType, diskCost, diskTier, hostName, isDeleted, networkCost, otherCost, powerState, premiumSsdFlag, resourceId, savingEstimate, sessionHostId, totalCost, vmSku

Default when omitted: totalCost:desc.

page

int32

1 to 2147483647

The page number to retrieve (1-based). Default: 1.

pageSize

int32

1 to 100

The number of items per page (1-100). Default: 50.

Responses

200Successfully retrieved per-host cost data.

400Bad request. Invalid date range, pagination, or sort parameters.

401Unauthorized. User is not authenticated.

402Payment required. No active license for the organization.

403Forbidden. User does not have access to this organization.

404Not found. Host pool does not exist or does not belong to the organization.

500Internal server error.

503Service unavailable. License status could not be verified. Try again later.