---
title: "设置实例独立出口"
method: PUT
path: "/admin/instances/{id}/egress"
tags: ["管理员/实例"]
---

# 设置实例独立出口

`PUT /admin/instances/{id}/egress`

保存控制端期望状态，下发节点Agent并执行fail-closed协调

## Path parameters

- `id` integer, required

## Request body

- AgentInstanceEgressBindRequest
  - `apply` boolean
  - `enabled` boolean
  - `interface` string
  - `interface_v4` string
  - `interface_v6` string
  - `profile` AgentEgressProfileRequest
    - `enabled` boolean
    - `fail_closed` boolean
    - `gateway` string
    - `id` string
    - `mark` integer
    - `mode` string
    - `public_ipv4` string
    - `public_ipv6` string
    - `route_table` integer
    - `tunnel_interface` string
    - `tunnel_type` string
    - `wireguard` AgentEgressWireGuardRequest
      - `addresses` string[]
      - `allowed_ips` string[]
      - `endpoint` string
      - `managed` boolean
      - `mtu` integer
      - `peer_public_key` string
      - `persistent_keepalive` integer
      - `preshared_key` string
      - `private_key` string
  - `source` string
  - `sources` string[]

## Response `200`

配置已保存

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

## Other responses

- `400` — 请求、网络模式或Agent能力不支持
- `403` — 无权访问实例

---

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