---
title: "创建系统镜像"
method: POST
path: "/admin/system-images"
tags: ["系统镜像管理"]
---

# 创建系统镜像

`POST /admin/system-images`

创建新的系统镜像配置

## Request body

- SystemCreateSystemImageRequest
  - `architecture` 'amd64' | 'arm64' | 's390x', required
  - `checksum` string
  - `description` string
  - `instanceType` 'vm' | 'container', required
  - `minDiskMB` integer, required
  - `minMemoryMB` integer, required
  - `name` string, required
  - `osType` string
  - `osVersion` string
  - `providerType` 'proxmox' | 'lxd' | 'incus' | 'docker' | 'podman' | 'containerd' | 'orbstack' | 'qemu' | 'kubevirt' | 'vmware' | 'virtualbox' | 'multipass' | 'vagrant', required
  - `size` integer
  - `tags` string
  - `url` string, required
  - `useCdn` boolean

## Response `200`

创建成功

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

## Other responses

- `400` — 请求参数错误
- `401` — 认证失败
- `409` — 镜像名称已存在
- `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)