# Lite Server服务器挂载网卡 - AttachDevServerPort #### 功能介绍 Lite Server服务器挂载网卡 #### 接口约束 仅支持超节点相关资源。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/ModelArts/doc?api=AttachDevServerPort)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-modelarts/modelarts_03_0138.html)。 - 如果使用身份策略授权，当前API调用无需身份策略权限。 #### URI POST /v1/{project_id}/dev-servers/{id}/attach-ports 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释** ：用户项目ID。获取方法请参见[获取项目ID和名称](https://support.huaweicloud.com/api-modelarts/modelarts_03_0147.html)。 **约束限制**：不涉及。 **取值范围**：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** OK ``` { "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 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-modelarts/modelarts_03_0095.html)。