---
title: "检查实例同步"
method: POST
path: "/admin/providers/{id}/sync-check"
tags: ["Provider管理"]
---

# 检查实例同步

`POST /admin/providers/{id}/sync-check`

比较数据库实例与Provider远程实例，检测新增、删除和变化的实例

## Path parameters

- `id` integer, required

## Response `200`

检查成功

- object
  - `code` integer
  - `data` ProviderInstanceSyncReport
    - `changedInstances` ProviderInstanceChange[] — 状态变化实例
      - `instanceId` integer
      - `name` string
      - `newStatus` string
      - `oldStatus` string
      - `uuid` string
    - `checkedAt` string
    - `deletedInstances` OneclickvirtModelProviderInstance[] — 已删除实例
      - `bandwidth` integer — 网络带宽（Mbps）
      - `cpu` integer — 资源配置
      - `createdAt` string — 实例创建时间
      - `discoveredData` string — 发现时的脱敏原始数据（JSON格式，用于调试和审计）
      - `disk` integer — 磁盘大小（MB）
      - `egressProfileId` string — EgressProfileID binds this instance to a node-side transparent egress profile. The Rust Agent treats the binding as desired state and keeps traffic fail-closed until the host route plan is reconciled successfully.
      - `expiresAt` string — 生命周期和冻结管理
      - `expiryStopped` boolean — 是否由过期策略自动停机，续期后可自动恢复
      - `expiryStoppedAt` string — 过期策略自动停机时间
      - `frozenAt` string — 冻结时间
      - `frozenReason` string — 冻结原因：expired(到期), node_frozen(节点冻结), manual(手动冻结)
      - `gpuDeviceIds` string — GPU设备ID列表（逗号分隔）
      - `gpuEnabled` boolean — GPU/NPU直通配置（从兑换码/导入时继承，用于展示和运维参考）
      - `hasPortConflict` boolean — 是否存在端口冲突
      - `id` integer — 基础字段
      - `image` string — 使用的镜像名称（多容器场景可包含多个镜像）
      - `importedAt` string — 导入时间
      - `instance_type` string — 实例类型：container, vm
      - `ipv6Address` string — 内网IPv6地址
      - `isFrozen` boolean — 是否被冻结（冻结后无法操作，除了删除）
      - `isImported` boolean — 实例导入相关字段
      - `isManualExpiry` boolean — 是否手动设置了过期时间（手动设置的优先级高于节点）
      - `maxTraffic` integer — 流量统计（实例层面）
      - `memory` integer — 内存大小（MB）
      - `name` string — 基本信息 添加覆盖索引，包含常用查询字段
      - `network` string — 网络配置
      - `networkType` string — 创建时继承的网络类型（用于reset时恢复IPv6配置）
      - `npuDeviceIds` string — NPU设备ID列表（逗号分隔）
      - `npuEnabled` boolean — 是否启用NPU直通
      - `osType` string — 系统信息
      - `password` string — 登录密码
      - `pmacctInterfaceV4` string — pmacct 监控的IPv4网络接口名称
      - `pmacctInterfaceV6` string — pmacct 监控的IPv6网络接口名称
      - `portConflictDetail` string — 端口冲突详情（JSON格式记录冲突端口信息）
      - `portRangeEnd` integer — 端口映射范围结束
      - `portRangeStart` integer — 端口映射范围起始
      - `privateIP` string — 内网/私有IPv4地址
      - `provider` string — Provider名称
      - `providerId` integer — 关联的Provider ID（与name组合唯一）
      - `providerVmId` string — 虚拟化平台的可操作实例ID（VMID、容器ID、VMX路径或远端实例名）
      - `publicIP` string — 公网IPv4地址
      - `publicIPv6` string — 公网IPv6地址
      - `region` string — 所在地区
      - `sshPort` integer — SSH访问端口
      - `status` string — 实例状态：creating, running, stopped, failed等
      - `trafficLimitReason` string — 流量限制原因：instance(实例超限), user(用户超限), provider(Provider超限)
      - `trafficLimited` boolean — 是否因流量超限被限制
      - `trafficStopped` boolean — 是否由流量策略自动停机，解除限制后可自动恢复
      - `trafficStoppedAt` string — 流量策略自动停机时间
      - `updatedAt` string — 实例信息更新时间
      - `userId` integer — 关联关系 添加UserID索引以支持按用户查询
      - `username` string — 访问凭据
      - `uuid` string — 实例唯一标识符
    - `newInstances` 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 — 基本标识
    - `providerId` integer
    - `providerName` string
    - `totalDB` integer — 数据库总实例数
    - `totalRemote` 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)