规格分配服务器

POST

/admin/packages/servers

权限点:server_manage:package

服务器挑选逻辑(两阶段):

候选集:按规格 is_auto_collect 从真实硬件缓存或采购硬件缓存匹配,并入手动关联到规格的服务器。

可用性过滤:type=rent、服务器/机柜/交换机未锁定、缓存空闲、属于指定机房(datacenter_id)、无未完结故障单;传 os_name 时要求已预装该系统。随机抽取一台。

分配成功后创建用户-服务器关联、清除预装标记、写入带宽并创建交换机限速任务。

请求参数

Authorization

API Key

在 header 添加参数

token

示例：

token: ********************

Header 参数

Body 参数application/json必填

示例

{
    "package_id": 3,
    "user_id": 128,
    "datacenter_id": 2,
    "custom_bandwidth": {
        "both": 0,
        "upload": 0,
        "download": 0
    },
    "custom_extra_ipaddress": {
        "1": {
            "address": 2,
            "block": {
                "29": {
                    "number": 1,
                    "random": false
                }
            }
        }
    },
    "os_name": "centos7",
    "unlink_old_ip": true,
    "keep_old_ip": true,
    "force_port_vlan_same": true
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/admin/packages/servers' \
--header 'token: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "package_id": 3,
    "user_id": 128,
    "datacenter_id": 2,
    "custom_bandwidth": {
        "both": 0,
        "upload": 0,
        "download": 0
    },
    "custom_extra_ipaddress": {
        "1": {
            "address": 2,
            "block": {
                "29": {
                    "number": 1,
                    "random": false
                }
            }
        }
    },
    "os_name": "centos7",
    "unlink_old_ip": true,
    "keep_old_ip": true,
    "force_port_vlan_same": true
}'

返回响应

🟢200

application/json

分配成功

Bodyapplication/json

示例

{
    "success": true,
    "link_id": 456
}

🟠400

修改于 2026-08-27 07:11:38

取消规格

修改交换机端口