---
title: "发现Provider实例"
method: POST
path: "/admin/providers/{id}/discover"
tags: ["Provider管理"]
---

# 发现Provider实例

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

扫描Provider上所有已存在的实例，返回实例列表

## Path parameters

- `id` integer, required

## Response `200`

发现成功

- object
  - `code` integer
  - `data` ProviderDiscoveryResult
    - `alreadyManaged` integer — 已纳管的实例数
    - `discoveredAt` string
    - `discoveredInstances` ProviderDiscoveredInstance[]
      - `accelerators` ProviderDiscoveredAccelerator[]
        - `bus` string — 总线地址（可选）
        - `id` string — 设备ID（如索引或PCI地址）
        - `kind` string — gpu / npu
        - `name` string — 设备名称
        - `source` string — 来源：devices/lspci/nvidia-smi/npu-smi
        - `vendor` string — 厂商
      - `cpu` integer — 资源配置
      - `disk` integer — 磁盘大小（MB）
      - `extraPorts` integer[] — 其他开放端口（向后兼容）
      - `gpuDeviceIds` string
      - `gpuEnabled` boolean — 硬件加速配置（主要用于 LXD/Incus 导入场景）
      - `image` string — 系统信息
      - `instanceType` string — 实例类型（container或vm）
      - `ipv6Address` string — IPv6地址
      - `macAddress` string — MAC地址
      - `memory` integer — 内存大小（MB）
      - `name` string — 实例名称
      - `npuDeviceIds` string
      - `npuEnabled` boolean
      - `osType` string — 操作系统类型
      - `portMappings` ProviderDiscoveredPortMapping[] — 完整的端口映射信息
        - `guestPort` integer — 容器/虚拟机内部端口
        - `hostPort` integer — 宿主机端口
        - `isSsh` boolean — 是否为SSH端口
        - `mappingMethod` string — native, device_proxy, iptables
        - `protocol` string — tcp, udp, both
      - `privateIP` string — 网络配置
      - `providerInstanceId` string — 虚拟化平台上的原始实例ID（如 Proxmox VMID/CTID）
      - `publicIP` string — 公网IPv4地址
      - `rawData` unknown
      - `sshPort` integer — SSH端口
      - `status` string — 实例状态（running, stopped等）
      - `username` string — 导入时可用的SSH用户名
      - `uuid` string — 基本标识
    - `error` string
    - `newInstances` integer — 新发现的实例数
    - `providerId` integer
    - `providerName` string
    - `providerType` string
    - `totalCount` 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)