更新时间：2025-11-25 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" }
错误码
请参考错误码。
父主题： 裸金属服务器网卡管理
