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 (recomendado)/Gestión de NIC/Consulta de NIC de un ECS
Actualización más reciente 2025-08-25 GMT+08:00
Ver PDF
Compartir

Consulta de NIC de un ECS

Función

Esta API se utiliza para consultar NIC de un ECS.

URI

GET /v1/{project_id}/cloudservers/{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 NIC de ECS. Para más detalles, consulte Tabla 3.

attachableQuantity

Object

Especifica el número de NIC que se pueden conectar a un ECS. Para más detalles, consulte Tabla 4.

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 NIC. Para más detalles, consulte Tabla 5.

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 de NIC.

delete_on_termination

Boolean

Especifica si se eliminará una NIC al desconectarla.

true: Se eliminará la NIC. false: la NIC no se eliminará.

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.

min_rate

Integer

Especifica el ancho de banda mínimo de la NIC.

multiqueue_num

Integer

Especifica el número de colas.

El valor puede ser 1, 2, 4, 8, 16 o 28.

pci_address

String

Especifica el número BDF de la interfaz de red en Linux GuestOS.

NOTA:

Si no se admite la NIC, no se devolverá ninguna información.

Tabla 4 Descripción del campo attachableQuantity

Parámetro

Tipo

Descripción

free_nic

Integer

Especifica el número restante de NIC que se pueden conectar a un ECS.

Tabla 5 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 de NIC.

Ejemplo de la solicitud

GET https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/os-interface

Ejemplo de la respuesta

{
    "interfaceAttachments": [
        {
            "port_state": "ACTIVE",
            "fixed_ips": [
                {
                    "subnet_id": "ba31e1f5-fa76-4530-862c-5176fad033cf",
                    "ip_address": "192.168.0.33"
                }
            ],
            "net_id": "610a4af2-1d90-4d2b-8057-dc238b26febf",
            "port_id": "04819c0a-6a07-44b6-945e-fb932071888e",
            "mac_addr": "fa:16:3e:45:65:c4"        }
    ]
}

Valores devueltos

Consulte Valores devueltos para solicitudes generales

Tema principal:Gestión de NIC