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 NICs de un ECS

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

Ver PDF

Consulta de NICs de un ECS

Función

Esta API se utiliza para consultar los NIC de un ECS según el ID de NIC.

URI

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

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.
id	Sí	Especifica el ID de puerto del NIC.

Solicitud

No hay

Respuesta

Tabla 2 describe los parámetros de respuesta.

**Tabla 2** Parámetros de respuesta
Parámetro	Tipo	Descripción
interfaceAttachment	Object	Especifica los NIC de ECS. Para más detalles, consulte Tabla 3.

**Tabla 3** Descripción del campo **interfaceAttachment**
Parámetro	Tipo	Descripción
port_state	String	Especifica el estado del puerto de NIC.
fixed_ips	Array of objects	Especifica las direcciones IP para los NIC. Para más detalles, consulte Tabla 4.
net_id	String	Especifica el ID de red al que pertenece el puerto 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 el ID de la subred utilizada por el NIC.
ip_address	String	Especifica la dirección IP del NIC.

Ejemplo de la solicitud

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

Ejemplo de la respuesta

{
    "interfaceAttachment": 
{
        "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"
                    }
                    }