---
title: "获取用户实例详情"
method: GET
path: "/user/instances/{id}"
tags: ["用户管理"]
---

# 获取用户实例详情

`GET /user/instances/{id}`

获取用户实例的详细信息

## Path parameters

- `id` integer, required

## Response `200`

获取成功

- object
  - `code` integer
  - `data` UserUserInstanceDetailResponse
    - `bandwidth` integer
    - `cpu` integer
    - `createdAt` string
    - `disk` integer
    - `expiresAt` string — 实例过期时间
    - `frozenReason` string
    - `hasSshMapping` boolean — 是否有可用的SSH端口映射（支持Web SSH连接）
    - `id` integer
    - `image` string — 当前使用的镜像名称
    - `instance_type` string — 实例类型：container, vm
    - `ipv4MappingType` string — IPv4映射类型：nat(NAT共享IP), dedicated(独立IPv4地址) (已弃用，保留向后兼容)
    - `ipv6Address` string — 内网IPv6地址
    - `isFrozen` boolean
    - `memory` integer
    - `name` string
    - `networkType` string — 网络配置类型：nat_ipv4, nat_ipv4_ipv6, dedicated_ipv4, dedicated_ipv4_ipv6, ipv6_only
    - `osType` string
    - `password` string
    - `portRangeEnd` integer — 端口范围结束
    - `portRangeStart` integer — 端口范围起始
    - `privateIP` string — 内网IPv4地址
    - `providerName` string
    - `providerStatus` string — Provider状态：active, inactive, partial
    - `providerType` string — Provider虚拟化类型：docker, lxd, incus, proxmox
    - `provider_id` integer — Provider ID
    - `publicIP` string — 公网IPv4地址
    - `publicIPv6` string — 公网IPv6地址
    - `relatedTask` UserUserTaskResponse
      - `canCancel` boolean — 是否可以取消
      - `cancelReason` string — 取消原因
      - `completedAt` string
      - `createdAt` string
      - `errorMessage` string
      - `estimatedWaitTime` integer — 预计等待时间（秒）
      - `id` integer
      - `instanceId` integer
      - `instanceName` string
      - `instanceType` string — 实例类型：container 或 vm
      - `isForceStoppable` boolean — 是否允许强制停止
      - `preallocatedBandwidth` integer — 预分配的带宽(Mbps)
      - `preallocatedCpu` integer — 预分配的实例配置信息
      - `preallocatedDisk` integer — 预分配的磁盘(MB)
      - `preallocatedMemory` integer — 预分配的内存(MB)
      - `progress` integer
      - `progressLogs` string — 进度日志（JSON数组）
      - `providerId` integer
      - `providerName` string
      - `queuePosition` integer — 排队信息
      - `remainingTime` integer — 剩余时间（秒）
      - `startedAt` string
      - `status` string
      - `statusMessage` string — 状态描述
      - `taskType` string
      - `timeoutDuration` integer — 超时时间（秒）
      - `updatedAt` string
      - `uuid` string
    - `sshPort` integer
    - `status` string
    - `trafficLimitReason` string — 实例流量限制原因
    - `trafficLimited` boolean — 实例是否因流量限制
    - `trafficOperationLockLevel` string — 锁定层级：instance/user/provider
    - `trafficOperationLockMessage` string — 锁定提示
    - `trafficOperationLocked` boolean — 是否因实例/用户/节点流量超限锁定普通用户操作
    - `trafficQuotaVisible` boolean — 流量配额显示
    - `type` string
    - `username` string
  - `message` string
  - `msg` string

## Other responses

- `401` — 用户未登录
- `403` — 实例不存在或无权限
- `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)