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/ Bare Metal Server/ Referencia de la API/ API de BMS/ Gestión de NIC de BMS/ Vinculación de NIC a un BMS
Actualización más reciente 2025-02-18 GMT+08:00
Ver PDF
Compartir

Vinculación de NIC a un BMS

Función

Esta API se utiliza para vincular una o más NIC a un BMS.

URI

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

Tabla 1 enumera los parámetros.

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 del proyecto, consulte Obtención de un ID de proyecto.

server_id

Sí

Especifica el ID de BMS.

Puede obtener el ID de BMS desde la consola de BMSBMS o invocando al Consulta de los BMS (API nativa de OpenStack).

Parámetros de solicitud

Parámetro

Obligatorio

Tipo

Descripción

nics

Sí

Array of objects

Especifica las NIC que se van a vincular. Para obtener más información, consulte Tabla 2.

Restricciones:

Actualmente, puede vincular simultáneamente un máximo de 10 NIC a un BMS. Si más de 10 NIC están vinculadas simultáneamente, el enlace puede fallar.
Tabla 2 Descripción de la estructura de datos de campo nics

Parámetro

Obligatorio

Tipo

Descripción

subnet_id

Sí

String

Especifica el ID de subred de la NIC.

Puede obtener el ID de subred (en formato UUID) desde la consola o haciendo referencia a Consultar subredes en la Referencia de las API de Virtual Private Cloud.

Restricciones:

security_groups

No

Array of objects

Especifica los grupos de seguridad para la NIC. Para obtener más información, consulte Tabla 3.

Restricciones:

Este parámetro solo es válido cuando se especifica subnet_id. Es obligatorio cuando se utiliza subnet_id para vincular las NIC entre los tenants.

ip_address

No

String

Especifica la dirección IP de la NIC. Si este parámetro se deja en blanco, la dirección IP se asigna automáticamente.

Restricciones:

Este parámetro solo es válido si se especifica subnet_id.
Tabla 3 Descripción de la estructura de datos de campo security_groups

Parámetro

Obligatorio

Tipo

Descripción

id

Sí

String

Especifica el ID del grupo de seguridad.

Ejemplo de solicitud

Vinculación de una NIC (ID de subred: d32019d3-bc6e-4319-9c1d-6722fc136a23; ID del grupo de seguridad: f0ac4394-7e4a-4409-9701-ba8be283dbc3) para un BMS 
{
    "nics": [
        {
            "subnet_id": "d32019d3-bc6e-4319-9c1d-6722fc136a23",
            "security_groups": [
                {
                    "id": "f0ac4394-7e4a-4409-9701-ba8be283dbc3"
                }
            ]
        }
    ]
}

Parámetros de respuesta

Tabla 4 Respuesta normal

Parámetro

Tipo

Descripción

job_id

String

Especifica el ID de tarea devuelto después de ejecutar un comando de tarea. El ID de tarea se puede utilizar para consultar el estado de ejecución de la tarea.

Para obtener más información acerca de cómo consultar el estado de ejecución de la tarea basado en job_id, consulte Consulta de estados de tareas.
Tabla 5 Respuesta anormal

Parámetro

Tipo

Descripción

error

Dictionary data structure

Especifica el error devuelto cuando un envío de tareas encuentra una excepción. Para más detalles, consulte Tabla 6.
Tabla 6 Estructura de datos de error

Parámetro

Tipo

Descripción

message

String

Especifica el mensaje de error.

code

String

Especifica el código de error.

Ejemplo de respuesta

  • Respuesta normal 
    1
2
3
    		 
    { 
    "job_id": "70a599e0-31e7-49b7-b260-868f441e862b" 
}

Valores devueltos

Valores normales

Valores devueltos

Descripción

200

La solicitud se ha procesado correctamente.

Para obtener más información sobre otros valores devueltos, consulte Códigos de estado.

Códigos de error

Véase Códigos de error.

Tema principal: Gestión de NIC de BMS