Endpoint

/v1/files/locks/nlm/byte-range/waiters/

GET

Return a list of all NLM byte range requests currently waiting on the specified machine.

Parameters

Name Description Required
owner_name The lock owner's name. The client provides the name. Typically, it is the client hostname. No
owner_address The waiter's address. The IP address of the machine (the waiter) that sends the lock request. If the machine's IP address changes, any outstanding requests are still listed under the old address. No
after Return entries after the given key (keys are returned in the paging object) No
limit Return no more than this many entries; the system may choose a smaller limit. No

Response

Codes

Code Description
200 Return value on success

Schema

{
  "description": "api_byte_range_waiters",
  "type": "object",
  "properties": {
    "waiters": {
      "type": "array",
      "items": {
        "description": "waiters",
        "type": "object",
        "properties": {
          "file_id": {
            "description": "file_id",
            "type": "string"
          },
          "stream_id": {
            "description": "stream_id",
            "type": "string"
          },
          "snapshot_id": {
            "description": "The locked file's snapshot ID. Empty if the file is at the head version (not from a snapshot).",
            "type": "string"
          },
          "mode": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "API_BYTE_RANGE_EXCLUSIVE",
                "API_BYTE_RANGE_SHARED",
                "API_BYTE_RANGE_READ_OP",
                "API_BYTE_RANGE_WRITE_OP"
              ],
              "description": "mode:\n * `API_BYTE_RANGE_EXCLUSIVE` - API_BYTE_RANGE_EXCLUSIVE,\n * `API_BYTE_RANGE_READ_OP` - API_BYTE_RANGE_READ_OP,\n * `API_BYTE_RANGE_SHARED` - API_BYTE_RANGE_SHARED,\n * `API_BYTE_RANGE_WRITE_OP` - API_BYTE_RANGE_WRITE_OP"
            }
          },
          "offset": {
            "description": "offset",
            "type": "string"
          },
          "size": {
            "description": "size",
            "type": "string"
          },
          "owner_id": {
            "description": "The unique identifier for the process that owns the file lock.",
            "type": "string"
          },
          "owner_name": {
            "description": "The name of the machine that owns the lock.",
            "type": "string"
          },
          "owner_address": {
            "description": "The IP address to use for acquiring the file lock.",
            "type": "string"
          },
          "node_address": {
            "description": "The IP address of the node that receives the request.",
            "type": "string"
          }
        }
      }
    }
  }
}