文档首页/ 裸金属服务器 BMS/ API参考/ API/ 裸金属服务器网卡管理/ 裸金属服务器绑定弹性网卡
更新时间：2024-10-22 GMT+08:00
查看PDF
分享

裸金属服务器绑定弹性网卡

功能介绍

为裸金属服务器绑定一张或多张弹性网卡。

URI

POST /v1/{project_id}/baremetalservers/{server_id}/nics

参数说明请参见表1 参数说明。

表1 参数说明

参数

是否必选

描述

project_id

是

项目ID。

获取方式请参见获取项目ID。

server_id

是

裸金属服务器ID。

可以从裸金属服务器控制台查询，或者通过调用查询裸金属服务器列表（废弃）获取。

请求参数

参数

是否必选

参数类型

描述

nics

是

Array of objects

需要绑定的网卡参数列表，详情请参见表2。

约束：

当前不支持10个网卡以上的并发挂载。10个以上并发挂载时，挂载可能失败。
表2 nics字段数据结构说明

参数

是否必选

参数类型

描述

subnet_id

是

String

网卡的子网ID。

网络（network）的ID可以从控制台或者参考《虚拟私有云API参考》的“查询子网列表”章节获取，UUID格式。

约束：

security_groups

否

Array of objects

网卡的安全组信息，详情请参见表3。

约束：

仅在指定subnet_id时生效，当使用subnet_id跨租户挂网卡时，此字段必填。

ip_address

否

String

IP地址。无该参数表示自动分配IP地址。

约束：

仅在指定subnet_id时生效。
表3 security_groups字段数据结构说明

参数

是否必选

参数类型

描述

id

是

String

安全组ID。

请求示例

绑定网卡，其中网卡的子网ID为d32019d3-bc6e-4319-9c1d-6722fc136a23，安全组ID为f0ac4394-7e4a-4409-9701-ba8be283dbc3。 
{
    "nics": [
        {
            "subnet_id": "d32019d3-bc6e-4319-9c1d-6722fc136a23",
            "security_groups": [
                {
                    "id": "f0ac4394-7e4a-4409-9701-ba8be283dbc3"
                }
            ]
        }
    ]
}

响应参数

表4 正常响应要素说明

名称

参数类型

说明

job_id

String

提交任务成功后返回的任务ID，用户可以使用该ID对任务执行情况进行查询。

如何根据job_id来查询Job的执行状态，请参考查询Job状态。
表5 异常响应要素说明

名称

参数类型

说明

error

字典数据结构

提交任务异常时返回的异常信息，详情请参见表6。
表6 error数据结构

名称

参数类型

说明

message

String

任务异常错误信息描述。

code

String

任务异常错误信息编码。

响应示例

  • 正常响应 
    1
2
3
    		 
    { 
    "job_id": "70a599e0-31e7-49b7-b260-868f441e862b" 
}

返回值

正常返回值：

返回值

说明

200

服务器已成功处理了请求。

其他返回值请参考状态码。

错误码

请参考错误码。