Artifact Lock Commands

Artifact locks prevent an artifact version from being modified or deleted while work is in progress. A lock can be a system lock, or a user lock tied to a specific user ID.

Lock and Unlock an Artifact

Lock an artifact using its ID, optional category, and version (version defaults to 1):

dshell/SAMPLE:>lock --artifact MyView --category View --version 1

Omit --user to set a system lock. Supplying --user instead sets a user lock tied to that user:

dshell/SAMPLE:>lock --artifact MyView --category View --user jsmith

Remove a lock with unlock, using the same artifact, category, and version used to create it:

dshell/SAMPLE:>unlock --artifact MyView --category View --version 1

List Locks

List every lock currently held in the current tenant:

dshell/SAMPLE:>list-locks

The listing includes the lock ID, lock type, the locked artifact’s ID/category/version, when the lock was created, and the associated user ID (if any).