Skip to main content

Control one RSVP-TE LSP

POST
/tasks/{id}/rsvp/action

Forwards a sealed LSP action to one named routing agent of a RUNNING task. Requires runtime-generation from the latest query, full identity and native options. A detached P2P send-detour identity is read-only here; topology/delete removes it by its own receipt. pcep-delegate/pcep-revoke select one configured P2P ingress LSP, require no options and need negotiated PCEP updates; PCE-created LSP ownership uses PCInitiate. traffic-start/traffic-stop require exactly one quoted decimal options.flow-id for a source bound to the selected LSP. mbb-periodic-start/stop apply only to P2P; start requires interval-ms, lsp-id-start and lsp-id-end. P2MP graft/prune/reopt are restricted to P2MP. Path Apply requires active LSP and path revision guards. Native status/body are preserved; requests are never retried and redirects are never followed.

Contract

Parameter
Value
Sectiontasks
AuthenticationCookieAuth
Consumesapplication/json
Producesapplication/json

Parameters

2 parameters

Name
Location
Required
Type
Description
idpathyesintegerTask ID
requestbodyyesobjectAgent, full identity, current runtime generation, action and options; body at most 64 KiB
  • {
      "action": "start",
      "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
      },
      "options": {},
      "runtime-generation": "<string>"
    }

Responses

10 responses

Status
Description
Type
200
Native action acknowledgmentobject
400
Invalid request or native optionobject
401
Session requiredobject
403
Not a routing agent of this task or license deniedobject
404
Task, LSP, leaf or candidate not foundobject
409
Task/state/generation/revision conflictobject
500
Database or engine errorobject
502
Agent transport, redirect or response contract errorobject
504
Agent request deadline exceeded; action outcome is uncertain, query before retryobject
default
Other native agent HTTP errors are preservedobject
  • {}
  • {
      "data": {},
      "error": "<string>"
    }
  • {
      "data": {},
      "error": "<string>"
    }
  • {
      "data": {},
      "error": "<string>"
    }
  • {
      "data": {},
      "error": "<string>"
    }
  • {
      "data": {},
      "error": "<string>"
    }
  • {
      "data": {},
      "error": "<string>"
    }
  • {
      "data": {},
      "error": "<string>"
    }
  • {
      "data": {},
      "error": "<string>"
    }
  • {}