---
title: "同步端口映射"
method: POST
path: "/admin/port-mappings/sync"
tags: ["Admin-Port-Mapping"]
---

# 同步端口映射

`POST /admin/port-mappings/sync`

先使用 dryRun 预览，再提交 includedPortIds 创建后台任务，检测并清理孤立的端口映射。为每个Provider创建独立的同步任务

## Request body

- AdminSyncPortMappingsTaskRequest
  - `dryRun` boolean — 仅生成预览，不创建同步任务
  - `excludedPortIds` integer[] — 预览后取消勾选的端口ID
  - `includedPortIds` integer[] — 预览后确认删除的端口ID；执行同步时必填
  - `providerIds` integer[] — 指定要同步的Provider IDs（为空则同步所有）

## Response `200`

同步任务已创建

- CommonResponse
  - `code` integer
  - `data` unknown
  - `message` string
  - `msg` string

## Other responses

- `400` — 参数错误
- `401` — 未授权
- `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/revisions/1f98232296de/schema)