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 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 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
No hay
Ejemplo de solicitud
1
|
GET https://{ECS Endpoint}/v2.1/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd/os-interface |
Parámetros de respuesta
Parámetro |
Tipo |
Descripción |
---|---|---|
interfaceAttachments |
Array of objects |
Especifica información acerca de las NIC del BMS. Para obtener más información, véase Tabla 2. |
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, consulte 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 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.