Get Cluster Locks

Returns the advisory locks currently held across the cluster, for diagnosing stuck or long-held locks without database access.

The responding node reports its own locks and, when HA is enabled, fans out to the other running members; one that does not answer is reported as unreachable. The result is a best-effort snapshot, not an atomic one.

Note: This API is available only in Self-hosted instances. It requires PostgreSQL with native (advisory) locking, otherwise returns 503. Advisory locks are session-scoped, so a dead node releases its locks automatically. Background job synchronization still uses the legacy distributed_locks table, and those locks are never reported here.

Since: 7.161.x

Security: Requires a valid admin user.

To enable advisory locks, see: https://docs.jfrog.com/installation/docs/configure-artifactory-to-use-advisory-locks-in-postgresql

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
📘

Note

This REST API is available for self-managed Artifactory deployments from version 7.161.15.


Query Params
string
length ≥ 1

Return only locks with exactly this category, on every node in the response. When omitted, all categories are returned.

Responses

401

Bad Credentials - Invalid credentials

403

Permission Denied - Insufficient permissions

503

Service Unavailable - Native advisory locks are not active on this node

Language
Credentials
Bearer
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json