Sha256: d6e3a45351cb4542a1009d92e7ca05c105540e29d1e00cc0288c8657ae0ef6c5

Contents?: true

Size: 1.79 KB

Versions: 65

Compression:

Stored size: 1.79 KB

Contents

# Lock

## Example Lock Object

```
{
  "path": "locked_file",
  "timeout": 43200,
  "depth": "infinity",
  "owner": "user",
  "scope": "shared",
  "token": "17c54824e9931a4688ca032d03f6663c",
  "type": "write",
  "user_id": 1,
  "username": ""
}
```

* `path` (string): Path This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
* `timeout` (int64): Lock timeout
* `depth` (string): Lock depth (0 or infinity)
* `owner` (string): Owner of lock.  This can be any arbitrary string.
* `scope` (string): Lock scope(shared or exclusive)
* `token` (string): Lock token.  Use to release lock.
* `type` (string): Lock type
* `user_id` (int64): Lock creator user ID
* `username` (string): Lock creator username


---

## List Locks by path

```
Files::Lock.list_for(path, 
  per_page: 1, 
  include_children: true
)
```

### Parameters

* `cursor` (string): Used for pagination.  Send a cursor value to resume an existing list from the point at which you left off.  Get a cursor from an existing list via the X-Files-Cursor-Next header.
* `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
* `path` (string): Required - Path to operate on.
* `include_children` (boolean): Include locks from children objects?


---

## Create Lock

```
Files::Lock.create(path, 
  timeout: 1
)
```

### Parameters

* `path` (string): Required - Path
* `timeout` (int64): Lock timeout length


---

## Delete Lock

```
Files::Lock.delete(path, 
  token: "token"
)
```

### Parameters

* `path` (string): Required - Path
* `token` (string): Required - Lock token


---

## Delete Lock

```
lock = Files::Lock.list_for(path).first

lock.delete(
  token: "token"
)
```

### Parameters

* `path` (string): Required - Path
* `token` (string): Required - Lock token

Version data entries

65 entries across 65 versions & 1 rubygems

Version Path
files.com-1.0.186 docs/lock.md
files.com-1.0.185 docs/lock.md
files.com-1.0.184 docs/lock.md
files.com-1.0.183 docs/lock.md
files.com-1.0.182 docs/lock.md
files.com-1.0.181 docs/lock.md
files.com-1.0.180 docs/lock.md
files.com-1.0.179 docs/lock.md
files.com-1.0.178 docs/lock.md
files.com-1.0.177 docs/lock.md
files.com-1.0.176 docs/lock.md
files.com-1.0.175 docs/lock.md
files.com-1.0.174 docs/lock.md
files.com-1.0.173 docs/lock.md
files.com-1.0.172 docs/lock.md
files.com-1.0.171 docs/lock.md
files.com-1.0.170 docs/lock.md
files.com-1.0.169 docs/lock.md
files.com-1.0.168 docs/lock.md
files.com-1.0.167 docs/lock.md