Skip to content

Docs: Add documentation for undocumented admin API endpoints#40

Open
Vivek1106-04 wants to merge 1 commit intoapache:masterfrom
Vivek1106-04:docs/api-endpoints-documentation
Open

Docs: Add documentation for undocumented admin API endpoints#40
Vivek1106-04 wants to merge 1 commit intoapache:masterfrom
Vivek1106-04:docs/api-endpoints-documentation

Conversation

@Vivek1106-04
Copy link

Summary

This PR adds comprehensive documentation for several admin API endpoints that were previously undocumented in api.md.

Changes

Added documentation for the following endpoints:

  • /admin/cluster - Cluster state and configuration
  • /admin/cluster/node/{node-id} - Node-specific information and configuration
  • /admin/requests/running - List and cancel running requests
  • /admin/diagnostics - System diagnostics information
  • /admin/version - AsterixDB version information
  • /admin/shutdown - Cluster shutdown (all nodes or specific node)
  • /admin/rebalance - Data rebalancing operations
  • /admin/storage - Storage information (NC-level endpoint)
  • /admin/udf - User-defined function management (NC-level endpoint)

Testing

Documentation-only change. Verified endpoint behavior by reviewing servlet implementations in:

  • ClusterApiServlet.java
  • NodeControllerDetailsApiServlet.java
  • ActiveRequestsServlet.java
  • DiagnosticsApiServlet.java
  • VersionApiServlet.java
  • ShutdownApiServlet.java
  • RebalanceApiServlet.java
  • StorageApiServlet.java
  • NCUdfApiServlet.java

Related

  • JIRA: ASTERIXDB-3695
  • First contribution as part of GSoC project for LLM Agent Protocols

- Add documentation for /admin/cluster and /admin/cluster/node endpoints
- Add documentation for /admin/requests/running endpoint (list and cancel)
- Add documentation for /admin/diagnostics endpoint
- Add documentation for /admin/version endpoint
- Add documentation for /admin/shutdown endpoint
- Add documentation for /admin/rebalance endpoint
- Add documentation for /admin/storage endpoint (NC-level)
- Add documentation for /admin/udf endpoint

Change-Id: Id75c86758d7b6a32506acd4108b7608e50c2d920
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant