Apply and persist one RSVP-TE Path

POST

/tasks/{id}/rsvp/path/apply

Validates one complete configured ingress LSP on a registered RUNNING routing agent. Requires the profile hash from query, current native generation/active ID/Path revision and a client operation ID (32 lowercase hex digits). Omit mbb for an in-place Path update. With mbb, supply all Path parameters, P2P ERO or the complete P2MP leaf-routes, current attempts and candidate ID/range; topology/interface changes are not supported. MBB dry-run selects a candidate and returns its effective P2P ERO or P2MP leaf routes, sealed before one explicit-ID dispatch. User input routes remain in the saved profile; normalized native routes are used only for completion proof. 202 is admission, not success: poll path/query until terminal. MBB persisted requires matching operation ID, attempt, completed retirement and requested parameters in two native observations, followed by an atomic task-profile CAS. Rollback/Stop does not save the new profile. Recovery only queries and never replays actions. Neighbour range identities/session names and product port bindings are preserved; the configured anchor LSP ID remains unchanged after MBB.

Контракт

Параметр	Значение
Раздел	tasks
Авторизация	CookieAuth
Принимает	application/json
Возвращает	application/json

Параметры

2 параметров

Имя	Где	Обязательный	Тип	Описание
id	path	да	integer	Task ID
request	body	да	object	Sealed Path Apply request, at most 64 KiB

Параметр request: object

{
  "agent": "<string>",
  "expected-active-lsp-id": 0,
  "expected-path-revision": 0,
  "expected-profile-revision": "<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
  },
  "mbb": {
    "expected-mbb-attempts": 0,
    "lsp-id-end": 0,
    "lsp-id-start": 0,
    "new-lsp-id": 0,
    "retire-delay-ms": 0,
    "setup-timeout-ms": 0,
    "switch-delay-ms": 0
  },
  "operation-id": "<string>",
  "path": {},
  "runtime-generation": "<string>"
}

Ответы

9 ответов

Статус	Описание	Тип
202	Saved operation; query terminal status	object
400	Invalid identity, guards, Path or configured range	object
401	Session required	object
403	Agent is not registered for the task or license denied	object
404	Task, agent or LSP not found	object
409	Task, runtime, profile or operation conflicts	object
500	Database failure	object
502	Agent transport, redirect or response contract failure before admission	object
default	Other native validation HTTP errors are preserved	object

Ответ 202: object

{
  "active-lsp-id": 0,
  "agent": "<string>",
  "created-at": "<string>",
  "dispatched": true,
  "expires-at": "<string>",
  "identity": {},
  "mbb": {
    "before-completed": 0,
    "before-rollbacks": 0,
    "previous-active-lsp-id": 0,
    "target-attempt": 0
  },
  "mode": "path",
  "operation-id": "<string>",
  "reason": "<string>",
  "runtime-generation": "<string>",
  "status": "<string>",
  "target-path-revision": 0,
  "task-id": 0,
  "terminal": true,
  "updated-at": "<string>"
}

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