NVIDIA UFM Enterprise REST API Guide v6.11.0

Virtualization REST API

  • Description – get all virtual ports in the fabric

  • Request URL – GET /ufmRest/resources/vports

  • Request Content Type – Application/json

  • Request Data

    Copy
    Copied!
                

    [ { "virtual_port_state": "Active", "virtual_port_lid": 3434, "system_ip": "11.4.3.175", "system_name": "r-ufm77", "node_description": "r-ufm77 mlx5_0", "system_guid": "248a0703008a850a", "port_guid": "248a0703008a850a", "port_name": "248a0703008a850a_1", "physical_port_number": 1, "virtual_port_guid": "0002c90000000017" }, { "virtual_port_state": "Active", "virtual_port_lid": 3435, "system_ip": "11.4.3.175", "system_name": "r-ufm77", "node_description": "r-ufm77 mlx5_0", "system_guid": "248a0703008a850a", "port_guid": "248a0703008a850a", "port_name": "248a0703008a850a_1", "physical_port_number": 1, "virtual_port_guid": "0002c90000000018" }, { "virtual_port_state": "Active", "virtual_port_lid": 3435, "system_ip": "11.4.3.175", "system_name": "r-ufm77", "node_description": "r-ufm77 mlx5_1", "system_guid": "248a0703008a850a", "port_guid": "248a0703008a850b", "port_name": "248a0703008a850b_2", "physical_port_number": 2, "virtual_port_guid": "0002c90000000019" }, { "virtual_port_state": "Active", "virtual_port_lid": 3436, "system_ip": "0.0.0.0", "system_name": "r-ufm51", "node_description": "r-ufm51 HCA-1", "system_guid": "f452140300383a00", "port_guid": "f452140300383a01", "port_name": "f452140300383a01_1", "physical_port_number": 1, "virtual_port_guid": "0002c9000000001c" }, { "virtual_port_state": "Active", "virtual_port_lid": 3437, "system_ip": "0.0.0.0", "system_name": "r-ufm51", "node_description": "r-ufm51 HCA-1", "system_guid": "f452140300383a00", "port_guid": "f452140300383a02", "port_name": "f452140300383a02_2", "physical_port_number": 2, "virtual_port_guid": "0002c9000000001f" } ]

  • Status codes

    • 200 – OK

    • 400 – BAD_REQUEST

  • Description – get the list of all virtual ports for a specific system

  • Request URL – GET /ufmRest/resources/vports?system=<system_guid>

  • Request Content Type – Application/json

  • Request Data

    Copy
    Copied!
                

    [ { "virtual_port_state": "Active", "virtual_port_lid": 3434, "system_ip": "11.4.3.175", "system_name": "r-ufm77", "node_description": "r-ufm77 mlx5_0", "system_guid": "248a0703008a850a", "port_guid": "248a0703008a850a", "port_name": "248a0703008a850a_1", "physical_port_number": 1, "virtual_port_guid": "0002c90000000017" }, { "virtual_port_state": "Active", "virtual_port_lid": 3435, "system_ip": "11.4.3.175", "system_name": "r-ufm77", "node_description": "r-ufm77 mlx5_0", "system_guid": "248a0703008a850a", "port_guid": "248a0703008a850a", "port_name": "248a0703008a850a_1", "physical_port_number": 1, "virtual_port_guid": "0002c90000000018" }, { "virtual_port_state": "Active", "virtual_port_lid": 3435, "system_ip": "11.4.3.175", "system_name": "r-ufm77", "node_description": "r-ufm77 mlx5_1", "system_guid": "248a0703008a850a", "port_guid": "248a0703008a850b", "port_name": "248a0703008a850b_2", "physical_port_number": 2, "virtual_port_guid": "0002c90000000019" } ]

  • Status codes

    • 200 – OK

    • 400 – BAD_REQUEST

    • 404 – NOT_FOUND

  • Description – get the list of virtual ports for specific physical port

  • Request URL – GET /ufmRest/resources/vports?port=<port_guid>

  • Request Content Type – Application/json

  • Request Data

    Copy
    Copied!
                

    [ { "virtual_port_state": "Active", "virtual_port_lid": 3434, "system_ip": "11.4.3.175", "system_name": "r-ufm77", "node_description": "r-ufm77 mlx5_0", "system_guid": "248a0703008a850a", "port_guid": "248a0703008a850a", "port_name": "248a0703008a850a_1", "physical_port_number": 1, "virtual_port_guid": "0002c90000000017" }, { "virtual_port_state": "Active", "virtual_port_lid": 3435, "system_ip": "11.4.3.175", "system_name": "r-ufm77", "node_description": "r-ufm77 mlx5_0", "system_guid": "248a0703008a850a", "port_guid": "248a0703008a850a", "port_name": "248a0703008a850a_1", "physical_port_number": 1, "virtual_port_guid": "0002c90000000018" }, { "virtual_port_state": "Active", "virtual_port_lid": 3435, "system_ip": "11.4.3.175", "system_name": "r-ufm77", "node_description": "r-ufm77 mlx5_1", "system_guid": "248a0703008a850a", "port_guid": "248a0703008a850b", "port_name": "248a0703008a850b_2", "physical_port_number": 2, "virtual_port_guid": "0002c90000000019" } ]

  • Status codes

    • 200 – OK

    • 400 – BAD_REQUEST

    • 404 – NOT_FOUND

© Copyright 2023, NVIDIA. Last updated on Sep 5, 2023.