Sign in
Locks

Renew a project lock

Changed on

Renews a lease owned by the supplied lock token. The request must arrive more than one second before expires_at; this safety margin prevents clock skew between regional API instances from resurrecting an expired lease.

patch/locks/{key}/lease

Request

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

Path parameters

keystring required

Project-local lock name.

Headers

X-Volcano-Lock-Tokenstring uuid required

Opaque UUID generated once by the caller and retained for the lease lifetime.

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.

Request body

ttl_secondsinteger required

Lease duration in seconds, from 5 seconds through 90 days, measured from when the request is served. Renew before it elapses. A renewal sets the new expiry outright, so a shorter TTL shortens the lease. Renewals cannot extend an acquisition beyond its absolute 90-day deadline.

Response

Lease renewed

expires_atstring date-time required

Advisory lease expiry timestamp in UTC.

fencing_tokeninteger required

Monotonically increasing token for this acquisition. It rises whenever the lock changes hands and stays the same across renewals of one lease. Pass it to the resource you are protecting and reject any write carrying a token lower than the highest already seen; that is what stops a displaced holder from writing after its lease lapsed.

Changes

  • 3a6f365f3f35Revision 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

    • ▲

      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 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

    • ○

      added the required property to the response with the status

  • bb44e98aba2eRevision changes
    • ○

      endpoint added