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 2022-11-08 GMT+08:00

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