Skip to main content

Read a saved RSVP-TE measurement

POST
/tasks/{id}/rsvp/measurement/query

Returns the validated, lossless agent record saved in PostgreSQL. Terminal results remain available after task stop or core restart and require no live tracker or agent. Nonterminal results are refreshed from the server-registered admission address; a sync-error explicitly marks stale or unconfirmed status. Never starts or resumes traffic.

Contract

Parameter
Value
Sectiontasks
AuthenticationCookieAuth
Consumesapplication/json
Producesapplication/json

Parameters

2 parameters

Name
Location
Required
Type
Description
idpathyesintegerPositive task ID
requestbodyyesobjectNamed agent and sealed measurement identity; at most 64 KiB
  • {
      "agent": "<string>",
      "measurement-id": "<string>",
      "runtime-generation": "<string>"
    }

Responses

6 responses

Status
Description
Type
200
Persisted record; sync-error means saved nonterminal status may be staleobject
400
Invalid JSON, identity, ID or timingobject
401
Session requiredobject
404
Task or measurement not foundobject
500
Database error; post-dispatch persistence failure explicitly requires queryobject
502
Agent authentication, address, transport, redirect, bounded response or contract errorobject
  • {
      "agent": "<string>",
      "measurement-id": "<string>",
      "record": {},
      "runtime-generation": "<string>",
      "saved": true,
      "status": "<string>",
      "sync-error": "<string>",
      "terminal": true,
      "updated-at": "<string>"
    }
  • {
      "data": {},
      "error": "<string>"
    }
  • {
      "data": {},
      "error": "<string>"
    }
  • {
      "data": {},
      "error": "<string>"
    }
  • {
      "data": {},
      "error": "<string>"
    }
  • {
      "data": {},
      "error": "<string>"
    }