{ "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." } ] } } }