Lite Server服务器卸载网卡 - DetachDevServerPorts
功能介绍
Lite Server服务器卸载网卡接口用于从服务器中移除指定的网络接口卡。该接口适用于以下场景：当服务器需要进行硬件维护、资源回收或网络配置调整时，用户可通过此接口卸载不再使用的网卡设备。使用该接口的前提条件是目标网卡已正确安装并处于可操作状态，且用户具有系统管理员权限。卸载操作完成后，网卡将从服务器配置中移除，相关驱动和网络参数也将被清除。若目标网卡不存在、用户权限不足或服务器处于运行状态，接口将返回对应的错误信息。
接口约束
仅支持超节点相关资源。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
URI
DELETE /v1/{project_id}/dev-servers/{id}/detach-ports/{port_id}
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释：用户项目ID。获取方法请参见获取项目ID和名称。 约束限制：不涉及。 取值范围：1~64个字符，只能由字母、数字和中划线组成。 默认取值：不涉及。 |
| id | 是 | String | 参数解释：lite Server实例ID。 约束限制：^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$。 取值范围：1 - 64字符。 默认取值：不涉及。 |
| 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}$。 取值范围：1 - 64字符。 默认取值：不涉及。 |
请求参数
无
响应参数
状态码：200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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}$。 |
请求示例
DELETE https://{endpoint}/v1/{project_id}/dev-servers/{id}/detach-ports/{port_id} 响应示例
状态码：200
OK
{
"port_id" : "38cf274a-98f9-4f6f-b622-5ed0e4a3db54"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | OK |
错误码
请参见错误码。
