更新时间：2026-08-26 GMT+08:00

Lite Server服务器挂载网卡 - AttachDevServerPorts

功能介绍

Lite Server服务器挂载网卡

接口约束

仅支持超节点相关资源。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，当前API调用无需身份策略权限。

URI

POST /v1/{project_id}/dev-servers/{id}/attach-ports

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释：用户项目ID。获取方法请参见获取项目ID和名称。约束限制：不涉及。取值范围：1~64个字符，只能由字母、数字和中划线组成。默认取值：不涉及。
id	是	String	参数解释：DevServer实例ID。约束限制：必填。取值范围：1 - 64字符。默认取值：不涉及。

请求参数

表2 请求Body参数
参数	是否必选	参数类型	描述
port_id	否	String	参数解释：网卡ID，填该参数时，表明挂载已有网卡，其他参数不用填。约束限制：^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$。取值范围：不涉及。默认取值：不涉及。
name	否	String	参数解释：网卡名称。约束限制：不涉及。取值范围：默认为空，最大长度不超过255。默认取值：不涉及。
network_id	否	String	参数解释：端口子网ID。约束限制：参数port_id未填时，需要新建网卡进行挂载，此时network_id为必填项。取值范围：必须是UUID格式的字符串。默认取值：不涉及。
ip_address	否	String	参数解释：端口IP地址。约束限制：不支持更新。取值范围：所属网络网段。默认取值：不涉及。
security_groups	否	Array of strings	参数解释：关联安全组ID列表。约束限制：一个端口默认最多支持100个安全组。默认取值：不涉及。
enable_efi	否	Boolean	参数解释：是否使能efi。约束限制：不涉及。取值范围： true：启用efi false：不启用efi 默认取值：不涉及。
efi_protocol	否	String	参数解释：efi 协议。约束限制：不涉及。取值范围：1 - 64字符。默认取值：不涉及。

响应参数

状态码：200

表3 响应Body参数
参数	参数类型	描述
mac_addr	String	参数解释：端口MAC地址。
port_id	String	参数解释：网卡ID。取值范围：^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$。
port_state	String	参数解释：端口状态。取值范围： ACTIVE：端口处于活动状态，可以正常进行网络通信。 BUILD：端口正在创建或配置中。 DOWN：端口处于非活动状态，不能进行网络通信。
virsubnet_id	String	参数解释：端口所在子网ID。

请求示例

POST https://{endpoint}/v1/{project_id}/dev-servers/{id}/attach-ports

{
  "name" : "uboe_1209",
  "network_id" : "2ef6878e-0cf8-479e-b15d-e8e5b64c9642",
  "security_groups" : [ "dbc7c0e3-1010-4d7f-9018-3ec7198d450d" ],
  "enable_efi" : true,
  "efi_protocol" : "UBoE"
}

响应示例

状态码：200

{
  "mac_addr" : "fa:16:3e:b1:a1:01",
  "port_id" : "e461f141-75df-4fac-903c-0831b1079123",
  "port_state" : "ACTIVE",
  "virsubnet_id" : "2ef6878e-0cf8-479e-b15d-e8e5b64c9642"
}

状态码

状态码	描述
200	OK

错误码

请参见错误码。

父主题： 轻量算力节点