---
title: "创建实例"
method: POST
path: "/user/instances"
tags: ["用户管理"]
---

# 创建实例

`POST /user/instances`

用户创建新的虚拟机或容器实例（异步处理）

## Request body

- UserCreateInstanceRequest
  - `bandwidthId` string, required — 带宽规格ID
  - `cpuId` string, required — CPU规格ID
  - `description` string — 描述信息
  - `diskId` string, required — 磁盘规格ID
  - `gpuDeviceIds` string — GPU设备ID列表（逗号分隔），为空则附加所有GPU
  - `gpuEnabled` boolean — GPU直通配置（LXD/Incus 原生支持，Docker/Podman/Containerd/Orbstack 尽力通过运行参数附加）
  - `imageId` integer, required — 镜像ID（从数据库获取）
  - `memoryId` string, required — 内存规格ID
  - `providerId` integer, required — 节点ID

## Response `200`

任务创建成功

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

## Other responses

- `400` — 参数错误
- `401` — 用户未登录
- `409` — 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/versions/1f98232296de/schema)