Consulta de información acerca de las NIC de BMS (API nativa de OpenStack)
Función
Esta API se utiliza para consultar información sobre las NIC de BMS, como las direcciones de MAC y las direcciones IP privadas.
URI
GET /v2.1/{project_id}/servers/{server_id}/os-interface
Tabla 1 enumera los parámetros.
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 del BMS. Puede obtener el ID de BMS desde la consola de BMS o usando la API de Consulta del BMS (API nativa de OpenStack). |
Solicitud
Respuesta
- Parámetros de respuesta
Parámetro
Tipo
Descripción
interfaceAttachments
Array of objects
Especifica información sobre las NIC del BMS. Para obtener más información, véase Tabla 2.
Tabla 2 Descripción de la estructura de datos de campo interfaceAttachments Parámetro
Tipo
Descripción
port_state
String
Especifica el estado del puerto de NIC. El valor puede ser ACTIVE, BUILD o DOWN.
fixed_ips
Array of objects
Especifica la dirección IP privada de NIC. Para obtener más información, véase Tabla 3.
net_id
String
Especifica el ID de la subred (network_id) a la que pertenecen los puertos de la NIC.
port_id
String
Especifica el ID del puerto de la NIC.
mac_addr
String
Especifica la dirección de MAC de la NIC.
- Ejemplo de la respuesta
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
{ "interfaceAttachments": [ { "port_state": "ACTIVE", "fixed_ips": [ { "subnet_id": "f8a6e8f8-c2ec-497c-9f23-da9616de54ef", "ip_address": "192.168.1.3" } ], "net_id": "3cb9bc59-5699-4588-a4b1-b87f96708bc6", "port_id": "ce531f90-199f-48c0-816c-13e38010b442", "mac_addr": "fa:16:3e:4c:2c:30" } ] }
Valores devueltos
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.