From 7020f6ac4bd60cd0bc71f39b3c74d60701174c9a Mon Sep 17 00:00:00 2001 From: Tim Geoghegan Date: Mon, 26 Oct 2026 11:10:09 -0700 Subject: [PATCH] Document error types for Janus 0.9 0.9.x version of Janus can use new custom error types defined by Divvi Up, introduced in https://github.com/divviup/janus/pull/4915. This commit adds documentation for those errors corresponding to the problem documents Janus constructs, and does a little bit of wordsmithing on existing error docs. --- docs/references/janus-errors.md | 17 +++++++++++++++-- 1 file changed, 15 insertions(+), 2 deletions(-) diff --git a/docs/references/janus-errors.md b/docs/references/janus-errors.md index 65254ae..7b674e7 100644 --- a/docs/references/janus-errors.md +++ b/docs/references/janus-errors.md @@ -39,12 +39,19 @@ an aggregation job that has been deleted. The [DAP specification][agg-job-deletion] states that if a leader must abandon an aggregation job, it should delete that resource in the helper to let it clean up its resources. The Janus leader does this, and the Janus helper supports -`DELETE` requests on an aggregation job URI. Deleted aggregation jobs may not be -acted upon further and any further attempts to run that job will fail. +`DELETE` requests on an aggregation job URI. Further attempts to run or +otherwise act upon deleted aggregation jobs will fail. [agg-job-deletion]: https://datatracker.ietf.org/doc/html/draft-ietf-ppm-dap-09#name-helper-continuation +### Collection Job Deleted + +This error occurs if a Janus leader receives a request to act on a collection +job that has been deleted with a `DELETE` request to the collection job URI. + +Further attempts to run or otherwise act upon deleted collection jobs will fail. + ### Aggregate Share ID Unrecognized This error occurs if a Janus helper receives an asynchronous polling request for @@ -87,6 +94,12 @@ The request attempted to change a resource that is immutable once created by re- using the identifier but with different parameters. (Note that re-sending the original request verbatim is always safe.) +### Collection Job Request Rejected + +A Janus leader has declined to create a collection job for the requested batch. +It may be the case that the batch is old enough to be eligible for garbage +collection, which is then refused to prevent replay. + ### Aggregate Share Request Rejected A Janus helper has declined to produce an aggregate share for the requested