~ knotless Search/
↑↓ move↵ open⇧↵ all results

socialweb.computer/socialweb-computer-kcp

socialweb.computer: a compute market on atproto (kcp)

1 collaborator
0
0
64 lines · 1.9 KB Raw History
{
  "lexicon": 1,
  "id": "com.fedfork.exec.ops.getVmMemory",
  "defs": {
    "main": {
      "type": "query",
      "description": "A bidder answers the memory cgroup figures of one of its VMs' units. Read only (GET). Served only when the host has an ops read secret configured (else 404); requires it as Authorization: Bearer.",
      "parameters": {
        "type": "params",
        "required": [
          "name"
        ],
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 63,
            "description": "A ComputeVM name (a DNS label)."
          }
        }
      },
      "output": {
        "encoding": "application/json",
        "schema": {
          "type": "object",
          "required": [
            "unit",
            "current",
            "high",
            "max",
            "swapMax",
            "events"
          ],
          "properties": {
            "unit": {
              "type": "string"
            },
            "current": {
              "type": "integer"
            },
            "high": {
              "type": "string"
            },
            "max": {
              "type": "string"
            },
            "swapMax": {
              "type": "string"
            },
            "events": {
              "type": "unknown",
              "description": "memory.events: name to count."
            }
          }
        }
      },
      "errors": [
        { "name": "AuthenticationRequired", "description": "401: the ops read secret is missing or wrong." },
        { "name": "InvalidRequest", "description": "400: name is not a ComputeVM name (a DNS label of at most 63 characters)." },
        { "name": "NotFound", "description": "404: the host has no unit or no readable memory cgroup for that VM." },
        { "name": "ReadFailed", "description": "502: the read failed; the host's log has the detail." }
      ]
    }
  }
}