Control selected RSVP-TE protocol instances

POST

/tasks/{id}/rsvp/protocol/sessions/control

Selects 1-64 profile-indexed protocol instances by an array or semicolon-separated range string. All selected sessions are read and generation-checked before ordered dispatch through the existing agent CPF control. A failed or uncertain member stops further dispatch; response records accepted, failed, unknown and not-attempted members. Never retry an unknown result without querying current state. This local index scheme is not claimed to match exact IxNetwork device numbering or atomicity.

Контракт

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

Параметры

2 параметров

Имя	Где	Обязательный	Тип	Описание
id	path	да	integer	Canonical positive task ID
request	body	да	object	Agent, profile revision, runtime generation, session indices and CPF action

Параметр request: object

{
  "action": "stop",
  "agent": "<string>",
  "expected-profile-revision": "<string>",
  "runtime-generation": "<string>",
  "session-indices": {}
}

Ответы

9 ответов

Статус	Описание	Тип
200	All selected instances accepted	object
207	Partial or unknown result	object
400	Invalid selection	object
401	Session required	object
403	Agent not registered for this task	object
404	Task not found	object
409	Profile, task or runtime generation changed before dispatch	object
500	Task lookup failed	object
502	Agent preflight read failed	object

Ответ 200: object

{
  "action": "<string>",
  "agent": "<string>",
  "members": [
    {
      "http-status": 0,
      "index": 0,
      "instance": 0,
      "response": {},
      "status": "accepted"
    }
  ],
  "profile-revision": "<string>",
  "runtime-generation": "<string>",
  "state": "complete",
  "task-id": 0
}

Ответ 207: object

{
  "action": "<string>",
  "agent": "<string>",
  "members": [
    {
      "http-status": 0,
      "index": 0,
      "instance": 0,
      "response": {},
      "status": "accepted"
    }
  ],
  "profile-revision": "<string>",
  "runtime-generation": "<string>",
  "state": "complete",
  "task-id": 0
}

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