Liberar las operaciones retenidas tras agotar su presupuesto de intentos salientes

Libera la reserva de transmisión saliente de las operaciones indicadas y las devuelve al backlog elegible para que el siguiente tick de drenaje vuelva a procesarlas. RBAC: connectivity:admin. Es la ÚNICA ruta de recuperación para una operación PARKED. AMBAS etapas salientes aparcan por el MISMO motivo, informado en parkReason como attempt_budget_exhausted: N rechazos consecutivos de la contraparte agotaron el presupuesto de intentos de la operación (SCHEDULE_DISPATCH_MAX_TRANSMIT_ATTEMPTS, valor predeterminado 20). Lo que cambia es la etapa y el estado restante, que la alerta informa en stage: un archivo FORWARD (ASLC022/024/032/061/065 hacia la IF Domicilio) deja la operación ACCEPTED, reprocesada por el tick de forward; un archivo DISPATCH (ASLC027/029/031/060/064 hacia Núclea) la deja QUEUED, reprocesada por el tick de dispatch. El valor permanent_rejection está RETIRADO y ya no se emite — ninguna respuesta 4xx por sí sola aporta evidencia para aparcar un archivo —, pero las alertas históricas aún lo contienen. En ambos casos, la reserva retenida vuelve la operación invisible para todos los drenajes, y cualquier otro verbo administrativo es un callejón sin salida: /advance rechaza la transición sin efecto hacia el mismo estado, /requeue solo admite CREATED, /retry solo admite REJECTED y /retransmit rechaza el estado (una operación forward aparcada está ACCEPTED, no QUEUED) o pierde su propia CAS de reserva y responde 409 in-flight (una operación dispatch aparcada ESTÁ QUEUED). Enumera los ids con GET /v1/operations?transmitHold=parked, la lista canónica, paginada y limitada al tenant; la alerta operation.forward_rejected (payload operationIds) y el campo parked_operation_ids del log ERROR del aparcado son extractos de primera respuesta del mismo conjunto, y el webhook diario solo nombra el primer archivo aparcado ese día. No existe una forma para todo el scope: una reserva de transmisión retenida es AMBIGUA entre una operación aparcada y otra cuyo archivo ya está en Núclea, y solo quien llama decide qué conjunto liberar. Este verbo RECHAZA el segundo tipo con 409 cuando está marcado como tal (transmitHold=in_flight): reconcilia esas operaciones con Núclea y procesa cada una mediante POST /v1/operations//advance; nunca las desaparques. Idempotente: repetir la llamada no libera nada más e informa released=0. Se omiten las reservas con menos del margen de seguridad de 5 minutos, pues pueden pertenecer a una ejecución en pleno envío. La liberación también reinicia el presupuesto de intentos, por lo que una operación recuperada recibe el presupuesto completo en lugar de volver a aparcarse en el siguiente rechazo. Se ejecuta sin locks y no transmite nada.

POST /v1/connectivity/unpark

Liberar las operaciones retenidas tras agotar su presupuesto de intentos salientes

cURL

curl --request POST \
  --url https://slc.sandbox.lerian.net/v1/connectivity/unpark \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "operationIds": [
    "<string>"
  ],
  "confirmedNotAtNuclea": true,
  "reason": "<string>"
}
'

200

{
  "action": "<string>",
  "released": 123,
  "requested": 123,
  "skipped": 123
}

Autorizaciones

Authorization · string · header · requerido

JWT bearer token issued by the identity provider.

Cuerpo

application/json

operationIds · string[] | null · requerido

Parked operation ids to un-park. Enumerate them with GET /v1/operations?transmitHold=parked, which is the authoritative, paginated, tenant-scoped list; the operation.forward_rejected alert (payload operationIds) and the park's ERROR log field parked_operation_ids are first-response excerpts of the same set. 1..500 UUIDs.

Ejemplo:

["018f8a3e-4b2c-7c1a-9e5d-2f6a1b3c4d5e"]

confirmedNotAtNuclea · boolean

Set ONLY after reconciling with Núclea and confirming the file was NOT accepted. Without it, an operation whose transmit hold is in_flight is refused with 409, because releasing it would re-submit an accepted settlement file. With it, those ids are released too and the decision is logged at ERROR with your reason. Núclea's synchronous 202 means "accepted for processing", not settled, so this case is real - but it is the caller's finding, never a default.

Ejemplo:

false

reason · string

How it was confirmed that Núclea did not accept the file. REQUIRED when confirmedNotAtNuclea is true; it is the audit record of who decided to release a possibly-in-flight settlement.

Ejemplo:

"Núclea support ticket 48210: file ASLC022_62313268_20260724_00006 not received; no NUliquid issued."

Respuesta

200

application/json

OK

action · string · requerido

Recovery action that was executed.

Ejemplo:

"unpark"

released · integer<int64> · requerido

Transmit claims actually cleared; these operations are back in the eligible backlog.

Ejemplo:

2

requested · integer<int64> · requerido

Distinct operation ids named in the request.

Ejemplo:

3

skipped · integer<int64> · requerido

Ids that carried no transmit claim (never parked, or already un-parked) or whose claim is younger than the safety floor.

Ejemplo:

1