---
title: "导入Provider实例"
method: POST
path: "/admin/providers/{id}/import"
tags: ["Provider管理"]
---

# 导入Provider实例

`POST /admin/providers/{id}/import`

将发现的实例导入到系统中进行管理

## Path parameters

- `id` integer, required

## Request body

- ProviderImportOptions
  - `adminUserId` integer — 管理员用户ID，导入的实例将分配给该用户
  - `autoAdjustQuota` boolean — 是否自动调整quota
  - `instanceUuids` string[] — 要导入的实例UUID列表，为空表示全部导入
  - `markConflicts` boolean — 是否标记端口冲突
  - `providerId` integer — Provider ID

## Response `200`

导入成功

- object
  - `code` integer
  - `data` ProviderImportResult
    - `errors` string[] — 错误列表
    - `failedCount` integer — 失败数
    - `importedAt` string
    - `importedDetails` ProviderImportedInstanceInfo[] — 导入详情
      - `conflictDetail` string
      - `error` string
      - `hasPortConflict` boolean
      - `instanceId` integer
      - `name` string
      - `status` string — success, skipped, failed
      - `uuid` string
    - `portConflicts` integer — 端口冲突数
    - `providerId` integer
    - `providerName` string
    - `quotaAdjusted` boolean — 是否调整了quota
    - `skippedCount` integer — 跳过数（已存在）
    - `successCount` integer — 成功导入数
    - `totalAttempted` integer — 尝试导入的实例数
  - `message` string
  - `msg` string

## Other responses

- `400` — 请求参数错误
- `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)