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

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"
        }
    ]
}