Post metrics records

A new public endpoint is available to send CloudZero Unit Metric telemetry data. This endpoint allows you to send Unit Metric data that will automatically be available in the CloudZero Analytics platform after the next data ingest.

Note: This endpoint is the legacy version of /unit-cost/v1/telemetry/metric/{metric_name}/sum. It is functionally identical, but predates the operational path parameter concept.

Path Params
string
required

A unique name to identify this unit metric.

Body Params
records
array of objects
required

A batch of telemetry records to submit to CloudZero.

records*
Headers
string
required

Your CloudZero API Key. Note: This is not a bearer token, and should appear in the header as Authorization: <cloudzero-api-key>

Responses
200

Telemetry accepted

400

Invalid request, specific responses for:

  • Invalid JSON
  • Invalid Schema: Unrecognized filter keys
  • Invalid Schema: Missing required fields
  • Timestamp too far into the future
  • All records in a stream must contain the same filter keys
  • All records in a stream must contain the same granularity as the stream's granularity
403

Not authorized, make sure you're using a valid API key in the header Authorization

429

Rate limit exceeded. The API enforces rate limiting on incoming requests. Retry after a short delay.

503

Service temporarily unavailable due to downstream capacity constraints. Retry after a short delay with exponential backoff.

Language
Response
Click Try It! to start a request and see the response here!