Metadata locks

New in version 4.17: Collection metadata support

A locking container is a stateful resource that holds locks for any number of fields of the metadata of an item or collection.

Operations on metadata locks uses {metadata-resource} which is either of

  • /collection
  • /item

Get all containers

GET {metadata-resource}/(id)/metadata-lock

Returns all locking containers.

Produces:
Role:

_metadata_lock_read

Get specific container

GET {metadata-resource}/(id)/metadata-lock/(lock-id)

Returns information about specified locking container.

Produces:
Role:

_metadata_lock_read

Create locking container

POST {metadata-resource}/(id)/metadata-lock

Creates a new locking container, optionally with initial locks.

Query Parameters:
 
  • field – Optional comma-separated list of fields to lock.
  • timeout – Optional integer for time-out in seconds. Default is no time-out.
Produces:
Role:

_metadata_lock_write

Add fields to locking container

PUT {metadata-resource}/(id)/metadata-lock/(lock-id)

Add new fields to the locking container and/or updates the expiry time.

Query Parameters:
 
  • field – Optional comma-separated list of fields to lock.
  • timeout – Optional integer for time-out in seconds. Default is no time-out.
Produces:
Role:

_metadata_lock_write

Remove locking container and locks

DELETE {metadata-resource}/(id)/metadata-lock/(lock-id)

Remove the locking container and all locks associated with it.

Role:_metadata_lock_write