Read RSVP-TE LSP state

POST

/tasks/{id}/rsvp/query

Includes an opaque profile-revision for persistent Path Apply. Reads one complete P2P/P2MP identity on one named routing agent of a RUNNING task. P2P send-detour=true selects the detached ingress detour for observation; omitting the role selects primary. Preserves native anchor/active state, learned information and counters without float conversion. When supplied by the agent, read-started-at/read-completed-at bracket its sequential native reads; they do not make an atomic RSVP FSM snapshot. No fan-out or legacy AgentIPs fallback.

Contract

Parameter	Value
Section	tasks
Authentication	CookieAuth
Consumes	application/json
Produces	application/json

Parameters

2 parameters

Name	Location	Required	Type	Description
id	path	yes	integer	Task ID
request	body	yes	object	Agent hostname and full LSP identity; body at most 64 KiB

Parameter request: object

{
  "agent": "<string>",
  "identity": {
    "accept-detour": true,
    "endpoint": "<string>",
    "ext-tunnel-id": "<string>",
    "instance": 0,
    "kind": "p2p",
    "lsp-id": 0,
    "p2mp-id": 0,
    "send-detour": true,
    "sender": "<string>",
    "tunnel-id": 0
  }
}

Responses

10 responses

Status	Description	Type
200	OK	object
400	Invalid ID, JSON or identity; native request error	object
401	Session required	object
403	Not a routing agent of this task or license denied	object
404	Task or LSP not found	object
409	Task/agent is not running, stopping or runtime changed	object
500	Database or engine error	object
502	Agent transport, address, redirect, response limit or response contract error	object
504	Agent request deadline exceeded	object
default	Other native agent HTTP errors are preserved	object

Response 200: object

{
  "active": {},
  "active-observed-lsp-id": 0,
  "anchor": {},
  "identity": {
    "accept-detour": true,
    "endpoint": "<string>",
    "ext-tunnel-id": "<string>",
    "instance": 0,
    "kind": "p2p",
    "lsp-id": 0,
    "p2mp-id": 0,
    "send-detour": true,
    "sender": "<string>",
    "tunnel-id": 0
  },
  "profile-revision": "<string>",
  "read-completed-at": "<string>",
  "read-started-at": "<string>",
  "runtime-generation": "<string>",
  "snapshot-atomic": true,
  "task-id": 0
}

{ "data": {}, "error": "<string>" }
{ "data": {}, "error": "<string>" }
{ "data": {}, "error": "<string>" }
{ "data": {}, "error": "<string>" }
{ "data": {}, "error": "<string>" }
{ "data": {}, "error": "<string>" }
{ "data": {}, "error": "<string>" }
{ "data": {}, "error": "<string>" }
{}