---
title: "写入镜像到当前槽位的 init_boot 或 boot 分区"
method: PUT
path: "/system/boot"
tags: ["系统"]
---

# 写入镜像到当前槽位的 init_boot 或 boot 分区

`PUT /system/boot`

写入提供的镜像，并用零填充目标分区剩余空间

如果请求体为空，后端会从 `url` 查询参数下载镜像

## Query parameters

- `url` string, uri

## Response `204`

镜像已写入

## Other responses

- `400` — 未提供请求体、请求体读取失败、下载地址无效、下载结果为空、文件无效
- `403` — 鉴权失败，或 WebSocket 票证无效
- `410` — 未找到支持的启动分区
- `413` — 请求体或下载内容过大
- `500` — 后端执行操作失败
- `502` — JVM 交互失败、下载响应失败、远端返回非成功状态或响应内容无法解析
- `503` — JVM 服务不可用

---

[API](https://skmtc.net/oom-wg/apis/shirosu-http.md) · [All operations](https://skmtc.net/oom-wg/apis/shirosu-http/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oom-wg/shirosu-http/versions/3d63f1947f5a/schema)