Skip to content
Butlr Data Center API

Read thermal statistics

POST
/v1/thermal/stats
curl --request POST \
  --url https://api.datacenter.butlr.io/v1/thermal/stats \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "entity": { "type": "hall", "id": "example" }, "sensors": [ "example" ], "from": 1, "to": 1, "measurement": "sensor_temperature", "metrics": [ "temperature" ], "samples": 1, "fields": [ "compensated" ], "tier": "fine", "include_per_u": true, "insights_only": true, "event_limit": 1, "event_cursor": "example" }'

Return sampled thermal series and summaries for an authorized entity and time window.

Authorizations

Section titled “Authorizations”

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
One of:
object
entity
required
object
type
required
string
Allowed values: hall pod rack rack_face
id
required
string
sensors
Array<string>
<= 64 items
from
integer format: int64
to
integer format: int64
measurement
string
Allowed values: sensor_temperature
metrics
Array<string>
Allowed values: temperature delta_t coverage health
samples
integer
<= 720
fields
Array<string>
Allowed values: compensated raw
tier
string
Allowed values: fine coarse
include_per_u
boolean
insights_only
boolean
event_limit
integer
>= 1
event_cursor
string

Responses

Section titled “Responses”

200

Section titled “200”

Thermal statistics

400

Section titled “400”

Invalid request

Media typeapplication/json
object
message
string
key
additional properties
any

Example generated

{
  "message": "example"
}

401

Section titled “401”

Missing, invalid, expired, or revoked token

Media typeapplication/json
object
message
string
key
additional properties
any

Example generated

{
  "message": "example"
}

403

Section titled “403”

Route, operation, or resource is outside the token’s read-only organization scope

Media typeapplication/json
object
message
string
key
additional properties
any

Example generated

{
  "message": "example"
}

429

Section titled “429”

Request rate exceeded; honor Retry-After

Media typeapplication/json
object
message
string
key
additional properties
any

Example generated

{
  "message": "example"
}