Metadata locks

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

Get all containers

GET /item/(id)/metadata-lock

Returns all locking containers.

Produces:
Role:

_metadata_lock_read

Get specific container

GET /item/(id)/metadata-lock/(lock-id)

Returns information about specified locking container.

Produces:
Role:

_metadata_lock_read

Create locking container

POST /item/(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 /item/(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 /item/(id)/metadata-lock/(lock-id)

Remove the locking container and all locks associated with it.

Role:_metadata_lock_write