---
title: "连接虚拟化Provider"
method: POST
path: "/provider/connect"
tags: ["虚拟化管理"]
---

# 连接虚拟化Provider

`POST /provider/connect`

连接到虚拟化提供者（如Docker、LXD、Proxmox等）

## Request body

- OneclickvirtServiceProviderConnectProviderRequest
  - `cert_path` string
  - `containerLimitCpu` boolean — 容器资源限制配置（Provider层面）
  - `containerLimitDisk` boolean — 容器是否限制硬盘大小
  - `containerLimitMemory` boolean — 容器是否限制内存大小
  - `container_enabled` boolean
  - `host` string, required
  - `key_path` string
  - `levelLimits` object — 节点级别的等级限制配置 用于限制该节点上不同等级用户能创建的最大资源
  - `name` string, required
  - `networkType` string — 网络配置类型
  - `password` string, required
  - `port` integer — 兼容旧的port字段
  - `sshKey` string — SSH私钥内容，优先于密码使用
  - `sshPort` integer — 新的sshPort字段
  - `token` string — API Token，用于ProxmoxVE等
  - `type` string, required
  - `username` string, required
  - `vmLimitCpu` boolean — 虚拟机资源限制配置（Provider层面）
  - `vmLimitDisk` boolean — 虚拟机是否限制硬盘大小
  - `vmLimitMemory` boolean — 虚拟机是否限制内存大小
  - `vm_enabled` boolean

## Response `200`

连接成功

- CommonResponse
  - `code` integer
  - `data` unknown
  - `message` string
  - `msg` string

## Other responses

- `400` — 参数错误
- `500` — 连接失败

---

[API](https://skmtc.net/oneclickvirt/apis/oneclickvirt-api.md) · [All operations](https://skmtc.net/oneclickvirt/apis/oneclickvirt-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oneclickvirt/oneclickvirt-api/revisions/1f98232296de/schema)
