List storage chunks for a series and range

Overview

List storage chunks for a series and range. Series-storage operations expose registered series, direct stored data, gap and chunk metadata, and lifecycle controls.

When to use it

• Use it when an application needs to list storage chunks for a series and range.
• Use it when a diagnostic or maintenance tool needs storage-level series data instead of model-resolved attributes.

Quick example

Set the base URL and replace generated identifiers or credentials with values from your installation.

curl --request GET \
  --url "$ORDINATE_URL/v1/series/00000000-0000-4000-8000-000000000001/chunks?start_ns=0&end_ns=0" \
  --header "Authorization: Bearer $ORDINATE_TOKEN"

[
  {
    "chunk_id": 0,
    "space": "string",
    "tier": "string",
    "format_version": 0,
    "t_min": 0,
    "t_max": 0,
    "count": 0,
    "has_revisions": false,
    "lossy_tag": "string",
    "state": "string"
  }
]

The cURL request supplies the documented path and query values and asks OrdinateDB to list storage chunks for a series and range. The documented 200 response is chunk diagnostics.

How it works

Reference

Required capability

read

Authorization scope

owning asset of series path parameter `uuid`, or staging-root

[
  {
    "chunk_id": 0,
    "space": "string",
    "tier": "string",
    "format_version": 0,
    "t_min": 0,
    "t_max": 0,
    "count": 0,
    "has_revisions": false,
    "lossy_tag": "string",
    "state": "string"
  }
]

{
  "error": "string",
  "code": "account-sealed",
  "correlation_id": "00000000-0000-4000-8000-000000000001"
}

{
  "error": "string",
  "code": "account-sealed",
  "correlation_id": "00000000-0000-4000-8000-000000000001"
}

{
  "error": "string",
  "code": "account-sealed",
  "correlation_id": "00000000-0000-4000-8000-000000000001"
}

Code examples

These examples are generated from the source contract. Replace the base URL, credentials, identifiers, and minimal generated values for your instance.

const ordinateUrl = "http://localhost:8080";
const token = "<bearer-token>";

const response = await fetch(`${ordinateUrl}/v1/series/00000000-0000-4000-8000-000000000001/chunks?start_ns=0&end_ns=0`, {
  method: "GET",
  headers: {
    Authorization: `Bearer ${token}`
  }
});

if (!response.ok) {
  throw new Error(`OrdinateDB returned ${response.status}: ${await response.text()}`);
}

const data = await response.json();
console.log(data);