---
title: "创建实例"
method: POST
path: "/provider/{id}/instances"
tags: ["虚拟化管理"]
---

# 创建实例

`POST /provider/{id}/instances`

在指定Provider上创建新的虚拟机或容器实例

## Path parameters

- `type` 'docker' | 'lxd' | 'incus' | 'proxmox', required

## Request body

- OneclickvirtServiceProviderCreateInstanceRequest
  - `allowNesting` boolean — 容器嵌套
  - `copyMode` boolean — 复制模式（LXD/Incus 与 Docker/Podman/Containerd/Orbstack 容器节点）
  - `copySourceName` string — 复制模式下的源容器名称
  - `cpu` string
  - `cpuAllowance` string — CPU限制
  - `disk` string
  - `diskIoLimit` string — 磁盘IO限制
  - `enableLxcfs` boolean — LXCFS资源视图
  - `env` object
  - `gpuDeviceIds` string — GPU设备ID列表（逗号分隔），为空则附加所有GPU
  - `gpuEnabled` boolean — GPU直通配置（LXD/Incus 原生支持，Docker/Podman/Containerd/Orbstack 尽力通过运行参数附加）
  - `image` string
  - `image_path` string — 镜像文件路径
  - `image_url` string — 镜像下载URL
  - `instance_type` string — container 或 vm
  - `maxProcesses` integer — 最大进程数
  - `memory` string
  - `memorySwap` boolean — 内存交换
  - `metadata` object
  - `name` string
  - `network` string
  - `ports` string[]
  - `privileged` boolean — 容器特殊配置选项（仅适用于 LXD 和 Incus 的容器实例）
  - `readIoLimit` string — 磁盘读取速率限制
  - `systemImageId` integer — 系统镜像ID
  - `use_cdn` boolean — 是否使用CDN加速下载镜像
  - `writeIoLimit` string — 磁盘写入速率限制

## Response `200`

创建成功

- object
  - `code` integer
  - `data` object
  - `message` string
  - `msg` string

## Other responses

- `400` — 参数错误
- `404` — Provider不存在
- `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)