Replace metric records for the submitted dates

Atomically replace metric telemetry records by usage date. For every date present in the submitted batch, all existing records on that date are dropped and the submitted records inserted. Dates not present in the batch are left untouched.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
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
201

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
  • A value of 0 is not allowed; use the delete operation to remove a record
  • Telemetry stream must exist in order to update telemetry records
  • 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

404

The telemetry stream does not exist. Streams must be created (via sum, replace, or the UI) before replace_period can target them.

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
LoadingLoading…
Response
Click Try It! to start a request and see the response here!