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 nativa de Nova V2.1 de OpenStack/ Gestión de NIC de BMS/ Consulta de información acerca de las NIC de BMS (API nativa de OpenStack)
Actualización más reciente 2025-02-18 GMT+08:00

Consulta de información acerca de las NIC de BMS (API nativa de OpenStack)

Función

Esta API se utiliza para consultar información sobre las NIC de BMS, como las direcciones MAC y las direcciones IP privadas.

URI

GET /v2.1/{project_id}/servers/{server_id}/os-interface

Tabla 1 enumera los parámetros.

Tabla 1 Descripción del parámetro

Parámetro

Obligatorio

Descripción

project_id

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

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)
1
GET https://{ECS Endpoint}/v2.1/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd/os-interface

Parámetros de respuesta

Parámetro

Tipo

Descripción

interfaceAttachments

Array of objects

Especifica información acerca de las NIC del BMS. Para obtener más información, véase 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 la dirección IP privada de 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.

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

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
{
    "interfaceAttachments": [
        {
            "port_state": "ACTIVE",
            "fixed_ips": [
                {
                    "subnet_id": "f8a6e8f8-c2ec-497c-9f23-da9616de54ef",
                    "ip_address": "192.168.1.3"
                }
            ],
            "net_id": "3cb9bc59-5699-4588-a4b1-b87f96708bc6",
            "port_id": "ce531f90-199f-48c0-816c-13e38010b442",
            "mac_addr": "fa:16:3e:4c:2c:30"
        }
    ]
}

Valores devueltos

Valores normales

Valores devueltos

Descripción

200

La solicitud se ha procesado correctamente.

Para obtener más información sobre otros valores devueltos, consulte Códigos de estado.

Códigos de error

Véase Códigos de error.