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

# 创建实例

`POST /provider/{id}/instances`

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

## Path parameters

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

## Request body

- OneclickvirtServiceProviderCreateInstanceRequest
  - `cpu` string
  - `disk` string
  - `env` object
  - `image` string
  - `image_path` string — 镜像文件路径
  - `image_url` string — 镜像下载URL
  - `instance_type` string — container 或 vm
  - `memory` string
  - `metadata` object
  - `name` string
  - `network` string
  - `ports` string[]
  - `systemImageId` integer — 系统镜像ID

## Response `200`

创建成功

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

## Other responses

- `400` — 参数错误
- `404` — Provider不存在
- `500` — 创建失败

---

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