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/ Adición de NICs a un ECS por lotes
Actualización más reciente 2025-08-25 GMT+08:00
Ver PDF
Compartir

Adición de NICs a un ECS por lotes

Función

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

URI

POST /v1/{project_id}/cloudservers/{server_id}/nics

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

nics

Sí

Array of objects

Especifica las NIC que se van a agregar. Para más detalles, consulte Tabla 3.
Tabla 3 Descripción del campo nics

Parámetro

Obligatorio

Tipo

Descripción

subnet_id

Sí

String

Especifica la información acerca de los NIC que se van a agregar a un ECS.

security_groups

No

Array of objects

Especifica los grupos de seguridad para las NIC. Para más detalles, consulte Tabla 4.

ip_address

No

String

Especifica la dirección IP. Si este parámetro no está disponible, la dirección IP se asigna automáticamente.

ipv6_enable

No

Boolean

Indica si se admiten direcciones IPv6.

Si este parámetro se establece en true, la NIC admite direcciones IPv6.

ipv6_bandwidth

No

Object

Especifica el ancho de banda compartido enlazado. Para más detalles, consulte Descripción del campo ipv6_bandwidth.
Tabla 4 Descripción del campo security_groups

Parámetro

Obligatorio

Tipo

Descripción

id

Sí

String

Especifica el ID del grupo de seguridad.

Respuesta

Consulte Respuestas (tarea)

Ejemplo de la solicitud

POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/nics
{
    "nics": [
        {
            "subnet_id": "d32019d3-bc6e-4319-9c1d-6722fc136a23", 
            "security_groups": [
                {
                    "id": "f0ac4394-7e4a-4409-9701-ba8be283dbc3"
                }
            ]
        }
    ]
}

Ejemplo de la respuesta

No hay

Valores devueltos

Consulte Valores devueltos para solicitudes generales

Códigos de error

Consulte Códigos de error

Tema principal: Gestión de NIC