Locks

Force release a project lock

Changed on

Drops the lease whatever token holds it, for recovering a lock whose holder died without releasing. Use DELETE /locks/{key}/lease for normal release.

This breaks mutual exclusion by itself: the previous holder keeps working until its own renewal fails. Guard the protected resource with the lease's fencing_token, which the next acquisition raises, so a write from the displaced holder can be rejected. Succeeds when the lock is already absent.

delete/locks/{key}

Request

  • Base URL: https://api.volcano.dev
  • URL: https://api.volcano.dev/locks/{key}
  • Auth: HTTP bearer

Path parameters

keystring required

Project-local lock name.

Headers

X-Volcano-Request-Idstring uuid required

UUID correlating this request across client and server logs. Repeat safety comes from the lock token, so a retry under a reused request ID still counts against the quota.

Response

Lock released

Changes

    • ▲

      the response's body type changed from no type to object for status

    • ▲

      the response's body type changed from no type to object for status

    • ▲

      the response's body type changed from no type to object for status

    • ▲

      the response's body type changed from no type to object for status

    • ▲

      the response's body type changed from no type to object for status

    • ○

      added the optional property to the response with the status

    • ○

      added the optional property to the response with the status

    • ○

      added the optional property to the response with the status

    • ○

      added the optional property to the response with the status

    • ○

      added the optional property to the response with the status

    • ○

      added the required property to the response with the status

    • ○

      added the required property to the response with the status

    • ○

      added the required property to the response with the status

    • ○

      added the required property to the response with the status

    • ○

      added the required property to the response with the status

    • ○

      endpoint added