Shawyeok opened a new issue, #4795:
URL: https://github.com/apache/bookkeeper/issues/4795
Is this a question, feature request, bug report, or bookkeeper proposal?
**BUG REPORT**
1. Please describe the issue you observed:
- **What did you do?**
Reviewed the versioned admin REST API documentation pages under
`site3/website/versioned_docs/version-*/admin/http.md` and compared them
against `HttpRouter.java` at the corresponding git tags.
- **What did you expect to see?**
All HTTP endpoints registered in `HttpRouter.java` at a given release tag
should be documented in the corresponding versioned `http.md`.
- **What did you see instead?**
Several endpoints implemented in the code were absent from the versioned
docs. For example:
**version-4.14.8 and version-4.15.5** — missing endpoints:
- `/api/v1/bookie/cluster_info` — returns top-level cluster info (auditor
elected, bookie counts, replication state, etc.)
- `/api/v1/bookie/state/readonly` (GET + PUT) — get or set bookie
read-only state
- `/api/v1/autorecovery/status` (GET + PUT) — get or set autorecovery
enable status
**version-4.16.7 and version-4.17.3** — additionally missing:
- `/api/v1/bookie/state/readonly` (GET + PUT)
- `/api/v1/autorecovery/status` (GET + PUT)
- `forceMajor` / `forceMinor` optional parameters on `PUT
/api/v1/bookie/gc` (introduced alongside `suspend_compaction` /
`resume_compaction` in the 4.16.x line)
Note: `suspend_compaction`, `resume_compaction`, `sanity`, and
`entry_location_compact` were correctly absent from the 4.14.8/4.15.5 docs —
those endpoints were not registered in `HttpRouter.java` until the 4.16.x
release line.
A fix for the four maintained versioned doc versions (4.14.8, 4.15.5,
4.16.7, 4.17.3) is tracked in PR #4793.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
