AgentConnect
Computers

Create a pool computer

Creates a manual managed computer in the deployment’s Kubernetes pool: a Linux desktop pod with its own volume, which registers itself and appears with kind: managed. It is assigned to agents through its agentAccess (here or with PUT /computers/{id}/agent-access), none by default; agents with access share it one at a time under the control lease. It is visible to everyone in the organization unless visibility is restricted, whose sharedWith audience always includes the caller. It sleeps when idle, keeping its volume, wakes on the next use, and stays until it is deleted. The caller becomes its owner. 429 (COMPUTER_QUOTA_EXCEEDED) when the organization is at a managed computer quota (GET /computers/quotas); 503 when the deployment runs no pool or no pool member is connected.

POST
/v1/orgs/{orgId}/computers/pool

授权

bearerAuth
授权Bearer <token>

位置: header

路径参数

orgId*string

请求主体

application/json

TypeScript 定义

在 TypeScript 中使用 request body 类型。

响应主体

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/orgs/string/computers/pool" \  -H "Content-Type: application/json" \  -d '{    "name": "string"  }'
{  "id": "string",  "name": "string",  "ownerUserId": "string",  "kind": "self-hosted",  "isolation": "none",  "os": "macos",  "osVersion": "string",  "session": "aqua",  "status": "online",  "capabilities": {    "screenshot": false,    "input": false,    "textInput": "full",    "humanActivity": "pointer",    "backgroundInput": false,    "accessibilityTree": false,    "viewer": false,    "viewerStun": true,    "egress": true,    "exec": true,    "files": true,    "formFill": true,    "displays": [],    "permissions": {}  },  "doctor": {    "checkedAt": "2019-08-24T14:15:22Z",    "checks": [      {        "name": "string",        "status": "ok",        "detail": "string",        "fix": "string"      }    ]  },  "desktopDaemonVersion": "string",  "driverVersion": "string",  "policy": {    "allowedMembers": [],    "agentMode": "view",    "approvals": {      "firstInputPerSession": true    },    "appAllowlist": [      "string"    ],    "redactApps": [],    "exposeDriverTools": false,    "quietHours": {      "tz": "string",      "ranges": [        "string"      ]    },    "leaseIdleSeconds": 120,    "leaseMaxSeconds": 1800,    "leaseWaitSeconds": 45,    "screenshotRetentionDays": 0,    "viewerPeerToPeer": true,    "shell": "off",    "files": "off",    "fileRoots": [      "string"    ],    "shareBrowserLogins": true  },  "visibility": "org",  "sharedWith": [    "string"  ],  "lastSeenAt": "string",  "revokedAt": "string",  "stoppedAt": "string",  "stoppedByUserId": "string",  "createdAt": "string",  "updatedAt": "string",  "canEdit": true,  "screenshotRetentionDays": -9007199254740991,  "canEditPolicy": true,  "agentAccess": {    "mode": "none",    "agents": []  },  "canEditAgentAccess": true,  "allocation": "ephemeral",  "ownerAgentId": "string",  "poolSessionId": "string",  "poolPhase": "provisioning",  "poolError": "string",  "poolActions": {    "wake": true,    "sleep": true,    "reset": true  },  "lease": {    "sessionId": "string",    "agentId": "string",    "agentName": "string",    "acquiredAt": "string"  },  "waiting": [    {      "sessionId": "string",      "agentId": "string",      "since": "string"    }  ],  "desktops": [    {      "id": "string",      "agentId": "string",      "status": "online",      "lease": {        "sessionId": "string",        "agentId": "string",        "agentName": "string",        "acquiredAt": "string"      },      "waiting": [        {          "sessionId": "string",          "agentId": "string",          "since": "string"        }      ]    }  ]}