Control one RSVP-TE LSP
/tasks/{id}/rsvp/actionForwards 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.
Контракт
Параметр | Значение |
|---|---|
| Раздел | tasks |
| Авторизация | CookieAuth |
| Принимает | application/json |
| Возвращает | application/json |
Параметры
2 параметров
Имя | Где | Обязательный | Тип | Описание |
|---|---|---|---|---|
| id | path | да | integer | Task ID |
| request | body | да | object | Agent, 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>" }
Ответы
10 ответов
Статус | Описание | Тип |
|---|---|---|
200 | Native action acknowledgment | object |
400 | Invalid request or native option | object |
401 | Session required | object |
403 | Not a routing agent of this task or license denied | object |
404 | Task, LSP, leaf or candidate not found | object |
409 | Task/state/generation/revision conflict | object |
500 | Database or engine error | object |
502 | Agent transport, redirect or response contract error | object |
504 | Agent request deadline exceeded; action outcome is uncertain, query before retry | object |
default | Other native agent HTTP errors are preserved | object |
{}{ "data": {}, "error": "<string>" }{ "data": {}, "error": "<string>" }{ "data": {}, "error": "<string>" }{ "data": {}, "error": "<string>" }{ "data": {}, "error": "<string>" }{ "data": {}, "error": "<string>" }{ "data": {}, "error": "<string>" }{ "data": {}, "error": "<string>" }{}