Lista de errores de Streaming Hub

Busca los códigos de error de Streaming Hub, el estado HTTP que lleva cada uno y qué corregir en la solicitud que lo provocó.

Formato del error

Streaming Hub devuelve la mayoría de los errores como detalles de problema RFC 9457 con el tipo de medio application/problem+json. Solo una respuesta con ese tipo de medio lleva el envelope siguiente:

JSON

{
  "type": "https://errors.lerian.studio/v1/not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "subscription not found",
  "code": "not_found"
}

Definiciones de los campos

• type – Un URI estable y con versión que identifica el tipo de problema. Streaming Hub lo construye como https://errors.lerian.studio/v1/<code> y lo omite para un problema al que no asigna código.
• title – Un resumen breve y legible para personas, que es el texto del estado HTTP (por ejemplo, Not Found).
• status – El código de estado HTTP, reflejado en el cuerpo.
• detail – Una explicación sobre esta ocurrencia.
• code – El token estable, de baja cardinalidad y legible por máquina sobre el que ramificar la lógica. Una falla de validación de la solicitud y una solicitud que no coincide con ninguna ruta llegan con este campo vacío. En esos casos, ramifica sobre status.
• instance – El trace id de la solicitud, cuando Streaming Hub tiene uno.
• errors – Cuando están presentes, las entradas nombran lo que se rechazó. El location de una entrada nombra el campo, por ejemplo event_types/2.

Errores del cliente

---

code	Descripción	Estado
bad_request	La solicitud está mal formada o falta una entrada obligatoria.	400
missing_idempotency_key	La solicitud omite el header X-Idempotency obligatorio. Streaming Hub rechaza la solicitud antes de cualquier escritura.	400
invalid_idempotency_key	El header X-Idempotency tiene más de 2048 bytes.	400
AUT-0006	La solicitud no lleva ningún token.	401
AUT-0007	El token está vencido, es inválido o está mal formado.	401
unauthorized	La solicitud no lleva un contexto de tenant confiable.	401
AUT-1020	La credencial no tiene el permiso. El detail nombra el resource:action rechazado.	403
forbidden	Quien llama está autenticado, pero no tiene permiso para hacer esta solicitud.	403
delegated_relay_refused	Una llamada de socio retransmitida rompe el contrato del gateway, o el hub no tiene fuente de socios para la retransmisión. El detail es el mismo para cada causa.	403
not_found	El recurso está ausente, eliminado de forma lógica, en poder de otro tenant, o es de otro tipo. El token es el mismo para cada uno de estos casos.	404
idempotency_conflict	Hay una solicitud duplicada en curso, o la misma clave X-Idempotency llegó con una huella de solicitud diferente.	409
idempotency_outcome_unrecorded	Una solicitud anterior con esta clave X-Idempotency pudo confirmarse sin un resultado registrado. Lee el recurso antes de enviar cualquier cosa de nuevo.	409
subscription_name_taken	Una suscripción activa en tu ámbito ya usa el name que envía la creación o la edición. El campo existing_id identifica esa suscripción.	409
subscription_stopped_by_hub	Una pausa o una reanudación apuntó a una suscripción que el hub detuvo tras fallos repetidos. Llama a POST /v1/subscriptions/{id}/verify para recuperarla.	409
subscription_changed	La suscripción cambió después de la lectura que devolvió el valor If-Match de una edición. No cambió nada. Vuelve a leer la suscripción y envía la edición con una nueva clave X-Idempotency.	412
validation_error	La solicitud lleva una falla de forma corregible por quien llama: un sink_kind incorrecto, o un endpoint, schema o valor de event_types inválido. Un período del dashboard que empieza antes del historial retenido también devuelve este código, con details que llevan coverage_start y snapshot_at.	422
unknown_event_type	Un valor de event_types no tiene entrada en el catálogo en el schema major en el que la suscripción lo recibe. Cada entrada de errors nombra un tipo rechazado y su major.	422
event_type_outside_nature	Un valor de event_types nombra un tipo de evento que la credencial delegada nunca recibe.	422
inline_sink_config_forbidden	Una solicitud de creación llevaba material sink_config o credential en línea. Envía una credencial de cola a través de PUT /v1/subscriptions/{id}/credential en su lugar.	422
destination_probe_failed	El endpoint nuevo de una edición no respondió al sondeo, y no cambió nada. La respuesta lleva error_class y, en un webhook, status_code.	422
endpoint_blocked	El host resuelto está bloqueado, es privado o es una dirección de metadatos, o la URL lleva información de usuario incorporada. Proporciona un endpoint público que no contenga ninguna credencial. En BYOC, un webhook o un broker RabbitMQ en una dirección privada se acepta cuando la operación de Lerian autoriza el host, y el puerto AMQP en RabbitMQ. El hub multi-tenant rechaza un broker RabbitMQ privado, y SQS y EventBridge nunca reciben una autorización.	422
no_secret_to_rotate	Una rotación de secreto tuvo como destino una suscripción que no tiene ningún secreto de firma.	422
probe_unsupported_for_sink_kind	La operación no tiene prueba para esta suscripción: ping en una suscripción que no es webhook, o verify en una suscripción pull o en una suscripción de cola sin credencial y sin concesión delegada que probar.	422
rate_limited	La cuota del tenant para esta lectura se agotó. Espera los segundos de Retry-After y vuelve a intentarlo.	429

Errores del servidor

---

code	Descripción	Estado
internal_error	Una falla de infraestructura. Streaming Hub reemplaza detail por internal error y registra la causa.	500
internal_error	Streaming Hub todavía está arrancando, y la solicitud llegó a una ruta antes del primer éxito de arranque. detail es internal error. Espera los segundos de Retry-After y vuelve a intentar.	503
idempotency_outcome_unrecorded	La mutación pudo confirmarse, y su resultado no quedó registrado. Lee el recurso antes de enviar cualquier cosa de nuevo.	500
AUT-0033	Access Manager no decidió la solicitud. Espera los segundos de Retry-After y vuelve a intentarlo.	503
rate_limiter_unavailable	Streaming Hub no puede verificar la cuota del tenant para esta lectura. Espera los segundos de Retry-After y vuelve a intentarlo.	503
delegated_party_unconfirmed	Streaming Hub todavía no puede confirmar la parte delegada de esta suscripción de pull. Espera los segundos de Retry-After y vuelve a intentarlo.	503
read_timeout	Una lectura del dashboard o de la salud de entrega agotó su presupuesto de tiempo. La respuesta no tiene Retry-After. Vuelve a intentarlo más tarde.	503
dns_unavailable	La consulta DNS del host del endpoint falló durante una creación o una edición. No se escribió nada. Vuelve a intentarlo con la misma clave X-Idempotency.	503
AUT-1021	Access Manager no respondió a tiempo. Vuelve a intentar la solicitud.	504
dns_timeout	La consulta DNS del host del endpoint venció durante una creación o una edición. No se escribió nada. Vuelve a intentarlo con la misma clave X-Idempotency.	504