namespaces

List namespaces

Retrieve the list of all namespaces the caller has permission to see. Callers without any applicable manage_namespaces permission receive an empty list rather than 403.

get/namespaces

Request

  • Base URL: https://localhost:8080/v1
  • URL: https://localhost:8080/v1/namespaces
  • Auth: one of:
    • none
    • OAuth 2 (implicit, authorization URL http://to-be-configured-in-the-application-config)

Response

Successfully retrieved the list of namespaces (possibly empty).

namestring

The unique name of the namespace.

home_nodestring

The cluster node where this namespace's shards are placed. Set at create time and updatable later. Updating it only affects future placement decisions; existing live shards are not moved.

state'active' | 'suspended' | 'resuming' | 'deleting'

Lifecycle state. "active" namespaces accept all operations. "suspended" namespaces reject new classes, aliases, users, roles, and role assignments, and their users can no longer authenticate; everything the namespace already owns is retained. "resuming" namespaces are on their way back to "active" and are still restricted the same way. "deleting" namespaces are being removed: new classes, aliases, and users can no longer be created in the namespace, and the namespace itself disappears once removal completes.

Changes

No recorded changes to this operation across all 1 revision of this API.