---
title: "批量实例操作"
method: POST
path: "/user/instances/batch-action"
tags: ["用户管理"]
---

# 批量实例操作

`POST /user/instances/batch-action`

对当前用户的多个实例批量执行启动、停止、重启、重置、删除等操作

## Request body

- UserBatchInstanceActionRequest
  - `action` string, required
  - `image` string
  - `instanceIds` integer[], required

## Response `200`

批量操作已处理

- object
  - `code` integer
  - `data` UserBatchInstanceActionResponse
    - `action` string
    - `failCount` integer
    - `results` UserBatchInstanceActionResult[]
      - `error` string
      - `instanceId` integer
      - `message` string
      - `success` boolean
    - `successCount` integer
    - `total` integer
  - `message` string
  - `msg` string

## Other responses

- `400` — 参数错误
- `401` — 用户未登录

---

[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)