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/ Adición de una NIC a un ECS

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

Ver PDF

Adición de una NIC a un ECS

Función

Esta API se utiliza para agregar una NIC a un ECS.

Para ver ejemplos de aplicaciones sobre aplicaciones NIC de ECS, consulte Conexión de un NIC a un ECS.

URI

POST /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

Tabla 2 describe los parámetros de solicitud.

**Tabla 2** Parámetros de solicitud
Parámetro	Obligatorio	Tipo	Descripción
interfaceAttachment	Sí	Object	Especifica las NIC que se van a agregar. Para más detalles, consulte Tabla 3.

**Tabla 3** Descripción del campo **interfaceAttachment**
Parámetro	Obligatorio	Tipo	Descripción
port_id	No	String	Especifica el ID de puerto. Cada vez se usa port_id o net_id.
net_id	No	String	Especifica el ID de red. Cada vez se usa port_id o net_id.
fixed_ips	No	Array of objects	Especifica una dirección IP privada. Este parámetro no se puede especificar cuando se utiliza port_id. Este parámetro debe usarse con net_id. Solo el primer elemento de la lista es válido. Si se usan dos o más elementos, se reportará un error. Para más detalles, consulte Tabla 4.

**Tabla 4** Descripción del campo **fixed_ips**
Parámetro	Obligatorio	Tipo	Descripción
ip_address	No	String	Especifica la dirección IP.

Respuesta

Tabla 5 describe los parámetros de respuesta.

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

**Tabla 6** Descripción del campo **interfaceAttachment**
Parámetro	Tipo	Descripción
port_state	String	Especifica el estado del puerto.
fixed_ips	Array of objects	Especifica las direcciones IP para los NIC. Para más detalles, consulte Tabla 7.
port_id	String	Especifica el ID de puerto.
net_id	String	Especifica el ID de red.
mac_addr	String	Especifica la dirección MAC.

**Tabla 7** 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

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

{
    "interfaceAttachment" : {
        "fixed_ips" : [ 
            {
                "ip_address" : "192.168.1.3"
            } 
         ],
    "net_id" : "3cb9bc59-5699-4588-a4b1-b87f96708bc6"
    }
}

{
    "interfaceAttachment" : {
    "port_id" : "ce531f90-199f-48c0-816c-13e38010b442"
    }
}

Ejemplo de la respuesta

{
    "interfaceAttachment": {
        "port_state": "DOWN",
        "fixed_ips": [
            {
                "subnet_id": "d9cfef77-0151-4c2a-9ed5-d951ada8adf3",
                "ip_address": "10.0.1.11"
            }
        ],
        "port_id": " ce531f90-199f-48c0-816c-13e38010b442",
        "net_id": "0dc714fa-9022-4a03-bb22-9821a396bb9d",
        "mac_addr": "fa:16:3e:63:75:b2"
    }
}