Help Center/ Bare Metal Server/ API Reference/ BMS APIs/ BMS NIC Management/ Modifying a BMS NIC
Updated on 2026-03-18 GMT+08:00
View PDF
Share

Modifying a BMS NIC

Function

This API is used to modify a BMS NIC.

Debugging

You can debug this API in API Explorer.

URI

PUT /v1/{project_id}/baremetalservers/nics/{nic_id}

Table 1 lists the parameters.
Table 1 Parameter description

Parameter

Mandatory

Description

project_id

Yes

Specifies the project ID.

For details about how to obtain the project ID, see Obtaining a Project ID.

nic_id

Yes

Specifies the NIC ID.

Request

Table 2 describes the request parameters.

Table 2 Request parameters

Parameter

Mandatory

Type

Description

nic

No

Object

Specifies the NIC details. For details, see Table 3.
Table 3 nic parameters

Parameter

Mandatory

Type

Description

subnet_id

No

String

Specifies the subnet ID.

device_owner

No

String

Specifies the device owner.

ip_addresses

No

Array of strings

Specifies the IP address.

reverse_binding

No

Array of boolean

Specifies whether to perform reverse binding.

Response

Table 4 Response parameters

Parameter

Type

Description

port_id

String

Specifies the NIC ID.

Example Request

PUT https://{endpoint}/v1/{project_id}/baremetalservers/nics/{nic_id}
{
  "nic": {
    "subnet_id": "feb858e0-2111-4e47-98f4-275b87baaf1d",
    "ip_addresses": "192.168.1.1",
    "device_owner": "device_owner",
    "reverse_binding": false
  }
}

Example Response

{
  "port_id": "ce531f90-199f-48c0-816c-13e38010b442"
}

Returned Values

See Status Codes.

Error Codes

See Error Codes.

Parent topic: BMS NIC Management