Add and persist one RSVP-TE P2P ingress LSP or P2MP ingress tree

POST

/tasks/{id}/rsvp/topology/create

Applies one materialized P2P LSP or one P2MP tree to a RUNNING routing agent. For a paired P2P ingress detour, send-detour=true distinguishes it from its protected primary despite their shared RSVP wire key. Requires the saved profile revision, current runtime generation, full wire identity and a unique 32-digit lowercase hexadecimal operation ID. Native dry-run precedes durable admission. 202 is only admission; poll topology/query until persisted. The journal marks dispatch before the one native request. After a lost response or Core restart, recovery only queries the LSP twice and requires the same native create-operation-id and generation before atomically saving the new task profile. No blind resend or fixed-label create.

Контракт

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

Параметры

2 параметров

Имя	Где	Обязательный	Тип	Описание
id	path	да	integer	Task ID
request	body	да	object	One complete P2P LSP and current guards, at most 64 KiB

Параметр request: object

{
  "agent": "<string>",
  "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
  },
  "lsp": {},
  "operation-id": "<string>",
  "runtime-generation": "<string>"
}

Ответы

9 ответов

Статус	Описание	Тип
202	Durable admission; query terminal status	object
400	Invalid identity, LSP or guard	object
401	Session required	object
403	Agent is not registered for this task or license denied	object
404	Task or RSVP instance not found	object
409	Task, profile, runtime or operation conflict	object
500	Database failure	object
502	Agent transport or response contract failure before admission	object
default	Native validation errors are preserved	object

Ответ 202: object

{
  "agent": "<string>",
  "created-at": "<string>",
  "dispatched": true,
  "expires-at": "<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
  },
  "operation-id": "<string>",
  "reason": "<string>",
  "runtime-generation": "<string>",
  "status": "<string>",
  "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>" }
{}