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/ Elastic Cloud Server/ Referencia de la API/ API de OpenStack Nova/ Gestión de NIC/ Consulta de NIC de ECS
Actualización más reciente 2025-08-25 GMT+08:00
Ver PDF
Compartir

Consulta de NIC de ECS

Función

Esta API se utiliza para consultar información sobre NIC de ECS.

URI

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

Tabla 1 describe los parámetros en el URI.
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, consulte Obtención de un ID de proyecto.

server_id

Sí

Especifica el ID de ECS.

Solicitud

No hay

Respuesta

Tabla 2 describe los parámetros de respuesta.
Tabla 2 Parámetros de respuesta

Parámetro

Tipo

Descripción

interfaceAttachments

Array of objects

Especifica los NIC de ECS. Para más detalles, consulte Tabla 3.
Tabla 3 Descripción del campo interfaceAttachments

Parámetro

Tipo

Descripción

port_state

String

Especifica el estado del puerto de NIC.

fixed_ips

Array of objects

Especifica las direcciones IP privadas para los NIC. Para más detalles, consulte Tabla 4.

net_id

String

Especifica el ID de red al que pertenece el puerto de NIC.

port_id

String

Especifica el ID del puerto NIC.

mac_addr

String

Especifica la dirección MAC del NIC.
Tabla 4 Descripción del campo fixed_ips

Parámetro

Tipo

Descripción

subnet_id

String

Especifica la subred de la dirección IP privada de la NIC.

ip_address

String

Especifica la dirección IP privada del NIC.

Ejemplo de la solicitud

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

Ejemplo de la respuesta

{
    "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

Consulte Valores devueltos para solicitudes generales

Tema principal: Gestión de NIC