更新时间：2026-02-26 GMT+08:00
裸金属服务器解绑弹性网卡 - DeleteServerNics
功能介绍
解绑裸金属服务器中的一张或多张弹性网卡。
主网卡是裸金属服务器上配置了路由规则的网卡，不可解绑。
调试
您可以在API Explorer中调试该接口。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，需具备如下身份策略权限。
授权项
访问级别
资源类型（*为必须）
条件键
别名
依赖的授权项
bms:server:deleteNics
write
instance*
- g:EnterpriseProjectId
- g:ResourceTag/<tag-key>
-
-
URI
POST /v1/{project_id}/baremetalservers/{server_id}/nics/delete
参数说明请参见表1。
参数 | 是否必选 | 描述 |
|---|---|---|
project_id | 是 | 项目ID。 获取方式请参见获取项目ID。 |
server_id | 是 | 裸金属服务器ID。 可以从裸金属服务器控制台查询，或者通过调用查询裸金属服务器列表（废弃）获取。 |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
nics | 是 | Array of objects | 需要解绑的网卡列表信息，详情请参见表3。 |
请求示例
解绑网卡Port ID为d32019d3-bc6e-4319-9c1d-6722fc136a23的弹性网卡。
{
"nics": [
{
"id": "d32019d3-bc6e-4319-9c1d-6722fc136a23"
}
]
} 响应参数
名称 | 参数类型 | 说明 |
|---|---|---|
job_id | String | 提交任务成功后返回的任务ID，用户可以使用该ID对任务执行情况进行查询。 如何根据job_id来查询Job的执行状态，请参考查询Job状态 - ShowJobInfos。 |
名称 | 参数类型 | 说明 |
|---|---|---|
error | 字典数据结构 | 提交任务异常时返回的异常信息，详情请参见表6。 |
响应示例
- 正常响应
1 2 3
{ "job_id": "70a599e0-31e7-49b7-b260-868f441e862b" }
错误码
请参考错误码。
父主题：裸金属服务器网卡管理
