Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda/ Bare Metal Server/ Referencia de la API/ API de BMS/ Gestión de NIC de BMS/ Consulta de las NIC vinculadas a un BMS

Actualización más reciente 2025-02-18 GMT+08:00

Ver PDF

Consulta de las NIC vinculadas a un BMS

Función

Esta API se utiliza para consultar información sobre las NIC vinculadas a un BMS, como la dirección IP y la dirección MAC de cada NIC.

URI

GET /v1/{project_id}/baremetalservers/{server_id}/os-interface

Tabla 1 enumera los parámetros.

**Tabla 1** Descripción del parámetro
Parámetro	Obligatorio	Descripción
project_id	Sí	Especifica el ID del proyecto. Para obtener más información sobre cómo obtener el ID del proyecto, consulte Obtención de un ID de proyecto.
server_id	Sí	Especifica el ID de BMS. Puede obtener el ID de BMS desde la consola de BMSBMS o invocando al Consulta de los BMS (API nativa de OpenStack).

Parámetros de solicitud

No hay

Ejemplo de solicitud

Consulta de información sobre las NIC vinculadas a un BMS (ID: 95bf2490-5428-432c-ad9b-5e3406f869dd)

     
          GET https://{BMS Endpoint}/v1/c685484a8cc2416b97260938705deb65/baremetalservers/95bf2490-5428-432c-ad9b-5e3406f869dd/os-interface

Parámetros de respuesta

Parámetro	Tipo	Descripción
interfaceAttachments	Array of objects	Especifica las NIC del BMS. Para obtener más información, consulte Tabla 2.

**Tabla 2** Descripción de la estructura de datos de campo **interfaceAttachments**
Parámetro	Tipo	Descripción
port_state	String	Especifica el estado del puerto de NIC. El valor puede ser ACTIVE, BUILD o DOWN.
fixed_ips	Array of objects	Especifica las direcciones IP privadas de las NIC. Para obtener más información, consulte Tabla 3.
net_id	String	Especifica el ID de la subred (network_id) a la que pertenecen los puertos de la NIC.
port_id	String	Especifica el ID del puerto de la NIC.
mac_addr	String	Especifica la dirección de MAC de la NIC.
driver_mode	String	Especifica el tipo de controlador NIC en el SO invitado. El valor puede ser virtio o hinic. El valor predeterminado es virtio.
pci_address	String	Especifica el número BDF de la NIC en el SO invitado de Linux.

**Tabla 3** Descripción de la estructura de datos de campo **fixed_ips**
Parámetro	Tipo	Descripción
subnet_id	String	Especifica el ID de la subred (subnet_id) correspondiente a la dirección IP privada de la NIC.
ip_address	String	Especifica la dirección IP privada de NIC.

Ejemplo de respuesta

    
     
       
       
         {
    "interfaceAttachments": [
        {
            "port_state": "ACTIVE",
            "fixed_ips": [
                {
                    "subnet_id": "a5052101-11e1-4f3d-a5fa-f6ba6791219c",
                    "ip_address": "192.168.1.147"
                }
            ],
            "net_id": "ad0fadbf-4bc1-472c-a030-5310e53b3818",
            "port_id": "bb585b04-f2a2-4528-9064-fd0aeb4e15a9",
            "mac_addr": "fa:16:3e:3b:58:fc"
        }
    ]
}

        

      

    
   